= Block 6B - Bigmap Tiling V2 =



== Description ==
This block is used to tile the surface with high-resolution, bigmap-referenced landmarks.


== Procedure ==

=== Set Up ===
Define the following:
 * Create a bigmap that is the reference you want for the positions of the new landmarks.
 * Get the existing coverage of the bigmap for the resolution for which you are working.
 * Use [[make_tilefile]] to generate the [[make_scriptT.in]]
 * Check the [[make_scriptT.in]]. This contains the script path and the bigmap x/y positions that [[make_scriptT]] will use to make the INN files. We use a symbolic link to ensure we can have trackable versions.
 * script file - This file, defined in the top line of [[make_scriptT.in]] has the list of commands for [[make_scriptT]] will fold into the INN files for [[lithos]] to use to build the landmarks.  


=== Create a Bigmap ===
The bigmap used here created the reference for both the position of the landmarks and the initial topography.  Thus, you want the bigmap to be fresh.  Because this is highly scripted, it works best to created symbolic link from the original name to XXXXXX.MAP.

{{{
BIGMAP < lsupport/mapname.in
cd MAPFILES
relink.sh MAPNAM.MAP XXXXXX.MAP
cd ..
echo XXXXXX | SHOWMAP
convert XXXXXX.pgm lowMap.jpg
}}}


=== Run Map Coverage ===
Map coverage shows how many landmarks of a given resolution range [in km] fall within the bigmap.  Because we linked the prime bigmap to XXXXXX, we can use a default script.

{{{
map_coverage
XXXXXX
0 .001
convert coverage_m.pgm preCoverage.jpg
}}}


=== Build Tilefile ===
[[make_tilefile]] uses the [[coverage_m.pgm]] file as input to see where landmarks are needed.  This is needed for when there are bigmaps that overlap one another, which is common because bigmaps are square, but latitude lines are not.  Once you have the "tmp" file, you can build the [[make_scriptT.in]] file by hand.  We set this custom file in lsupport and make a symbolic link to [[make_scriptT.in]].

 * The first line needs to be the name of the bigmap, which in this case is XXXXXX (symbolic link)
 * The second line is a path/filename to the tiling command script.  There are default ones in the script directory, but lsupport is where you put custom versions.
{{{
  echo N | make_tilefile > tmp
  echo XXXXXX > lsupport/bigmap_tile.in
  echo scripts/XXX014.seed >> lsupport/bigmap_tile.in
  sed 1d tmp >> lsupport/bigmap_tile.in
  relink.sh lsupport/bigmap_tile.in make_scriptT.in
}}}


=== Build and Run ===
This will create a INN file for every lat/lon set in [[make_scriptT.in]].  Warning, do not use for more than 999 new landmarks.  If you do, FORTRAN will make a script of rm ****.OOT and mess things up.

{{{
  make_scriptT
  nohup sh run_script.b
}}}


=== Monitor progress ===
It takes about 5 minutes per landmark to generate.  SPC builds landmarks in the working directory, so you can use SPC tools (the web services) to see how things are progressing.  If you have to kill and restart the tiling, you need to comment out the lines in run_script.b or delete the landmarks from [[LMRKLIST.TXT]] and [[LMKFILES]].
{{{
  ls *.INN | wc
  ls *.OOT | wc
  find_nofitT       # This displays if there were any problems
}}}


=== Evaluate Progress ===
Once you are done, take a state of how things were left.  Fix the problem landmarks and keep track of the progress using notes.
{{{
  find_nofitT | tee fit   
  tileEval.sh
  grep "*" fit >> notes           
}}}


=== Finish the Block ===
Once errors have been removed, then you can finish the block.  You may choose to use iterations or residuals to identify other errors.  blockFinish will note which INN files resulted in un-generated landmarks (deleted).
{{{
  blockFinish Ap\
}}}