NAME:
starcprmt
PURPOSE:
Promote version of a star catalog file to highest version.
DESCRIPTION:
Reads the star catalog file, which may be ascii (version 0, output of
refnet) or binary (v1.0) The discriminant is to read the first 10 byte
string and look for version. If it is ascii it is rewritten in place
as a v1.0 binary. The binary file is big endian.
CATEGORY:
File I/O
CALLING SEQUENCE:
starcprmt,starcfn
INPUTS:
starcfn - File with star catalog data.
OPTIONAL INPUT PARAMETERS:
KEYWORD INPUT PARAMETERS:
SILENT - Flag, if set suppresses all non-error output.
OUTPUTS:
KEYWORD OUTPUT PARAMETERS:
COMMON BLOCKS:
SIDE EFFECTS:
Rewrites cat file in place to binary version if ascii (as created by refnet).
RESTRICTIONS:
Requires a version of READCOL that supports keywords NGOOD and NLINES.
PROCEDURE:
The catalogue file is updated to the most recent version.
Not changed if already current, or not present.
The following formats are supported:
v0.0 The base ascii format with no version line
This is the version generated by refnet.
v1.0 Version line at the start: STARC v1.0
Binary format in big endian order.
The version line is a 10 byte string.
Next is a longword giving number of stars, >= 0.
This is followed by two double vectors for ra and dec, then float
vectors for bmag and rmag.
MODIFICATION HISTORY:
2007/11/21, Written by Peter L. Collins, Lowell Observatory
2007/11/30, PLC, modified for validity checking and new READCOL keywds.
2008/10/21, MWB, added SILENT keyword