= 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_script''nn''.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.