Differences between revisions 8 and 41 (spanning 33 versions)
Revision 8 as of 2015-06-08 15:41:02
Size: 1332
Comment:
Revision 41 as of 2016-01-25 13:44:11
Size: 5471
Comment:
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
= Step1 =
Set up the files for the rn
= make_scriptT =
(Compiled by DL)
Line 4: Line 4:
= Step2 =
Run and monitor
'''Purpose:''' Generates the run script and .INN files required to tile a bigmap or shape with a suite of new maplets.
Line 7: Line 6:
------ === Requires ===
Line 9: Line 8:
= Step1 =  * [[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.
Line 11: Line 13:
== Overview == NB: [[lithos]] requires a number of directories and files - refer to relevant guide.
Line 13: Line 15:
The will use XXXXXX and XXX020.SEED to generate a suite of files to tile a bigmap. === Output ===
Line 15: Line 17:
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 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]].
 * a number of information text and display files in the working directory are modified by [[lithos]]; please refer to the relevant guide for details.
Line 16: Line 30:
Output will be exact (diff) == Using make_scriptT ==
Line 18: Line 32:
There are a multitude of procedures the user should follow before running make_scriptT; please refer to the [[Basic_tiling]] 'How-To' guide.
Line 19: Line 34:
== Prep == === Create Input Files ===
Line 21: Line 36:
Copy the reference map to XXXXXX (because Bob likes it that way)
{{{
cp MAPFILES/REFMAP.MAP MAPFILES/XXXXXX.MAP
}}}

Add map name and seed to the top of the output from [[make_tilefile]], which should be named [[make_scriptT.in]]

It should look like this:
Example '''make_scriptT.in''' file (see [[make_scriptT.in]] for further details):
Line 32: Line 40:
XXX020.SEED scripts/t11-10.seed
Line 37: Line 45:
     250  50
     300  50
     350  50
     400  50
     450  50
     500  50
     550  50
     600  50
...
     9
00  950
     950 950
      50 100
     100 100
     150 100
200 100
      
50 150
     100 150
     150 150
     200 150
      50 200
     100 200
     150 200
     200 200
Line 51: Line 60:
== Run == Example '''make_scriptT.seed''' file (see [[make_scriptT.seed]] for further details):
Line 54: Line 63:
~/bin/make_scriptT 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
Line 57: Line 130:
== Output == == Run make_scriptT ==
Line 59: Line 132:
 . INN files (1 to 361)
 . rem_script.b
 . run_script.b
 . dsp_list.txt
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]].
Line 64: Line 134:
------ Example '''001.INN''' file:
Line 66: Line 136:
= Step 2 = {{{
c
a
m
XXXXXX
   50.000000000000000 50.000000000000000
0.00010,49
g
i
etc ...
}}}
Line 68: Line 148:
make_scriptT also generates the run script - '''run_script.b''':
Line 69: Line 150:
== Run == {{{
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 ...
}}}
Line 71: Line 166:
Run, just run the script to make the whole thing go (in the background) == Tile Bigmap with New Maplets ==
Line 73: Line 168:
{{{ {{{
sh run_script.b
}}}

or in the background:
{{{
Line 77: Line 177:
== Monitor ==
Track the progress with find_nofitT
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:
Line 81: Line 188:
~/bin/find_nofitT rm -f *.INN
rm -f *.OOT
rm -f run_script*
Line 83: Line 192:
If there are problems with the processing, you'll get a list of landmarks with issues
{{{
  just listed - no significant issue
  * very bad - must fix
  ! not too bad - should fix
}}}

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

CategoryPrograms

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

  • 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

make_scriptT (last edited 2016-07-24 09:58:33 by BMittan)