Eliminate pictures from landmark

(lithos Main Menu Option E. Eliminate pictures from landmark)

Description

This Main Menu option allows you to remove pictures from a landmark.

$/!\$ You must first use Option I to load the landmark.
THE EFFECT IS IMMEDIATE AND YOU CANNOT UNDO! There is no need to save afterwards.

Submenu

When you choose Option E. Eliminate pictures from landmark from the Main Menu, you will see this display and submenu:

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

   #     PICNM          EMISS      COV       ILL       RES       #LMK      PHASE      INV  +/-

   1   P3T11L2H0201     47.57      0.88      0.88      0.25        96        51         0 *
   2   P3T11L2H0202     47.57      0.88      0.88      0.25        96        52         0 *
   3   P3T11L2H0203     50.91      0.88      0.88      0.26        94        30         0 *
   4   P3T11L2H0204     50.91      0.88      0.88      0.26        96        68         0 *
   5   P3T11L2H0206     51.04      0.95      0.95      0.26        97        75         0 *
   6   P3T11L2H0207     47.92      1.00      1.00      0.25        95        30         0 *
   7   P3T11L2H0208     47.92      1.00      1.00      0.25        97        68         0 *
   8   P3T11L2H0209     43.08      0.93      0.93      0.24        96        52         0 *
   9   P3T11L2H0210     43.08      0.93      0.93      0.24        97        52         0 *
  10   P3T11L2H0211     39.22      0.85      0.85      0.23        96        68         0 *
  11   P3T11L2H0212     39.22      0.85      0.85      0.23        94        30         0 *
  12   P3T11L2H0213     39.02      0.95      0.95      0.23        96        74         0 *
  13   P3T11L2H0215     42.66      1.00      1.00      0.24        96        68         0 *
  14   P3T11L2H0216     42.66      1.00      1.00      0.24        93        30         0 *

  3.05061409811740111E-002  7.31441252330175540E-003

 c. Continue
 a. Auto remove
 m. Manual remove
 n. Auto remove (new pictures)
 o. Remove low-correlation pix
 p. Prune landmark
 v. Check peripheral visibility
 t. Auto change topo flags
 l. Change low-correlation topo flags
 q. Quit

The display includes these elements:

# - Temporary image number.

PICNM - Picture name.

EMISS - Emission angle, determined by the current topography.

COV - Coverage, the fraction of the landmark covered by the image.

ILL - Illumination, the fraction of the landmark that is not in shadow.

RES - Resolution, the image resolution divided by the GSD.

Often times the RES value will be slightly different than what would be calculated by hand. I suspect this is the case because the picture is orthorectified before determining the image resolution; hence, the image resolution listed in PICINFO.TXT (from RESIDUALS) is only valid at the center of the image. If I am correct, then the image resolution effectively decreases towards the edges of the image.

#LMK - Number of landmarks added to that picture.

PHASE - Phase angle of the image.

INV - Percentage of pixels that are "invisible", which means the pixel cannot be seen because it is blocked, such as the bottom of a crater in an oblique view. This is listed as parts per thousand, so 2.7% would display as "27".

+/- - Contains an * if the image resolution is more than three times higher or lower than the maplet scale.

Here are the choices from the submenu:

c. Continue - Same as entering 'q'.

a. Auto remove - Displays a grid like this:

     1  2  3  4  5  6  7  8  9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30
  0  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
  2  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
  4  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
  6  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
  8  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
 10  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
 12  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
 14  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
 16  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
 18  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
 20  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
 22  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
 24  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
 26  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
 28  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
 30  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
 32  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
 34  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
 36  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
 38  .  .  3  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
 40  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
 42  .  .  4  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
 44  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
 46  .  .  4  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
 48  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
 50  .  .  3  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
 52  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
 54  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
 56  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
 58  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
 60  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
 62  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
 64  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
 66  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
 68  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
 70  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
 72  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
 74  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
 76  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
 78  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
 80  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
 82  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
 84  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
 86  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
 88  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
 90  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .

 Input INVLIM, SLIM, CLIM, ILIM, RSMN, RSMX

The grid contains these elements:

Rows - This the emission angle, and is based upon the current topography. If the topography is poor, you may eliminate pictures you want to keep and/or keep pictures you want to eliminate.
Columns - These are images with resolutions from 0 to 3 times the maplet scale (30 = 3 times maplet scale).
You will be prompted to Input INVLIM, SLIM, CLIM, ILIM, RSMN, RSMX. The standard input is '0,60,.25,.25,0,3'. Most permissible: '1000,90,0,0,0,inf' => does not throw any image away. Least permissible: '0,0,1,1,inf,0' => throws all away.
- INVLIM - Value that represents the maximum fraction of points in the image that can be "invisible". "Invisible" means that the pixel cannot be seen because it is blocked, such as the bottom of a crater in an oblique view. The number entered is thousandths of a fraction. For 2.7%, enter '27'. Typically this value is just set to 0.
- SLIM - Maximum emission angle that is allowed.
- CLIM - Coverage limit. Minimum fraction of maplet overlapped by image.
- ILIM - Illumination limit. Minimum fraction of maplet covered by illuminated image.
- RSMN - Minimum allowed ratio of image resolution (km/px) to maplet scale.
- RSMX - Maximum allowed ratio of image resolution (km/px) to maplet scale.

m. Manual remove Enter the image number you wish to remove.

$/!\$ DO NOT enter the picture number as it says! Enter the image number.

You can enter

a single image number followed by 'Enter' for each image
a range of numbers separated by commas. For example, '1,5' means delete images 1 through 5.
'0' followed by 'Enter' to quit.

Here is a sample of the inputs for m. Manual remove.

  input number of picture to remove.  0 to quit.
1,5
10
0

n. Auto remove (new pictures) - Same as Option a. Auto remove , but it only deletes images added while loading (i.e., input ["i"] followed by "y").

o. Remove low-correlation pix - If you have performed an alignment such as 1-0-1, this option can be used to remove all images that are below the user-entered threshold. For example, enter '0.2' to remove all images with a correlation below 0.2.

p. Prune landmark - Randomly eliminates images of forms specified in INIT_LITHOS.TXT if the landmark contains more than a set number of images.

v. Check peripheral visibility - Not typically used.

t. Auto change topo flags - Not typically used.

l. Change low-correlation topo flags - Not typically used.

Additional Reference

p. Prune landmark

[from LITHOS.f] - This has only been used for MESSENGER where the limit is typically about 500.

v. Check peripheral visibility

[from LITHOS.f] - Removes images in which part of the maplet is obscured by another part of the body.

t. Auto change topo flags

[from LITHOS.f] - Filters the images in the same way as options a and n, but instead of being eliminated, a flag is set in the landmark file that prevents the image from being used to determine the maplet topography. However, it is still used in the geometry solution for landmark location.

l. Change low-correlation topo flags

[from LITHOS.f] - Is similar to option t, except images whose correlation with the illuminated maplet is less than a specified value is flagged. [Taken from LITHOS.f]

(Compiled by JRW)

CategoryLithosMenu