next up previous 264
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 up previous 264
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