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.