next up previous 264
Next: AST_SHIFTMAP - Create a ShiftMap
Up: AST Routine Descriptions
Previous: AST_SETREFPOS - Set the reference position in a specified celestial coordinate system


AST_SETUNC - Store uncertainty information in a Region

Description:
Each Region (of any class) can have an "uncertainty" which specifies the uncertainties associated with the boundary of the Region. This information is supplied in the form of a second Region. The uncertainty in any point on the boundary of a Region is found by shifting the associated "uncertainty" Region so that it is centred at the boundary point being considered. The area covered by the shifted uncertainty Region then represents the uncertainty in the boundary position. The uncertainty is assumed to be the same for all points.

The uncertainty is usually specified when the Region is created, but this routine allows it to be changed at any time.

Invocation:
CALL AST_SETUNC( THIS, UNC, STATUS )
Arguments:
THIS = INTEGER (Given)
Pointer to the Region which is to be assigned a new uncertainty.
UNC = INTEGER (Given)
Pointer to the new uncertainty Region. This must be of a class for which all instances are centro-symetric (e.g. Box, Circle, Ellipse, etc.) or be a Prism containing centro-symetric component Regions. A deep copy of the supplied Region will be taken, so subsequent changes to the uncertainty Region using the supplied pointer will have no effect on the Region THIS.
STATUS = INTEGER (Given and Returned)
The global status.


next up previous 264
Next: AST_SHIFTMAP - Create a ShiftMap
Up: AST Routine Descriptions
Previous: AST_SETREFPOS - Set the reference position in a specified celestial coordinate system

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