This program registers existing maplets with imaging data from a single image using parallel processing (sequential image processing on a number of core processors).

Like autoregister, autoregisterP

autoregisterP provides a sub-set of the procedures in autoregister and is similar to register, but can handle 3 degrees of freedom, orientation, and twist.

autoregisterP is almost always run in a parallel batch mode, following a script set up by make_scriptAP. It uses lockout files to prevent two processes from reading or writing to a landmark file at the same time. Some of the menu options below are never used in the batch mode, although they are fully functional if you want to run autoregisterP in interactive mode.

autoregisterP aligns existing maplets with imaging data from a single image and uses subroutine IPL2SCOBJPTG to update the camera pointing and spacecraft-object vector in the corresponding SUMFILE.

Required Files

Optional Files

Output Files

User Warnings

added to landmarks until the landmark file is updated.

Using autoregisterP

Initial Inputs

The following shows the initial inputs necessary to get to the Main Menu:

 input 12-character picture name. q to quit.

    1     EE0001 *
    2     EE0002 *
    3     EE0003 *
    4     EE0004 *
    5     EE0005 *
    6     EE0006 *

 gc TEMPFILE.pgm
 kb =            1      kk =            1

 Add landmarks? (y/n)

 enter fractional width (0=center)
 Reject invisibles? (y/n)

    7   EE0007    0.00
    8   EE0008    0.00
    9   EE0009    0.00
   10   EE0010    0.00
   11   EE0011    0.00
   12   EE0012    0.00
   13   EE0013    0.00
   14   EE0014    0.00
   15   EE0015    0.00
   16   EE0016    0.00
  1. Enter a 2-character USR name to distinguish between processes.

    (./) Does this need an example? It doesn't show up as an input in sample above.

  2. Enter the 12-character picture name.

The program produces a list of existing landmarks, if any, creates the TEMPFILE.pgm and displays the kb, and kk values.

  1. If you wish to add more landmarks, respond y. An initial filter for added images is set in INIT_LITHOS.TXT:

    • RESLM is the maximum ratio of the image resolution to the maplet scale;

    • SIZLM is the maximum ratio of the linear maplet size to the image size;

    • NUMLM sets the minimum number of maplets found in the image before the other two filters come into play.

  2. Input the value for Fractional width. Normally this is 0.5. This value allows images that overlap any part of a window that is half the size of the maplet window.

  3. (!) If you enter 0.0, the image must contain the landmark center.

  4. Typically, enter 'n' for Reject invisibles? unless the object is bizarre, such as Eros.

  5. (!) If you respond 'y', the program uses the current shape to determine whether there is topography blocking the camera's view of the landmark center.

    /!\ When landmarks are added in autoregisterP, they immediately populate the image’s SUMFILE. Further processing must be conducted if you wish to remove the image from any of the landmarks. This is different from lithos where images are not added to landmarks until the landmark file is updated.

After you respond to these initial inputs, the Main Menu will open.

autoregisterP Main Menu

 ...     MAIN MENU     ...

 0. Exit

 a. Auto remove
 n. Auto remove new only
 m. Manual remove                   <- only in interactive mode
 p. Check peripheral visibility
 o. Remove low-correlation lmks

 1. Auto align
 2. Manual align                    <- only in interactive mode

 3. Repredict px/ln
 4. Change flags
 l. Change repredict limit          <- only in interactive mode

autoregisterP is otherwise identical to autoregister. Refer to autoregister for detailed information and samples.

(Compiled by DL)