KPG1_SCALE

Determines nominal WCS axis scales in an array

Description:

This routine determines (and formats) the nominal scales of the WCS axes in the current Frame of the supplied FrameSet. The scales are determined at a selection of points within the supplied base Frame bounds, and the median scales are returned. At each point, the scale for a specific WCS axis is the WCS axis increment produced by moving a unit distance within the base Frame away from the point, along the WCS axis.

Invocation

CALL KPG1_SCALE( IWCS, LBND, UBND, SCALE, VALUE, UNIT, STATUS )

Arguments

IWCS = INTEGER (Given)
The FrameSet.
LBND( ∗ ) = DOUBLE PRECISION (Given)
The lower bounds of the region within the base Frame of the supplied FrameSet in which the WCS scales are to be evaluated. The array should have one element for each base Frame axis.
UBND( ∗ ) = DOUBLE PRECISION (Given)
The upper bounds of the region within the base Frame of the supplied FrameSet in which the WCS scales are to be evaluated. The array should have one element for each base Frame axis.
SCALE( ∗ ) = DOUBLE PRECISION (Returned)
The returned WCS scales. Note, the scales for both celestial longitude and latitude axes are returned as an arc-distance in radians. The array should have one element for each WCS axis.
VALUE( ∗ ) = CHARACTER( ∗ ) (Returned)
The formatted WCS scales. Celestial axes are formatted as arc-seconds using a " G15.6" format. Time values are also formatted using G15.6 (the Format attribute in the current WCS Frame is ignored, since it may produce a calendar date), in what ever units are indicated in the current Frame. Other types of axes (including spectral axes) are formatted using the axis Format attribute in the current WCS Frame. The array should have one element for each WCS axis. Each element of the array should be at least 15 characters long. The returned text is left justified.
UNIT( ∗ ) = CHARACTER( ∗ ) (Returned)
Units strings that describe the values returned in VALUES. The array should have one element for each WCS axis.
STATUS = INTEGER (Given and Returned)
The global status.