This program is used to register existing maplets with imaging data from a single image.

The autoregister program

The autoregister program 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. The program uses the file LMRKLISTX.TXT to prescreen the maplets. /!\ If maplets have been added or deleted recently, the procedure make_lmrklistX should be run.

autoregister is similar to register, but it can handle 3 degrees of freedom, orientation, and twist.

Required Files

Optional Files

Output Files

User Warnings

Using autoregister

Initial Inputs

 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 the image name that is stored in IMAGEFILES. Some versions of process_fits will make some changes to the filename, so it may not be the "original name".

The program produces a list of existing landmarks, if any, creates the TEMPFILE.pgm and displays the kb, and kk values. ( {i} kb and kk are de-bugging flags relating to the generation of TEMPFILE.pgm and are not discussed here.)

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

3. Input the value for Fractional width. Normally=0.5. This value allows images that overlap any part of a window that is half the size of the maplet window. If you enter 0.0, the image must contain the landmark center.

4. Answer Reject invisibles? Unless the object is bizarre, such as Eros, choose 'n'. 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.

IMPORTANT: When maplets are added in AUTOREGISTER, they immediately populate the SUMFILE. The remaining processing must be carried out to eliminate unwanted ones. This is different from LITHOS where added images do not stay added until the landmark file is updated.

After you respond to these initial inputs, the main menu will open.

autoregister Main Menu

 ...     MAIN MENU     ...

 0. Exit

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

 1. Auto align
 2. Manual align

 3. Repredict px/ln
 4. Change flags
 l. Change repredict limit

Enter0:to exit the processing of the current image and choose a new one. Enter q for the image name to quit the process altogether.


The first block of options remove landmarks according to a variety of filters. If you choose a, n, m or p, you will see a table with these column headers:

Options a and n remove landmarks according to one of these filters:

Option m allows the user to remove landmarks manually.

Option p removes images in which part of the maplet is obscured by another part of the body.

Option o eliminates images whose correlation with the illuminated maplet is less than a specified value. Option 1 must be run first to establish those correlation values.


This block of options aligns extracted imaging data with the corresponding illuminated maplets. The EXTRACT_DATA subroutines populate the landmark displays with image data projected onto the current maplet surface. We assume the maplet surfaces are correctly placed and oriented and have the correct topography. If the spacecraft position and camera pointing were correct at the image exposure time, then all maplets would align. If not all the maplets align, then the amount of misalignment can be used to correct the spacecraft state. This process performs the alignment, updating the pixel/line image-space landmark positions from their predicted values.

All windows in AUTOREGISTER are 99x99 pixels. If a maplet has QSZ < 49, as sometimes happens very early in the SPC process, then there will be dark space surrounding it. If QSZ > 49, then only the central portion of the maplet will be aligned.

Option 1. Auto align requires the user to enter several sub-options. Here is a sample:

    1   EE0001
    2   EE0002
    3   EE0003
    4   EE0004
    5   EE0005
    6   EE0006
    7   EE0007
    8   EE0008
    9   EE0009
   10   EE0010
   11   EE0011
   12   EE0012
   13   EE0013
   14   EE0014
   15   EE0015
   16   EE0016

 enter spacing
   1   EE0001        0.008     0.153     0.955 +++++
   2   EE0002        0.023     0.152     0.956 +++++
   3   EE0003        0.058     0.062     0.961 +++++
   4   EE0004        0.185    -0.056     0.960 +++++
   5   EE0005        0.006     0.029     0.967 +++++
   6   EE0006        0.002     0.009     0.966 +++++
   7   EE0007        0.043    -0.030     0.963 +++++
   8   EE0008        0.109    -0.038     0.963 +++++
   9   EE0009       -0.031     0.047     0.971 +++++
  10   EE0010       -0.021     0.014     0.969 +++++
  11   EE0011       -0.008    -0.048     0.958 +++++
  12   EE0012        0.069    -0.109     0.943 +++++
  13   EE0013       -0.352    -0.027     0.927 +++++
  14   EE0014       -0.175    -0.039     0.914 +++++
  15   EE0015        0.073    -0.058     0.913 +++++
  16   EE0016        0.371    -0.119     0.859 +++++
     0.147     0.076

 new spacing? (y/n)

 0.  continue.
 1.  halve shifts.
 2.  quarter shifts.

 update landmark pixel locations? (y/n)

Enter Spacing asks for the size of the search area for the correlation. Enter '1' to search a 5x5 pixel area, '2' for 10x10 and so on.

After a correlation, the process will ask if you want to use a new spacing? Enter 'y' and the new spacing. When you are satisfied with the correlation, enter 'n'.

0. continue will shift all the maplets by the amount determined by the correlation.

1. halve shifts will shift all the maplets by half the amount determined by the correlation.

2. quarter shifts will shift all the maplets by a quarter the amount determined by the correlation..

For update landmark pixel locations? enter 'y' if you want to accept the shift. If you enter 'n' the program returns the parameters to the starting values. For the larger search area, the data is binned. After alignment is reached, you should always go back and run it again with a spacing of 1.

Here is a typical set of keystrokes in a script for Option 1. Auto align:

 1  <- auto align
 3  <- spacing 3
 n  <- no spacing change
 0  <- shift by full amount
 y  <- keep shift
 1  <- auto align
 1  <- spacing 1
 n  <- no spacing change
 0  <- shift by full amount
 y  <- keep shift

Option 2. Manual align can be used to align the problem image data to a maplet by hand by referencing LMRK_DISPLAY1.pgm. The process asks the user to move the image window in pixels (+ right) and lines (+ down) in order to align it to the maplet. Option 2 is only used occasionally.


Enter one of these 3 options:

Use Option 3 to repredict the image-space landmark locations for all maplets. Because the maplets have different resolutions, some may correlate well and some not at all. AUTOREGISTER only uses correlations greater than CORLIM, nominally set to 0.5, to determine the s/c state. After you have used Option 3, subsequent correlations calculated using Option 1 will be much better.

Use Option l to choose a different value for CORLIM.

Use Option 4 to adjust the topo flags on the PICNM entry of each landmark (.LMK) file. When AUTOREGISTER adds new landmarks, it does so with an * on the PICNM record, indicating that that image is not to be used for topography.

Here is a sample showing Option 4.

    1      EE0001     0.955     0   *
    2      EE0002     0.956     0   *
    3      EE0003     0.961     0   *
    4      EE0004     0.960     0   *
    5      EE0005     0.967     0   *
    6      EE0006     0.966     0   *
    7      EE0007     0.963     0   *
    8      EE0008     0.963     0   *
    9      EE0009     0.971     0   *
   10      EE0010     0.969     0   *
   11      EE0011     0.958     0   *
   12      EE0012     0.943     0   *
   13      EE0013     0.927     0   *
   14      EE0014     0.914     0   *
   15      EE0015     0.913     0   *
   16      EE0016     0.859     0   *

 Input number to change (a chg all, b use all, 0 to end).

There are three sub-options to option 4, but the one usually used is 'b'. It removes the * from the PICNM record for all landmarks.

Batch Processing

AUTOREGISTER can be run in a batch mode, following a script set up by make_scriptA. This is rarely done. Usually, the parallel process autoregisterP and its script maker make_scriptAP fulfills this role.





(Compiled by DL)