= make_scriptR =

||Category B||Version 3.0||

== Description ==

This program generates the run script and .INN files required to batch register new images.

=== Required Files ===
'''input file''':
 * [[make_script.in]] - Text file containing the names of the images to batch register. 
'''seed file''':
 * [[make_scriptR.seed]] - Text file containing the register option commands for batch registering images.
'''processed files''':
 * [[TESTFILES]]/ - Directory in which to store copies of LMRK_DISPLAY.pgm (output by [[register]]) for each image.

 /!\ '''register''' requires a number of directories and files. Refer to [[register]] for more information.

=== Output Files ===

'''make_scriptR outputs''':
 * run_script.b - Run script for batch image registration.
 * .INN files - [[register]] seed file for each image.
'''run_script.b output''':
 * .OOT files - Standard output from [[register]] for each image.
'''processed files outputs''':
 * [[TESTFILES]]/ - A copy of LMRK_DISPLAY.pgm (output by [[register]]) is saved for each image.
 * [[NOMINALS]]/ - If the seed file includes the option to update the NOMINAL file, starting S/C and camera information will be updated. (This option is not typically selected).
 * [[SUMFILES]]/ - S/C and camera information are updated as image shifts are made.

== Using make_scriptR ==

=== 1. Create Input Files ===

Here is a sample [[make_script.in]] file (see that entry for further information):

{{{
 P3T11S2H0409
 P3T11S2H0410
 P3T11S2H0411
END
}}}

 /!\ You must precede each image filename with a space.

Here is a sample [[make_scriptR.seed]] file (see that entry for further information):

{{{
s
20
3
y
XSTOP
1
10
3
y
XSTOP
0
y
n
n
q
}}}

=== 2. Run make_scriptR ===

'''make_scriptR''' generates a .INN file for each image. It consists of the image filename followed by the register options contained in the [[make_scriptR.seed]] file. 

Here is a sample .INN file for image '''P3T11S2H0409.INN''':

{{{
P3T11S2H0409
s                   
20                  
3                   
y                   
XSTOP               
1                   
10                  
3                   
y                   
XSTOP               
0                   
y                   
n                   
n                   
q                   
}}}

'''make_scriptR''' also generates the '''run_script.b''' script, which looks like this:

{{{
rm -f P3T11S2H0409.OOT
/usr/local/bin/REGISTER < P3T11S2H0409.INN > P3T11S2H0409.OOT
cp TEMPFILE.pgm ./TESTFILES/P3T11S2H0409.pgm
rm -f P3T11S2H0410.OOT
/usr/local/bin/REGISTER < P3T11S2H0410.INN > P3T11S2H0410.OOT
cp TEMPFILE.pgm ./TESTFILES/P3T11S2H0410.pgm
rm -f P3T11S2H0411.OOT
/usr/local/bin/REGISTER < P3T11S2H0411.INN > P3T11S2H0411.OOT
cp TEMPFILE.pgm ./TESTFILES/P3T11S2H0411.pgm
}}}

=== 3. Batch Register Images ===

Here is a sample command line for running '''run_script.b''':

{{{
sh run_script.b
}}}

The [[register]] standard output for each image is captured in the .OOT files. The LMRKDISPLAY.pgm file output by [[register]] is copied and stored in [[TESTFILES]]/ once an image has been processed. You must review the .OOT files to ascertain the success of the batch image registration process. 

 (!) There is currently no '''find-nofit''' program for batch image registration.

----------

(Compiled by DL)

CategoryPrograms