• make_scriptAP

make_scriptAP

(Compiled by DL)

Purpose: Generates the run script and .INN files required to batch autoregister new images using parallel processing.

Requires

• make_script.in - text file containing the names of the images to batch autoregister.

• make_scriptA.seed - text file containing the autoregisterP option commands for batch registering images.

• INIT_LITHOS - make_scriptAP reads the USRMX (maximum number of core processors) value.

• TESTFILES1/ - Directory in which to store copies of LMRK_DISPLAYnn.pgm (output by autoregisterP) for each image.

NB: autoregisterP requires a number of directories and files - refer to relevant guide.

Output

make_scriptAP outputs:

• run.sh - controlling run script for batch image auto registration using parallel processing.
  • run script for each core processor:
    • run_script01.b
    • run_script02.b
    • etc..
• .INN files - autoregisterP seed file for each image.
• rem_script.b - script for removal of temporary files (working directory clean-up)

run_scriptnn.b output:

• .OOT files - standard output from autoregisterP for each image.

• TESTFILES1/ - a copy of LMRK_DISPLAYnn.pgm (output by autoregisterP) is saved for each image;

• SUMFILES/ - Landmarks are added to the image's SUMFILE. Spacecraft/camera position/attitude are updated upon user acceptance of alignment shifts;

• LMKFILES/ - Image names are added to the LMKFILES.

Using make_scriptAP

Create Input Files

Example make_script.in file:

 P00045000450
 P00045000451
 P00045000452
END

NB: A space must precede each image filename.

Example make_scriptA.seed file (see make_scriptA.seed for further details):

a
0,65,.25,0,3
1
2
n
0
n
o
.5
4
b
0
q
END   

Run make_scriptAP

make_scriptAP generates a .INN file for each image (the image filename appended with the autoregisterP options contained in the make_scriptA.seed file. Example P00045000450.INN file:

nn              <-two character USR name to distinguish between processes.
P00045000450
a
0,65,.25,0,3
1
2
n
0
n
o
.5
4
b
0
q
END   

make_scriptAP also generates the run.sh script:

 chmod +x run_script01.b
 chmod +x run_script02.b
 ''etc..''

 ./run_script01.b &
 ./run_script02.b &
 ''etc...''

and the run_script01.b, run_script02.b, etc:

rm -f P00045000450.OOT
/usr/local/bin/AUTOREGISTERP < P00045000450.INN > P00045000450.OOT
cp LMRK_DISPLAY01.pgm ./TESTFILES1/P00045000450.pgm
rm -f P00045000452.OOT
/usr/local/bin/AUTOREGISTERP < P00045000451.INN > P00045000451.OOT
cp LMRK_DISPLAY01.pgm ./TESTFILES1/P00045000451.pgm

Batch Autoregister Images Using Parallel Processing

autoregisterP uses the file LMRKLISTX.TXT to pre- screen the maplets, so if maplets have been added or deleted recently, the procedure make_lmrklistX should be run.

sh run.sh

The autoregisterP standard output for each image is captured in the .OOT files, and the LMRKDISPLAYnn.pgm file output by autoregisterP is copied and stored in TESTFILES1/ once an image has been processed. The user must review the .OOT files to ascertain the success of the batch image autoregistration process. (A find-nofit program does not currently exist for batch image autoregistration.)

Clean Working Directory

rem_script.b can be used to clean out the directory of make_scriptAP working files once autoregistration is complete and user has quality checked the image correlations:

rm -f *.INN
rm -f *.OOT
rm -f run_script*

User Warnings

• The user must ensure that the correct number of core processors is set for USRMX, a variable contained in INIT_LITHOS, refer to relevant guide for further details.