lithos

(compiled by JRW)

Aligns maplets to the current shape model and will provide slight changes to the shape (stored in MAPFILES).

Lithos is the key for SPC. It works on a single landmark, which defined the associated maplet. This landmark must be created (i.e. fully defined) and all the images it includes must be shifted so that everything is aligned. Once those are done, you can calculate the topography which includes identifying other maps that overlap, creating a template, and then solving the whole system.

The output from make_scriptT and make_scriptP is used as input to lithos and lithosP for batch processing. The make_script program will create an entry for each landmark in the script.b that you will process, which is taken as input (e.g. lithos < LAND01.INN > LAND01.OOT).

A common shortcut you can use throughout LITHOS will be to simply hit "Enter" for the default selection. Usually the default will be indicted by brackets. For instance, in the case of "Do you wish to continue? y[n]" hitting "Enter" will default to the "n" selection.

REQUIRES

• DATA/ - Data specific to each mission;

• 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;

• NOMINALS/ - a directory containing the full suite of nominals;

• SHAPEFILES/ - a directory containing the shapemodel;

• LMRKLIST.TXT - a list of the landmarks contained in the solution;

• PICTLIST.TXT - a list of the pictures contained in the solution; Will be used if PICTLISTX.TXT and PICTLISTRX.TXT do not exist

• BIGLIST.TXT - a list of all the bigmaps that have been created;

• INIT_LITHOS.TXT - file containing default values to 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 will be used to calculate overlaps, rather than LMRKLIST.TXT. This will enable 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 which speeds up processing by replacing the need to open individual .LMK files multiple times.

• PICTLISTX.TXT - Picture information similar in concept to LMRKLISTX.TXT; will be used if PICTLISTRX.TXT does not exist

• PICTLISTRX.TXT - File containing list of images

MAIN MENU

The MAIN MENU can be seen from within LITHOS by typing "?" into the user prompt. The following list will be displayed. Each of the links below can be clicked on for further details.

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

• C. Create new landmark

• R. Replicate or Rename landmark

• S. Change scale, qsz or orientation

• G. Turn on rename

• ADJUST INPUT DATA AND NOMINALS

• N. Find normal

• V. Find V, Z or PTG

• A. Reset albedo or slopes

• M. Get heights from shape model

• B. Get heights from surrounding map

• X. Turn on extract filter

• DELETE, ELIMINATE OR IGNORE FILES

• D. Delete or Disconnect landmark

• E. Eliminate pictures from landmark

• P. Picture status

• L. Turn off picture restriction

• INFORMATION AND DISPLAY

• F. Find maplets containing surface point

• Z. Use zoom display

• H. Hide screen output

To view most of the updates you see while using LITHOS, look at the two files that are displayed every time the Main Menu is loaded

 Current landmark = EE0001
SCALE =  0.000100 QSZ =   49
 Lat/Lon/Rad =     -6.800   264.090     0.266
 Region = EE

 gc LMRK_DISPLAY0.pgm
 gc LMRK_DISPLAY1.pgm


 check display
Main Menu: Q 0123O IUCRSG NVAMBX DEPL FZH? 

Here is LMRK_DISPLAY0.pgm. It displays the raw images (i.e. no brightness scaling). This image is used rarely (if ever).

Here is LMRK_DISPLAY1.pgm. It displays images that are stretched to bring out features and make the images more "readable". This image is used extensively while using LITHOS.

Link to version original one page (renamed 1/13/16) Old_lithos_text