The length of the COORDS array. Supply zero if COORDS should be
COORDS( NCOORDS ) = INTEGER (Given)
An array holding NCOORDS AstKeyMap pointers (if NCOORDS
is zero, the supplied value is ignored). Each supplied KeyMap
describes the contents of a single STC AstroCoords element, and
should have elements with keys given by constants AST__STCNAME,
AST__STCVALUE, AST__STCERROR, AST__STCRES, AST__STCSIZE,
AST__STCPIXSZ. Any of these elements may be omitted, but no other
elements should be included. If supplied, the AST__STCNAME element
should be a vector of character string pointers holding the "Name"
item for each axis in the coordinate system represented by
Any other supplied elements should be scalar elements, each holding
a pointer to a Region describing the associated item of ancillary
information (error, resolution, size, pixel size or value). These
Regions should describe a volume within the coordinate system
represented by REGION.
OPTIONS = CHARACTER ( ) (Given)
A character string containing an optional comma-separated
list of attribute assignments to be used for initialising the
new StcObsDataLocation. The syntax used is identical to that for the
STATUS = INTEGER (Given and Returned)
The global status.
AST_STCOBSDATALOCATION = INTEGER
A pointer to the new StcObsDataLocation.
A deep copy is taken of the supplied Region. This means that
any subsequent changes made to the encapsulated Region using the
supplied pointer will have no effect on the Stc.
A null Object pointer (AST__NULL) will be returned if this
function is invoked with STATUS set to an error value, or if it
should fail for any reason.