AST_REMAPFRAME

Modify a Frame s relationship to other Frames in a FrameSet

Description:

This routine modifies the relationship (i.e. Mapping) between a specified Frame in a FrameSet and the other Frames in that FrameSet.

Typically, this might be required if the FrameSet has been used to calibrate (say) an image, and that image is re-binned. The Frame describing the image will then have undergone a coordinate transformation, and this should be communicated to the associated FrameSet using this routine.

Invocation

CALL AST_REMAPFRAME( THIS, IFRAME, MAP, STATUS )

Arguments

THIS = INTEGER (Given)
Pointer to the FrameSet.
IFRAME = INTEGER (Given)
The index within the FrameSet of the Frame to be modified. This value should lie in the range from 1 to the number of Frames in the FrameSet (as given by its Nframe attribute).
MAP = INTEGER (Given)
Pointer to a Mapping whose forward transformation converts coordinate values from the original coordinate system described by the Frame to the new one, and whose inverse transformation converts in the opposite direction.
STATUS = INTEGER (Given and Returned)
The global status.

Notes: