RUNNING run

 TOC | Back | Next |              |              | INDEX

RUNNING run_survey

Usage: run_survey {-abcdefhilmnopqrstuvwxyzBDEGLRSTX} path yr doy

where

path is the path to the subdirectory where processing will occur,
yr two digit year of the data to be processed,
doy three digit day-of-year of the data to be processed.

OPTIONAL COMMAND LINE ARGUMENTS

FLAG	DEFINITION	ARGUMENTS	DEFAULTS
-a	auto-select start/stop time		00:00:00 - 23:59:30
-b	batch processing prints messages but does not stop if possible		00:00:00 - 23:59:30
-c	double-difference de-correlation off		on
-d	processing control	value (1 = a priori; ...)	0 = do all steps
-e	elevation cutoff	value (degrees)	15 degrees
-f	observable	value (1 = L1 only, ...)	3
-h	this help message
-i	data interval	value (seconds)	30 seconds
-l	user input time limits	will query user
-m	piece-wise, linear tropo off		on
-n	do not write normal matrix file		on
-o	output plots		post-fit plots only
-p	precise ephemeris	file name	search
-q	quite; no screen messages		verbose
-r	relative tropo model		tropo at all sites
-s	site info file	file name	search for the following /ngslib/data/GPS/site_info.cors /ngslib/data/GPS/site_info.igs ../files/site_info ../files/site_info.cors ../files/site_info.igs
-t	tropo interval	value (seconds)	7200 seconds
-u	satellite and EOP estimates on		off
-v	station velocity estimates on		off
-w	output ephemeris file name	file name	pages.eph
-x	omit satellite	PRN number	none
-y	prohibit satellite as reference	PRN number	eclipsing satellites only
-z	tropo delay type	value (P = PWV; ...)	Y
-B	enter an a priori binary ephemeris for orbit adjustment	file name Required with "-u" option.	none
-D	maximum precentage of deleted observations allowed	value (percent)	50
-E	enter an a priori EOP file	file name Required with "-u" option.	none
-G	designate tropo and satellite parameters as global		off
-L	designate tropo and satellite parameters as local		off
-R	maximum a priori RMS seen by editdb	value (m)	10
-S	maximum number of reference satellite scenarios	value	35
-T	minimum precentage of total observations allowed	value (percent)	50
-X	do not write SINEX file		on

Examples

Standard run using all defaults: 30s data interval; 15 deg elv cutoff; ion-free observable; 2 hr piece-wise, linear tropo; auto-select precise ephemeris.: run_survey ~/airport 96 124
Force an "L1 only" solution.: run_survey -f 1 ~/airport 96 124
Force relative tropo estimation with a 6 hr interval.: run_survey -r -t 21600 ~/airport 96 124
Force an specific a priori ephemeris ephemeris: run_survey -p igs08521.sp3 /Mywork 96 127

RUNTIME MESSAGES

Normal processing generates screen messages like the following:

run_survey: PROCESSING /u3/Beta_tests/Tutorial/96_360      @ 98/03/23 17:28:08
run_survey: UNCOMPRESSING RINEX FILES                      @ 98/03/23 17:28:08
run_survey: CREATING elv.plt USING mergedb                 @ 98/03/23 17:28:10
run_survey: DESIGNING NETWORK USING stree                  @ 98/03/23 17:28:34
run_survey: CREATING EDITTED, TWO STATION DATABASES        @ 98/03/23 17:28:35
run_survey:   gode + sol1 -> abac                          @ 98/03/23 17:28:40
run_survey:   gode + chl1 -> abaa                          @ 98/03/23 17:29:02
run_survey: BASELINE ESTIMATION USING pages                @ 98/03/23 17:29:27
run_survey: NORMAL TERMINATION                             @ 98/03/23 17:32:38

Examples of some common problems:

PROBLEM: Erroneous path was entered.

run_survey ERROR: PROJECT DIRECTORY "/bad/directory" DOES NOT EXIST.
run_survey: STOP @ 98/03/24 13:23:28

PROBLEM: One of the programs run by run_survey failed.
In these cases, the processing directory is left in the state when the program failed to facilitate debugging. One could go into the processing directory and run the faulting program manually to see additional messages.

run_survey: PROCESSING /u2/Beta/Tests/Tutorial/96_360      @ 98/03/24 13:26:32
run_survey: UNCOMPRESSING RINEX FILES                      @ 98/03/24 13:26:32
run_survey: CREATING elv.plt USING mergedb                 @ 98/03/24 13:26:40
run_survey ERROR: mergedb RUNSTAT="1".
run_survey: STOP @ 98/03/24 13:26:40

PROBLEM: One of the compressed RINEX data files is corrupt.
The corrupt file will be stored in the data/Corrupt subdirectory and processing continues.

beta_survey: PROCESSING /u2/Beta/Tests/Tutorial/96_360      @ 98/03/24 13:32:49
beta_survey: UNCOMPRESSING RINEX FILES                      @ 98/03/24 13:32:49
beta_survey ERROR: UNCOMPRESSING "chl13600.96o.Z".
beta_survey WARNING: MOVING FILE TO /u2/Beta/Tests/Tutorial/96_360/data/Corrupt.
beta_survey: CREATING elv.plt USING mergedb                 @ 98/03/24 13:32:50
beta_survey: DESIGNING NETWORK USING stree                  @ 98/03/24 13:33:16
beta_survey: CREATING EDITTED, TWO STATION DATABASES        @ 98/03/24 13:33:18
beta_survey:   gode + sol1 -> aaab                          @ 98/03/24 13:33:21
beta_survey: BASELINE ESTIMATION USING pages                @ 98/03/24 13:33:59
beta_survey: NORMAL TERMINATION                             @ 98/03/24 13:36:39

PROBLEM: Fewer than two RINEX data files were found.

run_survey: PROCESSING /u3/Beta_tests/Tutorial/96_360      @ 98/03/23 17:32:39
run_survey: UNCOMPRESSING RINEX FILES                      @ 98/03/23 17:32:39
run_survey: CREATING elv.plt USING mergedb                 @ 98/03/23 17:32:40
run_survey ERROR: INSUFFICIENT NUMBER OF DATA FILES.
run_survey: STOP @ 98/03/23 17:32:40

PROBLEM: No fixed/constrained sites' RINEX data files were found.

run_survey: PROCESSING /u3/Beta_tests/Tutorial/96_360      @ 98/03/23 17:32:41
run_survey: UNCOMPRESSING RINEX FILES                      @ 98/03/23 17:32:41
run_survey: CREATING elv.plt USING mergedb                 @ 98/03/23 17:32:42
run_survey ERROR: NO FIXED SITES IN DATA SET.
run_survey ERROR: NO NETWORK HUB SITES IN DATA SET.
run_survey: STOP @ 98/03/23 17:32:43

PROBLEM: No broadcast message ( RINEX "n") files were found.

run_survey: PROCESSING /u3/Beta_tests/Tutorial/96_360      @ 98/03/23 17:32:43
run_survey: UNCOMPRESSING RINEX FILES                      @ 98/03/23 17:32:44
run_survey ERROR: NO BROADCAST EPHEMERIS FOUND
run_survey: STOP @ 98/03/23 17:32:45

POSSIBLE PROBLEM: A precise ephemeris was not found.

run_survey: PROCESSING /u3/Beta_tests/Tutorial/96_360      @ 98/03/23 17:32:46
run_survey: UNCOMPRESSING RINEX FILES                      @ 98/03/23 17:32:46
run_survey WARNING: NO PRECISE EPHEMERIS FOUND.  USING BROADCAST.
run_survey: CREATING elv.plt USING mergedb                 @ 98/03/23 17:32:48
run_survey: DESIGNING NETWORK USING stree                  @ 98/03/23 17:33:12
run_survey: CREATING EDITTED, TWO STATION DATABASES        @ 98/03/23 17:33:13
run_survey:   gode + sol1 -> abac                          @ 98/03/23 17:33:18
run_survey:   gode + chl1 -> abaa                          @ 98/03/23 17:33:40
run_survey: BASELINE ESTIMATION USING pages                @ 98/03/23 17:34:06
run_survey: NORMAL TERMINATION                             @ 98/03/23 17:37:11j

PROBLEM: User input precise ephemeris was not found.

run_survey ERROR: ARGUMENT FOR FLAG -p = "igs.eph".
run_survey: STOP @ 98/03/24 13:16:02

PROBLEM: Error in a user specific, command-line parameter.
This example shows the result of a non-numeric elevation cutoff value.

run_survey ERROR: ARGUMENT FOR FLAG -e = "dummy".
run_survey: STOP @ 98/03/24 13:19:11

 TOC | Back | Next |              |              | INDEX

running.html
February 23, 2000
Steve Hilla