= make_scriptT =
(Compiled by DL)

'''Purpose:''' Generates the run script and .INN files required to tile a bigmap or shape with a suite of new maplets.

=== Requires ===

 * [[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. 
 * [[make_scriptT.seed]] - text file containing the [[lithos]] option commands for generating each maplet.
 * [[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.

NB: [[lithos]] requires a number of directories and files - refer to relevant guide.

=== Output ===

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.
 * [[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 and the "v 4" 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]].
 * a number of information text and display files in the working directory are modified by [[lithos]]; please refer to the relevant guide for details.

== Using make_scriptT ==

There are a multitude of procedures the user should follow before running make_scriptT; please refer to the [[Basic_tiling]] 'How-To' guide.

=== Create Input Files ===

Example '''make_scriptT.in''' file (see [[make_scriptT.in]] for further details):

{{{
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
}}}

Example '''make_scriptT.seed''' file (see [[make_scriptT.seed]] for further details):

{{{
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                        
}}}

== Run make_scriptT ==

make_scriptT generates a .INN file for each new maplet. The first five lines of the .INN file (see below) 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, for example 'EE0001'. The bigmap is referred to via a temporary file, named XXXXXX. The user must copy the current bigmap to MAPFILES/XXXXXX.MAP. The remainder of the .INN file comprises a copy of the [[lithos]] commands contained in [[make_scriptT.seed]].

Example '''001.INN''' file:

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

make_scriptT also generates the run script - '''run_script.b''':

{{{
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 ...
}}}

== Tile Bigmap with New Maplets ==

{{{
sh run_script.b
}}}

or in the background: 
{{{
nohup sh run_script.b &
}}}

The [[lithos]] standard output for each image is captured in the .OOT files, and 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.

== Quality Check New Maplets ==

The user must review the .OOT files to ascertain the success of the tiling process, problem landmarks can be detected using the utility program [[find_nofitT]], refer to the relevant guide for further details.

== Clean Working Directory ==

rem_script.b can be used to clean out the directory of make_scriptT working files once tiling is complete and user has quality checked the resulting suite of maplets:

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

== User Warnings ==
 * The user must copy the current bigmap to MAPFILES/XXXXXX.MAP, the temporary file which the run scripts refer to throughout.

CategoryPrograms