IRA_DTOC1

Convert a single floating=point sky co-ordinate value to character form

Description:

This routine creates a text string containing a formatted version of the given sky co-ordinate value. The value is assumed to be a longitude value if NC is 1, and a latitude if NC is 2. The formats of the output string are as described in routine IRA_DTOC. Longitude values are shifted into the range 0 - 2∗PI before being used. Latitude values are shifted into the range +/- PI before being used. An error is reported if a latitude value then has an absolute value greater than PI/2 (this differs from the behaviour of IRA_NORM which always reduces the latitude value to +/- PI/2).

Invocation

CALL IRA_DTOC1( VALUE, SCS, NC, STYLE, TEXT, STATUS )

Arguments

VALUE = DOUBLE PRECISION (Given)
The value of the sky co-ordinate to be formatted, in radians. If VALUE has the Starlink " BAD" value (VAL__BADD) then the output string TEXT is set blank.
SCS = CHARACTER ∗ ( ∗ ) (Given)
The sky co-ordinate system in use (see ID2 section " Sky Coordinates" ). Any unambiguous abbreviation will do.
NC = INTEGER (Given)
Determines which sky co-ordinate is given. If a value of 1 is supplied, VALUE is interpreted as a longitude value (e.g. RA if an equatorial system is being used). If a value of 2 is supplied, VALUE is interpreted as a latitude value. Any other value causes an error to be reported.
STYLE = INTEGER (Given)
A value in the range 1 to 5 which specifies the style of output formatting required. In addition a value of zero can be specified which causes a default style to be used dependant on the value of SCS. See routine IRA_DTOC for a description of the styles and defaults.
TEXT = CHARACTER ∗ ( ∗ ) (Returned)
The string containing the formatted description of the sky co-ordinate value. The variable supplied for TEXT should have a declared length equal to the value of parameter IRA__SZFSC.
STATUS = INTEGER (Given and Returned)
The global status.