= 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.<<BR>>
lithosP offers a subset of the [[lithos]]:o options - 1. Automatic; and 3. Limbs. The implementation of these options is as per [[lithos]].<<BR>>
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 include more images to an existing landmark.

'''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.

'''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.