Description:
This function adds one or more new axes to all the Frames in an NDF WCS FrameSet.
Frames that are known to be NDF-special (e.g. GRID, AXIS, PIXEL and FRACTION) are
expanded to include a number of extra appropriate axes equal to the Nin attribute of the
supplied Mapping. all other Frames in the FrameSet are replaced by CmpFrames holding the
original Frame and the supplied Frame. These new axes are connected to the new GRID
axes using the supplied Mapping.
Invocation
void atlAddWcsAxis( AstFrameSet
wcs, AstMapping
map, AstFrame
frm, int
lbnd, int
ubnd, int
status
)
Arguments
wcs
A pointer to a FrameSet that is to be used as the WCS FrameSet in an NDF. This
imposes the restriction that the base Frame must have Domain GRID.
map
A pointer to a
Mapping. The forward transformation should transform the new GRID axes into the new
WCS axes.
frm
A pointer to a Frame defining the new WCS axes.
lbnd
An array
holding the lower pixel index bounds on the new axes. If a NULL pointer is supplied, a
value of 1 is assumed for all the new axes.
ubnd
An array holding the upper pixel index
bounds on the new axes. If a NULL pointer is supplied, any FRACTION Frame in the
supplied FrameSet is removed.
status
Pointer to the global status variable.
Notes:
-
The new axes are appended to the end of the existing axes, so the axis indices associated with the new axes will
extend from " nold1"
to " noldnnew" ,
where " nold" is the number of axes in the original Frame, and " nnew" is the number of new
axes.
-
An error will be reported if the Nout attribute of " map" is different to the Naxes attribute of " frm" .