ARD_GTWCS - Return a FrameSet connecting pixel and user co-ordinates

Description:

This routine returns an AST pointer for a FrameSet describing the relationship between the user co-ordinate system used by the supplied ARD description, and the pixel coordinate Frame of the FrameSet stored by the most recent call to ARD_WCS.

Invocation:

CALL ARD_GTWCS( IGRP, NDIM, IWCS, STATUS )

Arguments:

IGRP = INTEGER (Given)

A GRP identifier for the group holding the ARD description.

NDIM = INTEGER (Given)

The number of pixl axes in the mask array.

IWCS = INTEGER (Returned)

An AST pointer to the FrameSet. The base Frame will be the pixel coordinate Frame in the FrameSet supplied via the most recent call to ARD_WCS. The current Frame will be the user co-ordinate system specified by the supplied ARD description.

Notes:

• An error is reported if the dimensionality of the ARD description is different to that of the mask array (as specified by argument NDIM).