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)