Create a StcObsDataLocation astStcObsDataLocation
The StcObsDataLocation class is a sub-class of Stc used to describe the coverage of the datasets contained in some VO resource.
See http://hea-www.harvard.edu/arots/nvometa/STC.html
"
coords"
array. Supply zero if "
coords"
is NULL. "
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 "
region"
.
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"
. "
printf"
format specifiers identified by "
%"
symbols in the normal way. "
options"
string contains "
%"
format specifiers, then an optional list of
additional arguments may follow it in order to supply values to be substituted for
these specifiers. The rules for supplying these are identical to those for
the astSet function (and for the C "
printf"
function). 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 the AST error status set, or if it should fail for any reason.