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