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