RASTR

Name

rastr

Purpose (one Line)

Convert RA in radians to hours, minutes, and seconds (ASCII string).

Description

Calling Sequence

rastr, radians, places, str, carry

Inputs

ra - Right Ascension, in radians, to be converted to a string.
May a vector, in which case the outputs will be vectors.
places - output format and precision (see cvtsixty).

Optional Input Parameters

Keyword Input Parameters

DEGREES - Flag, if set it means the input is in decimal degrees.
SEPCHAR - Separator character for the fields in the position.
Default=':'. Warning, if you do not use ':' then the
string may not be parsable by raparse.

Outputs

str - Output string for the converted right ascension.
carry - Flag that indicates ra rolled over after rounding.

Keyword Output Parameters

ERROR - Flag (scalar or vector), set if an error was seen.

Common Blocks

Side Effects

Restrictions

Procedure

Right ascension is reduced to the range [0,24) then converted to a string.
There are no imbedded blanks.

Modification History

1993/07/15, Doug loucks, Lowell Observatory, July, 1993, ported from the
C-Language version written by Marc Buie.
1997/07/14, MWB, added places=4
1999/01/12, MWB, added places = -8
2001/11/04, MWB, fixed bug in places=-7 case
2003/05/09, MWB, added SEPCHAR keyword
2009/04/26, MWB, converted to use new CVTSIXTY routine