STATION DATABASE FILES @(#) sta_info 1.2 01/04/95 The sta_info database consists of three files that are kept in /goa/sta_info under SCCS control. The files are in formatted ASCII records, so that they may be easily viewed and modified by a person using an editor. Each file is stored in inverse chronological order and read from the top down. This means that the most up to date information is encountered first when reading the files and that new information should be added to the tops of the files. sta_id This file is the interface between the station identifiers in the database and the outside world. In this file, a given station name is associated with a station identifier and a station number. A given station identifier and station number can be associated with more than one station name. This is allowed so that multiple names for the same station can be handled. The station number is currently not used, but may be implemented in the future when all stations receive official GPS numbers. The following are examples of a few records: PENT 801 The following aliases for PENT were inserted on 9-May-1992 by fhw PENT 801 PENTICTON PENT 801 Penticton PENT 801 Penticton 1977 PENT 801 PGCQ PENT 801 A station somewhere in Canada GOLD 1437 DSS10 GOLD 1437 SPC10 GOLD 1437 Goldstone Rogue Antenna SDAD 202 USC&GS HORIZNOTAL CONTROL MARK SOLEDAD PEAK 1932 RM1 JPLM 7272 JPLMESA where PENT, GOLD, and SDAD are all station identifiers, 801, 1437, and 202 are the station numbers and the character strings are station names. These station names are the known aliases for this particular station and are case sensitive. The record format is: (1x,a4,i6,1x,a60) sta_pos This file associates the station identifier with the station coordinates at some epoch and the station velocity. An example of a record is: JPLM 1992 07 01 00:00:00.00 1000001.00 -2493304.0630 -4655215.5490 3565497.3390 -3.20000000e-02 1.90000000e-02 6.00000000e-03 Mon Nov 9 15:07:31 PST 1992 itrf91 1992.5 (The record is stored on one line.) The fields are: The station identifier; the epoch of the station coordinates (year, month, day, hours, minutes and seconds); the duration of the station coordinates (days); the station coordinates at the epoch (meters); the station velocities (meters/year); and a comment. The comment field could contain the reference system of the coordinates. The record format is: (1x,a4,1x,i4,4(1x,i2)1x,f5.2,1x,f10.2,1x,3f15.4,1x,3e15.8,1x,a30) sta_svec This file associates the station identifier with the site vector and antenna type at some epoch. An example of a record is: JPLM JPLM 1992 06 00 00:00:00.00 31536000.00 ROGUE 0.0000 0.0000 0.0000 0.1630 l 1992 07 06 (The record is stored on one line.) The fields are: the "to" station identifier; the "from" station identifier, the epoch of the site vector (year, month, day, hours, minutes and seconds); the duration (seconds), that the site vector is valid from the epoch; the antenna type, corresponding to one of the antenna types in the pcenter file; the station site vector; the antenna height; the site vector coordinate system flag, where c indicates Cartesian coordinates (XYZ) and l indicates local east-north-up coordinates (ENU); the date that the site vector was issued; and a comment. The record format is: (1x,a4,1x,a4,1x,i4,4(1x,i2)1x,f5.2,1x,f12.2,1x,a9,1x,4f11.4,1x,a1,1x,i4,1x,i2,1x,i2) (In this particular example, the "to" and "from" station identifiers are the same. This indicates that the site vector and antenna height in this record are for the offset between the JPLM antenna and the JPLM monument.) As with making a cinfile, a file of phase center offsets, pcenter, is necessary. An example of the contents of the pcenter file and the format is: ROGUE L1 0.0000 0.0000 0.0079 J.M. Tranquilla, UNB, ROGUE L2 0.0000 0.0000 0.0264 Dorne-Margolin C146-6-1 ROGUE LC 0.0000 0.0000 -0.0207 from TOP of choke ring This is the same format as is read by MASTERCIN. The first field is the antenna type, the second is the phase center type, and the last three are the east, north, and up phase center offsets in meters. The record format is: (a9,1x,a2,3f9.4) ACCESSING THE sta_info FILES: You can either access these files using vi, grep, sed, etc (and, if modifying a file, you must also use sccs) or from your programs using the subroutines in /335libs/sta_info which contains a library of FORTRAN subroutines to access the sta_info files. These functions are used by hvor to create qregres namelists.