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 2012/07/15, MWB, modifed to split off the writing portion into wrstarc