make_parm_file

make_parm_file takes several plain-text user-created files and creates a formatted parameter file for use in reduce. The file can be edited with station_info. make_parm_file is a more convenient way to create a parameter file from scratch, when the station positions and names are known.

Usage

make_parm_file NAME_FILE POSITION_FILE [SKIP_FILE] OUTPUT_FILE

where NAME_FILE is the name of the file which has station id to name information, POSITION_FILE has the station position and elevation change (optional) data, and SKIP_FILE has a list of station ids to be skipped in the reduction. File formats are specified below.

SKIP_FILE is optional; if none is specified, no stations will be marked for removal.

File Formats

• NAME_FILE - This file should be a list of station ids and names, 1 pair per line, separated by whitespace. Blank lines are ignored, but there is no provision for comment lines. While technically allowed, it is dangerous for station names to have spaces; other code has not been rigorously checked to handle names with embedded whitespace. Station ids may never have spaces. It is also recommended that all station ids be numbers, although everything should work if they are not.

  Example file:
  

  1.      IRRI 
  2.      POWER
  3.      IRRI 
  4.      DV25 
  5.      S001 
  6.      GWWT 
  7.      V102 
  8.      FUMA 
  9.      DV02 
  10.     IRRI 
  11.     DV25 
  12.     S001 
  

• POSITION_FILE - Format is blank-delimited columns; first is the station name, not id; next is latitude, in decimal degrees (N is positive); longitude, in decimal degrees (E is positive); elevation, in meters; elevation change, in cm.

  Example file:
  

   V102   39.944814108 -117.917346300   1026.023 0.0
   T103   39.953393547 -117.884947336   1034.711
  

  Note that the second entry does not have a field for elevation change - if not present, it is assumed to be 0.0.

• SKIP_FILE - Format is a list of station ids or names, one per line. Blank lines are ignored, there are no comment lines. If a station id is given, only that station is marked to be skipped. If a name is given, every station id with that name is marked to be skipped.

  Example file:
  

  POWER
  42.
  197.
  EGI
  

Description

make_parm_file is meant to speed the rather tedious process of creating the parameter file for use in reduce. The program uses the station id to name mapping in NAME_FILE to match with the information in the position and skip files, and to compute repeat information. All stations with the same name are assumed to be repeated occupations of the same station. If this is not true, edit the resulting file by hand or change the station names.

The position and skip information is used to create the respective parts of the parameter file. The position information is stored by name, and all stations with the same name are given the same position and elevation change. Again, if this is not desired, edit the resulting parameter file by hand (using station_info or a text editor) or change the names.

The skip information can be in two forms, which can be mixed freely in the skip file - a station id, or a station name. Station ids are copied to the parameter file verbatim, which normally results in a single station being marked for removal from the reduction. Any entry that matches a station name, rather than an id, is expanded to be a list of all station ids with that name. Note that the algorithm actually does a comparison to the names, and if no match is found, the entry is passed on verbatim - there is no checking that the entries in the skip file are valid ids.

Copyright © 2000, Paul Gettings