TOC | Last Section | Next Section | INDEX | 

Running run_survey

Description

Everything is now in place to process these data. run_survey can be run from any location on the system because command-line arguments uniquely identify the directory to be processed. The required command-line arguments are, in this order:

1. base of the processing directory tree
2. the year of the data files (and part of the work directory name)
3. the doy of the data files (and part of the work directory name)

Other command-line arguments are recognized and described in this documentation. These will not be discussed in this basic tutorial.

Recall that the purpose of run_survey is standard, hands-off processing. The run_survey script was designed for batch processing such as initiation by a crontab or a block of several day intiated sequentially by a simple script.

Tutorial

At the end of the last tutorial, the current directory was ~/tutorial/files.

Notes

Messages from run_survey which appear on the screen are also stored in the run_msg file in the work directory. The run_msg file is particularly valuable in tracking multiple batch jobs.

run_survey attempts to trap all errors and exit gracefully. If and error does occur, a message and time tag are printed to the screen and the run_msg file. The work directory is left in the same state as when the the error occurred. One can then go into the work directory, manually run the indicated program (or script) and begin debugging the fault.

Software development has always kept an eye towards the PC environment. To this end, the eight character name + dot + three character extension file naming convention is generally kept. In turn, the twelve character file name restriction implies that files, which could be identified most clearly by using the four character site ID's, must use a different naming convention. This "renaming" convention is coded into and enforced by the locgen program and is for the purpose of file naming only. The convention is best defined by its implimentation.

• The site ID's are sorted alphabetically. This tutorial uses three sites:
1. chl1,
2. gode,
3. sol1.
• Each site is then given a two character ID depending upon its position in this alphabetically ordered list: aa = 1, ab = 2, ac = 3, ...; therefore our list becomes:
1. chl1 = aa
2. gode = ab
3. sol1 = ac
• locgen, in identifying baseline pairs of sites, subsequently uses these two character site ID's to name files. For example, files associated with the sol1-gode baseline would contain the string acab.
• One additional note, after locgen, the minimum logical data grouping is the two sites which comprise a baseline. Hereafter, these two site, baseline pairs will be referred to by their four character ID's or ???? generically.

Explicitly knowing this convention is not required. locgen lists the baseline pairs with their ID's in its summary file, elv.loc. For convenience, run_survey duplicates this list in the bls file.

The working directory, ~/tutorial/96_360, has be modified. The files and subdirectories will be listed below with brief descriptions of their purpose.

The directory structure now looks like:

      data  inpt  plts

          \   |   /

            96_360         files

            ------         -----

               \_____________/

                  tutorial

                      |

                     ---

                      ~

The purposes of the three new subdiretories and the files they contain are:

• data holds the original RINEX files and ephemeris.
• inpt holds input and output files from intermediate processing steps:
• ????00.edt are edit instruction generated by editdb,
• bd_???? are bdata input files,
• do_???? are editdb input files,
• eclipse is a list of eclipsing satellites and approximate eclipse times,
• elv.loc is the locgen summary file,
• mergedb.sum is the mergedb summary file,
• mg_???? are the pages input files.
• plts holds plot files. Information used in the plots are several file types, the plt and lim files are require, the rest are optional:
• .plt files contain the values to be plotted,
• .lim contain plot limits to speed display,
• .scn contain reference satellite scenario information,
• .log files are edit instructions created by xplot during manual editting.
Two plot types created in normal processing (many others are possible):
• ????01pf are post-fit residual plots create by pages,
• elv, satellite elevation angles verses time for each site, created by mergedb.

The work directory, 96_360 in this example, now has the pages processing files (binary files will be explicity identified; all other files are ASCII and, therefore, viewable with an editor):

• ????01.brk,  lists of times where phase bias estimates will be restarted in pages. In other words, times of known or suspected cycle slips. These files are created by editdb.
• ????01dt.dat, binary files of phase and pseudorange values, and edit instructions.
• ????01or.dat, binary files of satellite coordinates
• ????01hd.dat, files providing the minimum information needed for further processing.
• a copy of the ephemeris if one has been provided.
• leap_seconds, the list of leap seconds since January 1, 1980, the start of GPS time.
• pages.inp, a pages input file. This file contains flags controlling free parameter estimation and database informtion; things which would change with each processing session.
• pages.log, a run-time log of pages messages and products.
• pages.nrm, a binary file created by pages and used by gpscom.
• pages.skl, a pages input contain model and constraint controls; things which would change infrequently.
• pages.snx, the pages summary file in SINEX format.
• pages.sum, a complete summary of the pages solution.
• run_msg, the run_survey run-time messages mentioned above.

 TOC | Last Section | Next Section | INDEX | 

bl_6.html
March 4, 1999
Steve Hilla