• lithosP

lithosP

(Compiled by JRW)

LithosP is essentially lithos, but is designed to be run in parallel. This guide assumes you are familiar with lithos. Some of the options found in lithos have been cut, and other options have been streamlined. Only the differences will be listed here.

REQUIRES

• IMAGEFILES/ - a directory containing the image .DAT files;

• SUMFILES/ - a directory containing the image .SUM files (updated solution image, S/C and camera information; lmrks and limbs);

• MAPFILES/ - a directory containing the full suite of maplets;

• LMKFILES/ - a directory containing the full suite of landmarks;

• BIGFILES/ - a directory containing all the bigmaps;

• SHAPEFILES/ - a directory containing the shape model;

• TESTFILES/ - a directory containing diagnostic files output by lithosP;

• LMRKLIST.TXT - a list of the landmarks contained in the solution;

• INIT_LITHOS.TXT - file containing default values for be read in by SPC toolkit.

OUTPUT

• tmpl.pgm - Temporary pgm amp file convert by RAW2PGM
• seeds.pgm - Temporary pgm amp file convert by RAW2PGM
• LMRK_DISPLAY0.pgm - Temporary pgm amp file convert by RAW2PGM. See below.
• LMRK_DISPLAY1.pgm - Temporary pgm amp file convert by RAW2PGM. See below.

OPTIONAL

• LMRKLISTO.TXT - If present, LMRKLISTO.TXT is used to calculate overlaps instead of LMRKLIST.TXT. This action enables lithos and lithosP to run faster by searching for overlaps among a limited set of landmarks;

• LMRKLISTX.TXT - Extended landmark list containing .LMK file information that speeds up processing by eliminating the need to open individual .LMK files multiple times;

lithosP Menu

• ... MAIN MENU ...
• Q. Quit LITHOS
• LANDMARK/MAPLET CONSTRUCTION
• 0. Find template
• 1. Align landmarks
• 2. Find heights
• O. Attach map to maps or limbs
• LANDMARK/MAPLET I/O AND CREATION
• I. Input landmark
• U. Update landmark files
• ADJUST INPUT DATA AND NOMINALS
• N. Find normal
• V. Solve for V
• Z. Predict px/ln
• A. Reset albedo or slopes
• M. Get heights from shape model
• B. Get heights from surrounding map
• X. Turn on/off extract filter
• INFORMATION AND DISPLAY
• H. Hide/Show screen output

0. Find template: None of the sub-options exist. From the Main Menu, to iterate 40 times, simply enter 0-40.

1. Align landmarks: None of the sub-options exists. From the Main Menu, you can still use 1-0-1, but that is only because the "0" is interpreted as 0 spacing and lithosP asks you to enter the spacing again. 1-1, 1-2, etc. are the "correct" commands to perform an auto-align.

2. Find heights: Only difference the author knows is the "differential stereo" sub-option. Instead of being asked if you would like to reset entering gradients and auto heights, there is just a single "y" or "n". So instead of entering "6-y-y" from the "Find heights" Menu, you instead will enter "6-y".

O. Attach map to maps or limbs: There are some minor differences between lithosP and lithos within this option.
lithosP offers a subset of the lithos:o options - 1. Automatic; and 3. Limbs. The implementation of these options is as per lithos.
lithosP reduces the search for limbs by using only those limbs that have already been found spanning the maplet. If a full search is desired, then the line NEWLIM=.TRUE. should be included in INIT_LITHOS.TXT.

I. Input landmark: lithosP does not include an option to add more images to an existing landmark. Therefore, from the main menu, input i and the landmark name, no further inputs are required. You will be returned to the main menu.

U. Update landmark files: Sub-options do not exist. The only option available is the "1" option which is the full save. Instead of entering "u-1" from the Main Menu, you now just enter "u".

N. Find normal: Sub-options do not exist. The only option available is the "2" option which is the most used option. Instead of entering "n-2" from the Main Menu, you now just enter "n".

V. Solve for V: Sub-options do not exist. The only option available is the "1" option which is the most used option. Instead of entering "v-1" from the Main Menu, you now just enter "v".

Z. Predict px/ln: ??? This options exists in the code, but there is no documentation for it. The author has never used this option. This option calls the sub-routine V2INGPL which determines the pixel/line location of a landmark in an image, but the resulting data isn't output to a file.

A. Reset albedo or slopes: No known differences.

M. Get heights from shape model: No known differences.

B. Get heights from surrounding map: No known differences.

X. Turn on/off extract filter: No known differences.

H. Hide/Show screen output: No known differences.