Small Footprint Processing

Summary

In order to avoid overwriting files, we create separate directories for each batch tiling job that we do. However, with the landmarks and mapfiles growing so much (50,000 files each), it is becoming unwieldily.

File Structure

There are two directories that are needed for this system to work.

1. run-master. This directory contains a full set of what is needed to do all SPC tasks (either actual or symbolic links). Basically, I will make symbolic links to the ~/Dropbox/Dawn-shape/Vesta directory for images, seed files, etc. Then for items that get changed, such as landmarks and mapfiles, I have my own copy. I use an rsync script, ["update.sh"] to keep my copy of these files up to date which what is in the Dropbox.

• There are two tasks that we use this directory for. Both of these functions are executed within the script ["setupRun.sh"]
• Generation of the big map. We use the command ["bigmap.e"] to figure out which files need to be copied into a working directory that are required for tiling. It is important to do this is its own directory, otherwise, you'd be changing stuff within Dropbox itself, which effects everyone else. b. A source for the required landmarks and mapfiles. Once a bigmap is created, then I take the USED_MAPS.TXT and copy it to LMRKLIST1.TXT. Then I use ["export.e"] to create a tar ball of (almost) all the files that I need do the tiling. The script ["setupRun.sh"] will copy this tar ball into a directory.

2. run - This is the working directory that will actually do the processing. I like to number them run1, run2, run3, etc.

• This directory is much smaller (about 300 MB - mostly because it keeps its own copies of SUMFILES and NOMINALS). I use the ["setup.sh"] script to build the symbolic links needed to "static" resources (images, seedfiles, shapefile, blemishes, etc.

Running things

There are two major things that are needed to be done. First, setup the file structure, which is done only once (tasks 1, 2 and 3). Second, setup and run a tiling operation for a big map, something that is done numerous times (tasks 4, 5 and 6)

Tasks

1. Setup the run-master directory. The run-master has everything in it that you need to do almost everything (tiling, coverage, bigmaps, shape, etc.) I assume that you have a directory structure with a work directory for your files.

• Example

   cd ~/Work
   cp ~/Dropbox/Dawn-shape/scripts-limited-copy/update.sh .
   mkdir ~/Work/run-master

2. Change the paths the ["setupRun.sh"]script file. You should have your own copy of this file somewhere on your filesystem (pick where ever you want this file - only one copy is needed)

• Example

   cp ~/Dropbox/Dawn-shape/script-limited-copy/setupRun.sh ~/Work/            <- or wherever you are putting things
   vi ~/Work/setupRun.sh
  
    ...
    dropPath=~/Dropbox/Dawn-shape              # path to dropbox - 
    localMain=/User/epalmer/Work/run-master    # path to master directory
    ...
    left=50     # Makescript left boundaries
    right=950   # Makescript right boundaries
    top=200     # Makescript top boundaries
    bottom=800  # Makescript bottom boundaries
    ...

3. Change the left, right, top and bottom to set the boundaries for the ["make_scriptT.in"] file. The default for a empty region (no previous overlap) would be left and top = 50, and right and bottom = 950. If there is overlap, you can change those value to limit the generation of landmarks (such as left=200, right=800).

4. Create a working (or run) directory.

Basically, you need a directory similar to ~/Dropbox/Dawn-shape/work_generic, but without the landmarks and mapfiles. You can create it from scratch by taking a blank directory and running the ["setup.sh"] script. Everything else should be generated by the ["setupRun.sh"] script.

• Example

   mkdir ~/Work/run3
   cd ~/Work/run3
   ~/Work/setup.sh            <- or wherever you put this file - you may need to change the path in this file.

4. In the working directory, run the ["setupRun.sh"]. You must be in the working directory because it will copy everything into that one. Note - their are path variables at the top of the file incase you want a different path for your Dropbox or the run-master directory.

• Example

   cd ~/Work/run3
   ~/Work/setupRun.sh

5. ["setupRun.sh"] will figure out which maps are needed, copy them and setup everything (hopefully) you need to do a tile sequence. It uses ["bigmap.e"], so it takes about 5 minutes to run.

6. Run the generated script, ["run_script.b"] which was also created by ["make_scriptT.e"].

• Example

   ./run_script &

7. Watch things run. You can use ["find_nofitT.e"] to see the progress