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):

XXXXXXscripts/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 200END

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

0.00010,49giay.5nx.0250abnXXXXXXn2bnXXXXXXu1v2ea0,60,.25,.25,0,3103n0y...u1oRECENTy1oRECENTn3y1, 3, 5 wiRECENTnnv1u1v4oRECENTn1qEND

2. Run make_scriptT

make_scriptT generates a .INN file for each new maplet.

Here is a sample .INN file for maplet 001 :

camXXXXXX 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.OOTcp LMRK_DISPLAY1.pgm ./TESTFILES/001.pgmcp tmpl.pgm ./TESTFILES1/001.pgmrm -f 002.OOT/usr/local/bin/LITHOS < 002.INN > 002.OOTcp LMRK_DISPLAY1.pgm ./TESTFILES/002.pgmcp tmpl.pgm ./TESTFILES1/002.pgmrm -f 003.OOT/usr/local/bin/LITHOS < 003.INN > 003.OOTcp LMRK_DISPLAY1.pgm ./TESTFILES/003.pgmcp tmpl.pgm ./TESTFILES1/003.pgmetc ...

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 *.INNrm -f *.OOTrm -f run_script*

(Compiled by DL) CategoryPrograms