= How to Tile - Bigmap V0 =

== Description ==

This block tiles a bigmap with a new suite of landmarks. Bigmap and maplet parameters
are specified by the user, using the bigmap in files contained in 
/SPC_Test/F3-base/base/support/ and the [[lithos]] options contained in the seed files in /SPC_Test/F3-base/base/scripts/.

== Assumptions ==

 * You have invoked a Bourne-Again Shell (bash) on ormacsrv1.lpl.arizona.edu
 * You are a member of the group OREX\spc
 * You have set up a skeleton directory in the following format:
{{{
 /SPC_Test/F3G-Nav/
                   ORex/
                            DATA/
                   base/
                            IMAGEFILES/
                            SHAPEFILES/
                   lsupport/
                   orig/
                   results/
                   test/
}}}
 
 * You have completed the processing steps in How to Test Directory Set-Up - ORIG
 * You have set up the test sub-directory following the steps in How to Test Directory Set-Up - TEST
 * You have ingested and registered test images following the steps in:
  * How to Ingest Images - Test-Specific
  * How to ?????????
  * How to Register Images - Batch

== User inputs ==
 * '''testID''' - Name of the F3 test directory (for example, 'F3E-Limbs')
 * '''subTestID (if required)''' - Identifier for sub-test work (for example, 'F3G1')
 * '''bigmapInFileNm''' - Name of bigmap .in file located in /SPC_Test/F3-base/base/support/ (for example, 'TILE20')
 * '''tilingSeedFileNm''' - Name of tiling seeed file located in /SPC_Test/F3-base/base/scrits/ (for example, 'XXX020')
 * '''gSD''' - Maplet Ground Sample Distance in km (for example, '0.0002')
 * '''blockID''' - User-specified identifier for typescript textfile name (for example, 'Block-05-01-Tile-Bigmap-F3G1-20cmTiling')

== Procedure ==

=== 1. Initial Inputs ===

{{{
# User inputs:
testID=F3G-Nav
#subTestID=F3G1
#subTestID=F3G2
#subTestID=F3G3
#subTestID=F3G4
#subTestID=F3G5
#subTestID=F3G6
subTestID=F3G7
#export bigmapInFileNm=TILE20
#export bigmapInFileNm=TILE10
export bigmapInFileNm=TILE05
#export tilingSeedFileNm=XXX020
#export tilingSeedFileNm=XXX010
export tilingSeedFileNm=XXX005
#export gSD=0.0002
#export gSD=0.0001
export gSD=0.00005
blockID=Block-05-01-Tile-Bigmap-${subTestID}-${bigmapInFileNm}
}}}

=== 2. Set-up ===
{{{
# Set-Up
cd /SPC_Test/$testID/test/
script
date
pwd
ls -l
}}}

=== 3. Make tiling bigmap ===
{{{
# Make tiling bigmap
echo "Bigmap .in file: support/${bigmapInFileNm}.in"
cat support/${bigmapInFileNm}.in
ls -l /usr/local/bin/bigmap
bigmap < support/${bigmapInFileNm}.in | tee log-${bigmapInFileNm}
}}}

=== 4. Check resulting file ===

{{{

# check resulting file
## Tiling bigmap has the same name as the .in file, 
## i.e. TILE20.in, produces the tiling bigmap: TILE20
echo ${bigmapInFileNm} | showmap
convert ${bigmapInFileNm}.pgm ${bigmapInFileNm}.jpg
open ${bigmapInFileNm}.jpg
}}}

=== 5. Setup tiling ===
{{{
# Set up tiling
cp MAPFILES/${bigmapInFileNm}.MAP MAPFILES/XXXXXX.MAP
ls -l /usr/local/bin/map_coverage
echo "XXXXXX" > map_coverage.in
echo 0 >> map_coverage.in
echo $gSD >> map_coverage.in
map_coverage < map_coverage.in
convert coverage_m.pgm coverage_m-${bigmapInFileNm}-beforeTiling.jpg
open coverage_m-${bigmapInFileNm}-beforeTiling.jpg
echo "N" | make_tilefile | tee make_tilefile.out
sed 1d make_tilefile.out > temp.out
echo "XXXXXX" > make_scriptT.in
echo "scripts/${tilingSeedFileNm}.seed" >> make_scriptT.in
cat temp.out >> make_scriptT.in 
cat make_scriptT.in
make_scriptT
ls -l
}}}

=== 6. Invoke tiling script ===

# Invoke tiling script
cat INIT_LITHOS.TXT
lithos -v
nohup sh run_script.b &

=== 7. Monitor progress ===
{{{
# Monitor progress
ls -l *.INN *.OOT
find_nofitT
sh support/logEvalP.sh
}}}

=== 8. Check correlation results ===
{{{
# Check results - correlation
find_nofitT | tee log-fitT-${bigmapInFileNm}
sh support/logEvalP.sh
cat logResults.txt 
cat lowImg.txt
cat redo.txt
}}}

=== 9. Fix uncorrelated images ===

{{{
# Fix uncorrelated images
.........
}}}

=== 10. Check tiling results ===
{{{
# Check results - tiling
map_coverage < map_coverage.in
convert coverage_m.pgm coverage_m-${bigmapInFileNm}-afterTiling.jpg
open coverage_m-${bigmapInFileNm}-afterTiling.jpg
}}}

=== 11. Fix tiling gaps ===
{{{
# Fix tiling gaps
.........
}}}

=== 12. Clean directory ===
{{{
# Clean directory
sh rem_script.b
rm TESTFILES/*
rm TESTFILES1/*
}}}

=== 13. Complete procedure ===

{{{
# Block Complete
exit
# Save block log
if [ ! -d /SPC_Test/$testID/log ]; then
  mkdir /SPC_Test/$testID/log
fi
mv typescript /SPC_Test/$testID/log/log-typescript-${blockID}
}}}

----------

''(Compiled by DL)''

CategoryHowTos