= 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_DISPLAY02.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. 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.