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 average and maximum stereo and sun divergent angles.

**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: 2.0
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 8 columns.

Column 1: Landmark name
Column 2: Latitude
Column 3: W Longitude
Column 4: Number of images in landmark
Column 5: Average stereo angle between images (degrees)
Column 6: Maximum stereo angle between images (degrees)
Column 7: Average Sun divergent angle for landmark (degrees)
Column 8: Maximum Sun divergent angle for landmark (degrees)

EE0027  -3.0993  267.7872  10  41.256 113.414  51.013 159.354
EE0028  -3.0954  266.3576  10  54.339 108.951  66.309 145.871
EE0029  -3.0966  264.9467  9  31.525 86.908  60.394 145.871
EE0030  -3.0563  263.5016  14  41.796 101.030  46.626 143.882
EE0031  -3.0162  262.0543  11  14.587 40.611  33.476 145.871
EE0032  -2.9929  260.6454  9  13.858 40.154  35.715 145.871
EE0033  -4.5369  267.7770  7  48.634 108.598  60.286 145.871
EE0034  -4.5254  266.3470  6  55.354 101.181  64.559 145.184
EE0035  -4.5302  264.9462  7  53.497 108.972  66.345 143.882
EE0036  -4.5150  263.5352  9  52.412 108.990  67.037 145.871