= make_scriptT =

||Category B||Version 3.0||

== Description ==

This program generates the run script and .INN files required to tile a bigmap or shape with a suite of new maplets.

=== Required Files ===

'''input file''':
 * [[make_scriptT.in]] - text file containing references to the bigmap and make_scriptT.seed file, and the bigmap pixel/line locations for the centers of each new maplet. 
'''seed file''': 
 * [[make_scriptT.seed]] - text file containing the [[lithos]] option commands for generating each maplet.
'''processed file''': 
 * [[TESTFILES]]/ - Directory in which to store copies of LMRK_DISPLAY1.pgm (output by [[lithos]]) for each landmark.
 * [[TESTFILES1]]/ - Directory in which to store copies of tmpl.pgm (output by [[lithos]]) for each landmark.

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

=== Output Files ===

'''make_scriptT outputs''':
 * run_script.b - Run script for maplet creation.
 * .INN files - [[lithos]] seed file for each new maplet.
 * rem_script.b - Run script to clean out the directory of make_scriptT working files once tiling is complete and user has quality checked the resulting suite of maplets.
'''run_script.b output''':
 * .OOT files - Standard output from lithos for each new maplet.
'''PROCESSED FILES OUTPUTS''':
 * [[TESTFILES]]/ - A copy of LMRK_DISPLAY1.pgm (output by [[lithos]]) is saved for each landmark.
 * [[TESTFILES1]]/ - A copy of tmpl.pgm (output by [[lithos]]) is saved for each landmark.
 * [[SUMFILES]]/ - S/C and camera information are updated by [[lithos]] as image shifts are accepted because the "v 4" command in [[lithos]] is used. New landmarks and limb fits are added to the SUMFILEs.
 * [[LMKFILES]]/ - LMKFILES for each new maplet are created and populated by [[lithos]].
 * [[MAPFILES]]/ - MAPFILES for each new maplet are created and populated by [[lithos]].

 /!\ Several information text and display files in the working directory are modified by [[lithos]]. Refer to the entries for those files for more information.


== User Warnings ==
 {X} '''''YOU MUST FOLLOW SEVERAL PROCEDURES BEFORE RUNNING make_scriptT. Refer to the 'How-To': [[Basic_tiling]]'''''

 /!\ You must copy the current bigmap to MAPFILES/XXXXXX.MAP, the temporary file used by the run scripts.

== Using make_scriptT ==

{X} '''YOU MUST FOLLOW SEVERAL PROCEDURES BEFORE RUNNING make_scriptT'''. Refer to the 'How-To': [[Basic_tiling]]




=== 1. Create Input Files ===

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

{{{
XXXXXX
scripts/t11-10.seed
      50   50
     100   50
     150   50
     200   50
      50  100
     100  100
     150  100
     200  100
      50  150
     100  150
     150  150
     200  150
      50  200
     100  200
     150  200
     200  200
END
}}}

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

{{{
0.00010,49
g
i
a
y
.5
n
x
.025
0
a
b
n
XXXXXX
n
2
b
n
XXXXXX
u
1
v
2
e
a
0,60,.25,.25,0,3
1
0
3
n
0
y

...

u
1
o
RECENT
y
1
o
RECENT
n
3
y
1, 3, 5 w
i
RECENT
n
n
v
1
u
1
v
4
o
RECENT
n
1
q
END                        
}}}

=== 2. Run make_scriptT ===

'''make_scriptT''' generates a .INN file for each new maplet. 

Here is a sample .INN file for maplet '''001''':

{{{
c
a
m
XXXXXX
   50.000000000000000        50.000000000000000     
0.00010,49                                                                      
g                                                                               
i                                                                               
etc ...
}}}

The first five lines of the .INN file create a new landmark in [[lithos]], with a center at the correct bigmap pixel/line location or shape model lat/wlon location. The landmark, initially monikered 'a', is auto-renamed by [[lithos]] (option g) depending on its global lat/long region (e.g., 'EE0001'). The program refers to the bigmap using a temporary file named XXXXXX. 

 /!\ You must copy the current bigmap to MAPFILES/XXXXXX.MAP, the temporary file used by the run scripts.

The remainder of the .INN file includes a copy of the [[lithos]] commands contained in [[make_scriptT.seed]].

'''make_scriptT''' also generates the '''run_script.b''' file, which looks like this:

{{{
rm -f 001.OOT
/usr/local/bin/LITHOS < 001.INN > 001.OOT
cp LMRK_DISPLAY1.pgm ./TESTFILES/001.pgm
cp tmpl.pgm ./TESTFILES1/001.pgm
rm -f 002.OOT
/usr/local/bin/LITHOS < 002.INN > 002.OOT
cp LMRK_DISPLAY1.pgm ./TESTFILES/002.pgm
cp tmpl.pgm ./TESTFILES1/002.pgm
rm -f 003.OOT
/usr/local/bin/LITHOS < 003.INN > 003.OOT
cp LMRK_DISPLAY1.pgm ./TESTFILES/003.pgm
cp tmpl.pgm ./TESTFILES1/003.pgm
etc ...
}}}

=== 3. Tile Bigmap with New Maplets ===

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

You can also run this in the background using this command line: 
{{{
nohup sh run_script.b &
}}}

The [[lithos]] standard output for each image is captured in the .OOT files. The LMRKDISPLAY1.pgm and tmpl.pgm files output by [[lithos]] are copied once a landmark has been processed. These are stored under the landmark's name in [[TESTFILES]]/ and [[TESTFILES1]]/ respectively.

=== 4. Quality Check New Maplets ===

You must review the .OOT files to ascertain the success of the tiling process. You can detect problem landmarks using [[find_nofitT]]. Refer to that entry for more information.

=== 5. Clean Working Directory ===

You can use [[rem_script.b]] to clean out the directory of '''make_scriptT''' working files once tiling is complete and you have quality checked the resulting maplets.

Here is a sample [[rem_script.b]] file:

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

-----------

''(Compiled by DL)''
CategoryPrograms