Stereo Angle

By TC


Description

This process details the usage of stereo.py, a python script loosely based on Mambo_5 meant to offer support for multiple landmarks at once without plots. This script will take a list of landmarks, and for each landmark in the list, calculate the maximum stereo angle and maximum sun divergent angle.

**N.B. This script requires access to LMKFILES/, SUMFILES/, and an up-to-date MAPINFO.TXT. As such, residuals should be run before invocation, and the script should be run from your SPC working directory.


Usage

For a general usage overview, run: 

python stereo.py -h

Using the above command will print out the usage header: 

# USAGE: python stereo.py [-option] outfile infile
#
#     -o   Use this followed by 'outfile' to
#          specify a unique output destination.
#          Default is stereo.txt
#
#     -h   Use this to print usage directions
#          to StdOut. (Prints this header)
#
#     -v   Use this to only output current
#          version number and exit. By default
#          the version will be sent to StdOut
#          at the begining of each use.
#
#   ** N.B. If 'infile' is not specified, LMRKLIST.TXT
#           will be used.
#######################################################

A typical invocation of this script is: 

python stereo.py /path/to/maplist.txt

Using the "-o outfile" option is not necessary and is only used if you wish to specify the name and path of the outputted text file. By default the output will be stereo.txt (example shown in Output section).

If you do not specify an input file on the command line, LMRKLIST.TXT will be used by default. The input file should be a single column of 6 character landmark names, which can either have or not have "END" as the last line of the file.

Do to the potential of long processing time for landmarks with lots of images, a display of the current landmark and its position out of the total number to be processed is printed to the screen. 

Working on:
.
.
.
EE0043 17 out of 64
EE0044 18 out of 64
EE0045 19 out of 64
EE0046 20 out of 64
EE0047 21 out of 64
EE0048 22 out of 64
EE0049 23 out of 64
EE0050 24 out of 64
.
.
.


Output

Every time this script is run, the version and I/O files are printed to the screen for traceability. 

Stereo.py version: 1.2
List of landmarks used: maplist
Output file: stereo.txt

The only important output of the script is a text file (either stereo.txt or specified by -o filename.txt) which has 6 columns. 

EE0027  -3.0993  267.7872  10  113.41364324  159.353969018
EE0028  -3.0954  266.3576  10  108.951433055  145.87129407
EE0029  -3.0966  264.9467  9  86.9082155552  145.871294071
EE0030  -3.0563  263.5016  14  101.030459754  143.882101571
EE0031  -3.0162  262.0543  11  40.6105626219  145.871294069
EE0032  -2.9929  260.6454  9  40.154078842  145.871294069
EE0033  -4.5369  267.7770  7  108.597678882  145.871294071
EE0034  -4.5254  266.3470  6  101.181158529  145.184430105
EE0035  -4.5302  264.9462  7  108.971920542  143.882101572
EE0036  -4.5150  263.5352  9  108.990188216  145.871294071
EE0037  -4.4769  262.0850  13  86.837368171  145.87129407