= Input landmark =

([[lithos]] '''Main Menu Option I. Input landmark''')

== Description ==

This Main Menu option loads (inputs) a maplet into memory.

=== Suboptions ===

When you choose '''Option I. Input landmark''' from the Main Menu, you will see the following set of prompts and output:

  (!) You can also enter "r" or "RECENT" to load the previously loaded landmark.

{{{
Main Menu: Q 0123O IUCRSG NVAMBX DEPL FZH? i
 >i

 Input 6-character landmark name.[Q]
EE0001
    -0.48481     0.53724    -0.55314     0.60718

 gc slope.pgm


 Check for more images? y[n]
n
 Include a single image? y[n]
n

 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?
}}}

'''Check for more images? y[n]''' - Usually respond 'n'. Most times when you load a landmark you will not be adding new images. If you do need to add images, see below the line break.

'''Include a single image? y[n]''' - Usually respond 'n' (the default). Most times you will want to load all images that have been added to the landmark.

If you select 'y', you will define the image explicitly.  You must provide the name of the image you want to add.  It will prompt you to add it automatically, in which SPC will attempt to determine the pixel/line location of the landmark within the images.  If you want to enter the pixel/line location manually, you can do that. If you have entered an image in this way, you will be asked whether you want to enter another one.

If you select 'y', you must input a picture name. 

If you enter 'y' for "Check for more images? y[n]" you will see these prompts and outputs:


{{{
 Check for more images? y[n]
y

 Enter fractional width (0=center).
.5

 Reject invisibles? y[n]
n

 PICTLIST.TXT
P3T11L2H0205    580.20    189.39
...
P3T11L2H0214    219.62    692.50

 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?
}}}

'''Enter fractional width (0=center).''' - Typically, use 0.5. This asks for the fraction of the image that can be seen in the landmark.

'''Reject invisibles? y[n]''' - Typically, enter 'n' (default).
This prompt asks whether you want to include images where portions of the landmark will be blocked by some object in the front. For example, if most of the loaded landmark is of a crater, but immediately south of the crater is a large boulder, then all images taken from the south will have a boulder in the way and this boulder will be obscuring the crater. Enter 'n' to include as many images as possible; the images that would have been excluded are usually dealt with once they will no longer align properly.

 . The program then searches one of four files files to identify images to add:
  1.  [[PICTLIST.TXT]] - the list of all images
  1.  [[PICTLISTR.TXT]] - a restricted PICTLIST created by the user
  1.  [[PICTLISTX.TXT]] - an extended pictlist containing additional data to speed up processing
  1.  [[PICTLISTRX.TXT]] - the extended version of PICTLISTR.
 . The program searches in the order 4,2,3,1 and uses the first file found.


== Typical Example ==

The following sample shows the inputs for a typical use of '''Option I. Input landmark''' in which you load a maplet without adding images.

{{{
 i
 (Landmark)
 n
 n
}}}

If you want to add images to the landmark, your inputs will look like this:

{{{
 i
 (Landmark)
 y
 0.5
 n
}}}

----------

(Compiled by JRW)

CategoryLithosMenu