next up previous
Next: NDF_HAPPN - Declare a new application name for NDF history recording
Up: FORTRAN ROUTINE DESCRIPTIONS
Previous: NDF_GTUNE - Obtain the value of an NDF_ system tuning parameter

   
NDF_GTWCS - Obtain world coordinate system information from an NDF

Description:
The routine obtains information about the world coordinate systems associated with an NDF and returns an AST pointer to a FrameSet which contains this information. The information may then be accessed using routines from the AST library (SUN/210).

Invocation:
CALL NDF_GTWCS( INDF, IWCS, STATUS )

Arguments:
INDF = INTEGER (Given)
NDF identifier.
IWCS = INTEGER (Returned)
An AST pointer to a FrameSet which contains information about the world coordinate systems associated with the NDF.
STATUS = INTEGER (Given and Returned)
The global status.

Notes:
  • It is the caller's responsibility to annul the AST pointer issued by this routine (e.g. by calling AST_ANNUL) when it is no longer required. The NDF_ system will not perform this task itself.
  • If this routine is called with STATUS set, then a value of AST__NULL will be returned for the IWCS argument, although no further processing will occur. The same value will also be returned if the routine should fail for any reason. The AST__NULL constant is defined in the include file AST_PAR.



next up previous
Next: NDF_HAPPN - Declare a new application name for NDF history recording
Up: FORTRAN ROUTINE DESCRIPTIONS
Previous: NDF_GTUNE - Obtain the value of an NDF_ system tuning parameter


Starlink User Note 33
R.F. Warren-Smith
11th January 2000
E-mail:rfws@star.rl.ac.uk

Copyright © 2000 Council for the Central Laboratory of the Research Councils