Next: AST_CLEAR - Clear attribute values for an Object
Up: AST Routine Descriptions
Previous: AST_CIRCLE - Create a Circle
AST_CIRCLEPARS
-
Returns the geometric parameters of an Circle
- Description:
- This routine
returns the geometric parameters describing the supplied Circle.
- Invocation:
- CALL AST_CIRCLEPARS( THIS, CENTRE, RADIUS, P1, STATUS )
- Arguments:
-
THIS = INTEGER (Given)
-
Pointer to the Region.
-
CENTRE(
) = DOUBLE PRECISION (Returned)
-
An array
in which to return the coordinates of the Circle centre.
The length of this array should be no less than the number of
axes in the associated coordinate system.
-
RADIUS = DOUBLE PRECISION (Returned)
-
Returned holding the radius of the Circle, as an geodesic
distance in the associated coordinate system.
-
P1(
) = DOUBLE PRECISION (Returned)
-
An array
in which to return the coordinates of a point on the
circumference of the Circle. The length of this array should be
no less than the number of axes in the associated coordinate system.
-
STATUS = INTEGER (Given and Returned)
-
The global status.
- Notes:
- If the coordinate system represented by the Circle has been
changed since it was first created, the returned parameters refer
to the new (changed) coordinate system, rather than the original
coordinate system. Note however that if the transformation from
original to new coordinate system is non-linear, the shape
represented by the supplied Circle object may not be an accurate
circle.
Next: AST_CLEAR - Clear attribute values for an Object
Up: AST Routine Descriptions
Previous: AST_CIRCLE - Create a Circle
AST A Library for Handling World Coordinate Systems in Astronomy
Starlink User Note 210
R.F. Warren-Smith & D.S. Berry
24th May 2011
E-mail:ussc@star.rl.ac.uk
Copyright (C) 2009 Science \& Technology Facilities Council