add2line - Converts ASCII formatted 2-line orbital elements to dataset format.

SYNOPSIS

add2line inputfile

DESCRIPTION

add2line is a shell script designed to convert the ASCII form of the 2-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 fixoes for converting ASCII 1-line orbital elements.)

The format of the 2-line orbital elements in the input file is shown in twoinput. The input file can contain orbital elements for multiple satellites.

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

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

PARAMETERS

inputfile

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

EXAMPLE OUTPUT

The following is an example of converting the 2-line elements in the file elements.new.  This file contains both 1-line and 2-line ASCII format elements for multiple satellites.

% add2line elements.new
   .
   .
   .
Processing noaa-12
Adding 2/2 lines
1 21263U 91032  A 01159.17124328  .00000383  00000-0  00000+0 0  1921
2 21263  98.5742 151.6664 0013310  30.0278 330.2161 14.24027957522880 
Processing noaa-14
Adding 2/2 lines
1 23455U 94089  A 01159.18921905  .00000198  00000-0  00000+0 0  7692
2 23455  99.1795 151.4777 0009377 170.2258 189.9588 14.12694441331959
Processing noaa-15
Adding 2/2 lines
1 25338U 98030  A 01159.20868454  .00000313  00000-0  00000+0 0  2285
2 25338  98.5996 186.7038 0010420 324.7128  35.3950 14.23583949159521
Processing noaa-16
Adding 2/2 lines
1 26536U 00055  A 01159.21807544  .00000265  00000-0  00000+0 0  3568
2 26536  98.8253 105.0792 0010362 260.9133  99.1347 14.11172786 36638
   .
   .
   .

 

FILES

twoinput, orbinput, orbdata

SEE ALSO

fixoes, neworb, etx, datasets, checkorb.

NOTES

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


Last Update: $Date: 2001/07/27 18:32:31 $