Differences between revisions 14 and 28 (spanning 14 versions)

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

-  ⇤ ← Revision 14 as of 2016-01-14 13:16:19 → 
  Size: 2618
  Editor: DianeLambert
  Comment:
+   ← Revision 28 as of 2016-07-26 09:32:25 → ⇥
  Size: 3458
  Editor: BMittan
  Comment:
-Deletions are marked like this.
+Additions are marked like this.
 Line 3:
-'''Purpose:''' Generates the run script and .INN files required to batch register new images.
+||Category B||Version 3.0||
 Line 5:
-=== Requires ===
+== Description ==
 Line 7:
- * make_script.in - text file containing the names of the images to batch register. 
 * [[make_scriptR.seed]] - text file containing the register option commands for batch registering images.
+This program generates the run script and .INN files required to batch register new images.
-Line 10:
+Line 9:
-=== Output ===
+=== 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.
-Line 12:
+Line 17:
-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.
 * NOMINALS - if the seed file includes the option to update the NOMINAL file, starting S/C and camera information will be updated (an option not typically selected);
 * SUMFILES - S/C and camera information are updated as image shifts are made. ??Detected landmarks and limbs are added to the SUMFILE??;
+ /!\ '''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.
-Line 22:
+Line 33:
-=== Create Input Files ===
+=== 1. Create Input Files ===
-Line 24:
+Line 35:
-Example '''make_script.in''' file:
+Here is a sample [[make_script.in]] file (see that entry for further information):
-Line 27:
+Line 38:
- P3T11S2H0409.DAT
 P3T11S2H0410.DAT
 P3T11S2H0411.DAT
+ P3T11S2H0409
 P3T11S2H0410
 P3T11S2H0411
-Line 33:
+Line 44:
-NB: A space must precede each image filename.
+ /!\ You must precede each image filename with a space.
-Line 35:
+Line 46:
-Example '''make_scriptR.seed''' file (see [[make_scriptR.seed]] for further details):
+Here is a sample [[make_scriptR.seed]] file (see that entry for further information):
-Line 55:
+Line 66:
-== Run make_scriptR ==
+=== 2. Run make_scriptR ===
-Line 57:
+Line 68:
-make_scriptR generates a .INN file for each image (the image filename appended with the register options contained in the make_scriptR.seed file. Example '''P3T11S2H0409.INN''' file:
+'''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''':
-Line 78:
+Line 91:
-make_scriptR also generates the run script - '''run_script.b''':
+'''make_scriptR''' also generates the '''run_script.b''' script, which looks like this:
-Line 92:
+Line 105:
-== Batch Register Images ==
+=== 3. Batch Register Images ===

Here is a sample command line for running '''run_script.b''':
-Line 98:
+Line 113:
-The register standard output for each image is captured in .OOT files. The user must review the .OOT files to ascertain the success of the batch image registration process. (A ''find-nofit'' program does not currently exist for batch image registration.)
+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