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: 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