fixoes - Converts ASCII formatted 1-line orbital elements to dataset format.

SYNOPSIS

fixoes inputfile [max_distance]

DESCRIPTION

fixoes is a shell script designed to convert the ASCII form of one-line orbital elements in a file to binary form and append them to the orbdata files in $SATDATA/satellite. Orbital elements will be updated for all satellites with a directory.  (See add2line for converting ASCII 2-line orbital elements.)

fixoes optionally validates input orbital elements by comparing them to the orbital elements already stored in the orbdata files.

The format of the orbital element lines in the input file is shown in orbinput. The input file can contain orbital elements for multiple satellites and can contain other text which is ignored. For example, if a site has orbital elements electronically mailed to their site, fixoes can be run in background and specify /usr/spool/mail/user to be the input.

No more than one user can run fixoes at a time. fixoes checks if a lock file called fixoes_lock is in the directory $SATDATA. If so, fixoes knows that another copy of fixoes is already running. If not, fixoes creates $SATDATA/fixoes_lock, updates orbital elements, and removes $SATDATA/fixoes_lock upon completion.

Note that users without write access to the directory $SATDATA cannot run fixoes.

PARAMETERS

inputfile

The name of the ASCII formatted file containing orbital elements. This must be specified on the command line.

max_distance

The maximum distance in kilometers between the satellite positions computed for the 24-hour period using orbital elements from the input file and orbdata files (the entries with the closest date are selected from orbdata files). This must be specified on the command line. If no max_distance is specified, new orbital elements will be appended to orbdata files without validation. The validation is performed with the checkorb function. Rejected orbital elements are appended to the orbinput.err file residing in the same directory as orbinput.

EXAMPLES

[1] % fixoes n12.orbelems 10
Processing noaa-12
Adding 4 lines
21263.3625932.8339734.00048.0012876.6589426.8124916.2742607910524
21263.9395347.8340365.00060.0013521.1195747.8132175.2742484910731
21263.6531151.8440942.00057.0012809.6441593.8137957.2742365910928
21263.7319677.8341910.00017.0013290.9411397.8144013.2741978911225
Validating 4 lines, 10 km max. difference
21263.3625932.8339734.00048.0012876.6589426.8124916.2742607910524
21263.9395347.8340365.00060.0013521.1195747.8132175.2742484910731
21263.7319677.8341910.00017.0013290.9411397.8144013.2741978911225
------------ Bad Lines -----------------
21263.6531151.8440942.00057.0012809.6441593.8137957.2742365910928
 (91/09/28, 7314 km (avg 3743 km))
/opt/terascan/refdata/satel/noaa-12/orbdata created
[2] % fixoes elements.new
Processing noaa-12
Adding 1 lines
21263.4787148.8355218.00021.0013310.0847942.7084797.2738174010608   9
/vol1/terascan/pass/satel/noaa-12/orbdata created
Processing noaa-14
Adding 1 lines
23455.8545763.8288721.00011.0009377.4743231.7078810.2754987010608   3
/vol1/terascan/pass/satel/noaa-14/orbdata created
Processing noaa-15
Adding 1 lines
25338.1275201.8352613.00017.0010420.9036640.8057030.2738878010608   1
/vol1/terascan/pass/satel/noaa-15/orbdata created 
Processing noaa-16
Adding 1 lines
26536.1979531.8279793.00015.0010362.7264723.5789395.2745147010608   2
/vol1/terascan/pass/satel/noaa-16/orbdata created

FILES

orbinput, orbdata, twoinput

SEE ALSO

add2line, neworb, etx, datasets, checkorb.

NOTES

Additional procedures for obtaining up-to-date orbital elements.


Last Update: $Date: 2001/07/27 18:33:04 $