TOC  |      |      |              |              | INDEX

xsites

Creates, modifies, displays station information files.

OVERVIEW

The interactive window has three parts: a menu bar, a file name panel, and the list containing the ASCII representation of the binary information. Pulldown menus are the primary means of program control and include:

• File - input/output file selection, printing, and exit,
• Display- site and record display criteria,
• New - popup menus for creating new records,
• Help - help information.

This program was written in ANSI standard C. The graphical user interface (GUI) uses the X version 5.0 and Motif 1.2 libraries. All source code except the X and Motif libraries is available from the author.

COMMAND LINE OPTIONS

  xsites {-a name} {-f #} {-p} {-r name} {-s name} {file}
where

{-a name} : antenna information file (DEFAULT is search)
{-f #}    : output format where # = 0 = standard (DEFAULT)
                                    1 = epoch
                                    2 = POM
{-p}      : non-interactive print mode (DEFAULT is interactive mode)
{-r name} : receiver information file (DEFAULT is search)
{-s name} : site (DEFAULT is the first site file)
{file}    : binary site information file

Some common examples of xsites use are:

  xsites oldfile

  xsites -s algo -s mas1 oldfile

  xsites -f2 -p -s mas1 oldfile > mas1.pom

X RESOURCES

PULLDOWN MENUS

• Open

creates a popup window to select a file for viewing or modification. The window shows the location in the directory tree and the files in the current directory. The current directory can be changed by double-clicking the desired directory. A file can be opened by highlighting (single click) a file name an pressing the "OK" button at the bottom of the window or double-clicking on that file. In addition, a field for typing the desired file name is located just above the buttons at the bottom of the window. To activate this window, click on that field. The "Filter" button rescans the current directory and refreshes the window. "Cancel" exist the window with no changes.
• Save

saves the current information to the currently open file. If the file already exists, a confirmation is requested before the file is overwritten.
• Save As

creates a popup window to select a file for storing the current information. This window and its control are similar to the "Open" command under the, "File" menu. If the file already exists, a confirmation is requested before the file is overwritten.
• Merge

creates a popup window to select a file whose contents will be merged with the information currently in the program. The window and its control are similar to the Open command under the "File" menu.
• pom

creates a popup window to select an OMNI style position/offset/MET file whose contents will be converted and added to the current site information.
• ant_info

creates a popup window permitting the user to select an antenna information file.
• rcvr_info

creates a popup window permitting the user to select a receiver information file.
• Sort

sorts the infomation in the current file by site, record type, valid date and modification date respectively.
• Print

print the currently displayed information as ASCII text. Print has two options: print to a file or directly to the printer. If the print to file option is chosen, a popup file selection window is created. If the requested file already exists, a confirmation is requested before the file is overwritten.
• Exit

terminates the program. If modifications were made to the current information, an option to save the file before exiting is given.

Display

• Site

creates a popup window showing all sites contained in the current file. Sites can be selected or unselected by clicking upon their names. One or several sites can be selected at any one time. The display list is updated upon pressing the "OK" button at the bottom of the window. "Cancel" closes the Site window with no change. A shortcut for selecting a single site is to double-click upon the desire site name.
• Type

create a popup window to choose which of the four types of site info and which pieces of that info to display. The four types are: coordinate and velocity, monument to antenna offset, receiver, and antenna. Each type is further broken down into these pieces for output: banner which identifies the type, site, dates, etc., name specific to the coordinate record, gives alternate site names, comment a descriptive comment line, and values the data associated with this record type. Pressing the "OK", button closes this window and updates the display list. "Cancel" closes the Type window with no change.
• Val Date

opens a window for specifying the bounding dates for the validity dates (the date from which a piece of info is to be used or becomes valid). Two entry fields, beginning and ending, are given. A field must be selected first by clicking upon it before an entry can be made. Several formats for these dates are available and are specified by the associated option menu. "OK" closes the window and updates the list.
• Mod Date

opens a window for specifying the bounding dates for the modification dates (the date when a piece of info was entered or last modified). ). Two entry fields, beginning and ending, are given. A field must be selected first by clicking upon it before an entry can be made. Several formats for these dates are available and are specified by the associated option menu. "OK" closes the window and updates the list.
• Date

creates a pulldown menu for specifying the format for dates in the display list. The left mouse button must be held down while making the selection. Releasing the mouse button with the pointer over a selection removes the menu and updates the display list using the indicated format. Moving the pointer off the menu and releasing the button removes the menu but causes no change to the list.
• Format

opens a window for specifying the display format. Three formats are available:
• standard = all info order by type and date,
• epoch = latest info valid for a user input date,
• POM = latest info displayed in the form of an OMNI style POM file.

Detailed descriptions of these display formats can be found under the the Help/Display menu.

New

• Coordinate

creates a site coordinate/velocity record. The information stored in this record type is the site name, Domes number, tectonic plate, coordinates (in meters), velocity (in meters per year), and their sigma's.
• Offset

creates a record describing the offset from the monument to the antenna mount. NOTE: the Antenna record can be used to describe antenna specific offsets such as mounting brackets or spacers. The information stored in this record type is either a north/east/up or X/Y/Z offset (in meters), and short descriptions of the offset endpoints.
NOTE: this is effectively a defunct record type
• Receiver

creates a record describing the receiver. Information includes receiver type, serial number, and firmware number.
• Antenna

creates a record describing the antenna and its mount. Information includes any offset eccentricity from the monument,  antenna type, and serial number.
• Met

creates a record describing meteorological sensors.  Pressure sensor and its offset from the antenna ARP, relative humidity and temperature sensors are included.
• OLT

creates a record containing ocean-loading vertical deformation model parameters.  If site coordinates have previously been entered, values from the Schwiderski model can be inserted automatically.

• Provides on-line help information.

ON-SCREEN AND PRINTED DISPLAYS

1. Standard format

all information ordered by type and chronology,
2. Epoch format

the last information of each type and the construction of the site coordinates at the user specified epoch,
3. POM format

the last information of each type presented in the format of an OMNI style Position/Offset/Met file. The information displayed must meet the selection criteria which the user has specified. These criteria can be modified using the "Display" pulldown menu from the menu bar.

The three display formats are described in detail in the following screens. An examples can be accessed through the labels.

STANDARD DISPLAY FORMAT
The information for a site is grouped by purpose, e.g. the information describing a monument, the position, velocity, DOMES number, etc., are grouped together. Each "group" will hereafter be called record for that site. There are five record types each of which is identified by a single character:

  A = antenna type, offset for mounting hardware, and phase center offsets;
  C = monument name, coordinates, reference epoch and velocity;
  G = geocentric (XYZ) offset;
  R = receiver type;
  T = topocentric (local north, east, up) offset.

Records for a site are grouped together and are displayed in the order: C, G and T, R, A, M, O.

These records are further ordered by their validity and modification dates.

Detailed descriptions and an example of each record type are given below. Note that some types of information are common in all records.

STANDARD DISPLAY FORMAT FOR COORDINATES/VELOCITIES

C ID--->S      plate= PLAT  frame= FRAME-> PLAT                   VAL---------->  MOD---------->
  DOMES--->; NAME------------------->; ALTERNATE------------------------------>                 
  Comment: "COMMENT---------------------------------------------------->"                       
 X------------> Y------------> Z------------>  Coordinates @ REF---------->                     
 XSIG---------> YSIG---------> ZSIG--------->  Coordinate Sigmas                                
 XVEL---------> YVEL---------> ZVEL--------->  Velocity                                         
 XVELSIG------> YVELSIG------> ZVELSIG------>  Velocity Sigmas

where:

  C         = coordinate record type identifier
  ID        = six character site ID (typically only four characters are used)
  S         = site sequence identifier (e.g. the Goldstone, CA site was designated
              gold  a = DOMES number 40405S028 before the Landers earthquake and
              gold  b = DOMES number 40405S031 after)
  PLAT      = four character plate ID
  FRAME     = reference frame of these coordinates
  VAL       = date after which this record becomes valid and should be used
  MOD       = date that this record was last modified
  DOMES     = DOMES number
  NAME      = site name
  ALTERNATE = alternate site name
  COMMENT   = descriptive comment about this record such as source and author
  X         = X monument coordinate [m]
  Y         = Y monument coordinate [m]
  Z         = Z monument coordinate [m]
  REF       = epoch of the XYZ coordinates
  XSIG      = 1 sigma uncertainty of X coordinate [m]
  YSIG      = 1 sigma uncertainty of Y coordinate [m]
  ZSIG      = 1 sigma uncertainty of Z coordinate [m]
  XVEL      = X velocity [m/yr]
  YVEL      = Y velocity [m/yr]
  ZVEL      = Z velocity [m/yr]
  XVELSIG   = 1 sigma uncertainty of X velocity [m/yr]
  YVELSIG   = 1 sigma uncertainty of Y velocity [m/yr]
  ZVELSIG   = 1 sigma uncertainty of Z velocity [m/yr]

STANDARD DISPLAY FORMAT FOR GEOCENTRIC OFFSETS

G ID--->S   N                                                     VAL---------->  MOD---------->
  Comment: "COMMENT---------------------------------------------------->"                       
 XOFFSET------> YOFFSET------> ZOFFSET------> FROM-----------> TO------------->

where:

  G         = geocentric offset (XYZ) record type identifier
  ID        = six character site ID (typically only four characters are used)
  S         = site sequence identifier (e.g. the Goldstone, CA site was designated
              gold  a = DOMES number 40405S028 before the Landers earthquake and
              gold  b = DOMES number 40405S031 after)
  N         = number identifying common offsets if more than one is needed to
              connect the monument to the antenna mount
  VAL       = date after which this record becomes valid and should be used
  MOD       = date that this record was last modified
  COMMENT   = descriptive comment about this record such as source and author
  XOFFSET   = X component of the offset [m]
  YOFFSET   = Y component of the offset [m]
  ZOFFSET   = Z component of the offset [m]
  FROM      = short description of the starting point of the offset
  TO        = short description of the end point of the offset

STANDARD DISPLAY FORMAT FOR TOPOCENTRIC OFFSETS

T ID--->S   N                                                     VAL---------->  MOD---------->
  Comment: "COMMENT---------------------------------------------------->"                       
NOFFSET------->EOFFSET------->UOFFSET-------> FROM-----------> TO------------->

where:

  T         = local topocentric (NEU) offset record type identifier
  ID        = six character site ID (typically only four characters are used)
  S         = site sequence identifier (e.g. the Goldstone, CA site was designated
              gold  a = DOMES number 40405S028 before the Landers earthquake and
              gold  b = DOMES number 40405S031 after)
  N         = number identifying common offsets if more than one is needed to
              connect the monument to the antenna mount
  VAL       = date after which this record becomes valid and should be used
  MOD       = date that this record was last modified
  COMMENT   = descriptive comment about this record such as source and author
  NOFFSET   = north component of the offset [m]
  EOFFSET   = east component of the offset [m]
  UOFFSET   = up component of the offset [m]
  FROM      = short description of the starting point of the offset
  TO        = short description of the end point of the offset

STANDARD DISPLAY FORMAT FOR RECEIVERS

R ID--->S    TYPE-----------> S/N------------> F/W------------>   VAL---------->  MOD---------->
  Comment: "COMMENT---------------------------------------------------->"

where:

  R         = receiver record type identifier
  ID        = six character site ID (typically only four characters are used)
  S         = site sequence identifier (e.g. the Goldstone, CA site was designated
              gold  a = DOMES number 40405S028 before the Landers earthquake and
              gold  b = DOMES number 40405S031 after)
  TYPE      = receiver name
  S/N       = serial number
  F/W       = firmware identification number
  VAL       = date after which this record becomes valid and should be used
  MOD       = date that this record was last modified
  COMMENT   = descriptive comment about this record such as source and author

STANDARD DISPLAY FORMAT FOR ANTENNAS

A ID--->S    TYPE-----------> S/N------------>                    VAL---------->  MOD---------->
  Comment: "COMMENT---------------------------------------------------->"                       
NOFFSET------->EOFFSET------->UOFFSET-------> FROM-----------> TO------------->

where:

  A         = antenna record type identifier
  ID        = six character site ID (typically only four characters are used)
  S         = site sequence identifier (e.g. the Goldstone, CA site was designated
              gold  a = DOMES number 40405S028 before the Landers earthquake and
              gold  b = DOMES number 40405S031 after)
  TYPE      = antenna descriptive name
  S/N       = serial number
  VAL       = date after which this record becomes valid and should be used
  MOD       = date that this record was last modified
  COMMENT   = descriptive comment about this record such as source and author
  NOFFSET   = north component of the offset caused by mounting hardware [m]
  EOFFSET   = east offset component [m]
  UOFFSET   = up offset component [m]

STANDARD DISPLAY FORMAT FOR MET SENSORS

M ID--->S                                                         VAL---------->  MOD---------->
  Comment: "COMMENT---------------------------------------------------->"
   PR_NAME------------> S/N------------>  OFFSET---> Pressure Sensor
   RH_NAME------------> S/N------------>             Relative Humidity Sensor
   TM_NAME------------> S/N------------>             Temperature Sensor

where:

  M         = met sensor record type identifier
  ID        = six character site ID (typically only four characters are used)
  S         = site sequence identifier (e.g. the Goldstone, CA site was designated
              gold  a = DOMES number 40405S028 before the Landers earthquake and
              gold  b = DOMES number 40405S031 after)
  PR_NAME   = pressure sensor identfier such as manufacturer name
              and model number
  RH_NAME   = relative humidity sensor identfier such as manufacturer name
              and model number
  TM_NAME   = temperature sensor identfier such as manufacturer name
              and model number
  S/N       = serial number
  OFFSET    = pressure sensor minus ARP vertical offset [meters]
  VAL       = date after which this record becomes valid and should be used
  MOD       = date that this record was last modified
  COMMENT   = descriptive comment about this record such as source and author

STANDARD DISPLAY FORMAT FOR OCEAN-LOADING PARAMETERS

M ID--->S                                                         VAL---------->  MOD---------->
  Comment: "COMMENT---------------------------------------------------->"
AMPLITUDE---> PHASE------->  M2  Principal Lunar          12.42 h
AMPLITUDE---> PHASE------->  S2  Principal Solar          12.42 h
    .            .                   .
    .            .                   .
    .            .                   .
AMPLITUDE---> PHASE------->  Mm  Lunar Monthly            27.55 d
AMPLITUDE---> PHASE------->  Ssa Solar semiannual         182.62 d

where:

  M         = met sensor record type identifier
  ID        = six character site ID (typically only four characters are used)
  S         = site sequence identifier (e.g. the Goldstone, CA site was designated
              gold  a = DOMES number 40405S028 before the Landers earthquake and
              gold  b = DOMES number 40405S031 after)
  TYPE      = receiver name
  AMPLITUDE = indicated tidal harmonic amplitude [meters]
  PHASE     = indicated tidal harmonic phase lag [degrees]
  VAL       = date after which this record becomes valid and should be used
  MOD       = date that this record was last modified
  COMMENT   = descriptive comment about this record such as source and author

EPOCH DISPLAY FORMAT

Only the latest of each record type for a site is shown. This format mimicks the station information block in a pages.sum file. Following this information, the coordinates for that site are constructed from these pieces. Each piece (converted to geocentric system if necessary), the final result giving the coordiantes of the L1 phase center at the specified epoch, the vector which must be added to get the L2 phase center, and the phi, lambda, height (latitude/longitude/ellipsoid height) that corresponds to the L1 coordinates. Each line in this construction is labeled for clarity.

POM DISPLAY FORMAT

The latest of each record type for a site is used to construct an OMNI style Position/Offset/MET display. The coordinates are for the L1 phase center at the specified epoch. A zero offset will therefore be given, but the L1-L2 vertical offset should be appropriate. The MET values are generated by a global model which accounts for seasonal variations in temperature, and ellipsoidal height for the pressure. The antenna type follows on a separate line. The final line is a comment giving the history of this information.

---

---

 TOC  |      |      |              |              | INDEX

---

---

xsites.html
October 6, 2000