= lithosP =

||Category B||Version 3.0||

== Description ==

'''lithosP''' is essentially [[lithos]], but it is designed to be run in parallel. 

 /!\ This guide assumes that you are familiar with [[lithos]]. Some of the options found in [[lithos]] have been cut, and other options have been streamlined. Only the differences are presented here.

=== Required Files ===
 * [[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

=== Optional Files ===
 * [[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.

=== Output Files ===
 *  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.


== Using lithosP ==

'''lithosP''' is designed to be run in parallel. The following shows the Main 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

-----

 /!\ Some of the Main Menu options found in [[lithos]] have been cut, and other options have been streamlined. Only the differences are presented here.

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

'''1. Align landmarks''' - None of the sub-options exist. 
 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. 
 Enter '1-1', '1-2', etc. as the "correct" commands to perform an auto-align.

'''2. Find heights''' - Only known difference 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'. 
 From '''Find heights''', enter '6-y' instead of entering  '6-y-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 the same as for [[lithos]].

 * '''lithosP reduces the search for limbs by using only those limbs that have already been found spanning the maplet'''.  If you want to do a full, include the line 'NEWLIM=.TRUE.' 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. 
 Enter 'u' from the Main Menu instead of entering 'u-1'.

'''N. Find normal''' - Sub-options do not exist. The only option available is the "2" option which is the most used option. 
 Enter 'n' from the Main Menu instead of entering 'n-2'.

'''V. Solve for V''' - Sub-options do not exist. The only option available is the "1" option, which is the most used option. 
 Enter 'v' from the Main Menu instead of entering 'v-1'.

'''Z. Predict px/ln''' - This options exists in the code, but there is no documentation for it. 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.

----------

''(Compiled by JRW)''

CategoryPrograms