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

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.
 * [[SUMFILES]]/ - S/C and camera information are updated by [[lithos]] as image shifts are accepted. New landmarks and limb fits are added to the SUMFILEs;
 * [[LMKFILES]]/ - LMKFILES for each new maplet are created and populated by [[lithos]].
 * [[SUMFILES]]/ - 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.

== 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
1
0
1
n
0
y
0
c
.5
0
0
40
1
0
3
n
0
y
1
0
1
n
0
y
e
o
.5
0
a
u
1
0
0
40
2
8
2
.01
1
4
1, 2.5, 3  
6
y
y
0
.025
30
0
u
1
v
1
1
0
1
n
0
y
u
1
0
0
40
1
0
2
n
0
y
1
0
1
n
0
y
e
o
.5
u
1
0
0
40
2
8
2
.01
1
4
1, 2.5, 3  
6
y
y
0
.025
30
0
u
1
v
1
1
0
1
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 bibmap to MAPFILES/XXXXXX.MAP.

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. 

== Quality Check New Maplets ==

The user must review the .OOT files to ascertain the success of the batch image registration process, problem landmarks can be detected using the utility program [[find_nofitT]].

== 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*
}}}



CategoryPrograms