Training notes for JAXA session in support of MMX

Goals

Student Prep

Because class time is limited, it is important to get the software and data installed before you show up to the conference. I will be available during the conference to help troubleshoot problems and help get your system functional before the class starts Wednesday morning. Once the class starts, I won't be able to ignore everyone else in the class to fix an install.

To maximize your learning in the class, I provide some information that will be beneficial to review.

Required Tasks To Complete Before Class Starts

Extra software that is useful

Day 1

Day 1 Practical - It's all about LITHOS

The core of SPC is lithos. That tool lets you create landmarks, associate images, align images, determine the 3D position of the landmark and create topography.

Fixing landmarks, using Input landmark

Aligning landmarks, using Align landmarks

Building a landmark Create new landmark and How To Build A Landmark

Template

Topography

Once all the images are aligned (the center pixel of every image is at the exact same feature of the surface), then you can build topography using photoclinometry with some conditions. Find heights

toposcript

State

A key diagnostic tool for SPC is understanding the state of the system. By state, I mean what are the conditions (the health or quality) of the landmark. There is no one parameter that tells you all of this, but it is looking at a wide set of details that tells you if there are problems.

Align, Extra and Solve (AES) Iteration

Because SPC is an iterative process, each time the AES process is done, more data is extracted from the images and the solution moves towards a stability point.

Block 5 - Iterate v2

See Notes from day 1 -- These are things brought up in class or requested from the previous class on SPC. They are provided here because they are useful, but don't fit in another category.

Day 2

New files for today

Use branch "B-register" from GitHUB. If you are using GitHUB Desktop, it will ask to if you should bring the changes over or stash them. Select stash. If you are downloading this as a separate file (such as a .zip), then just do your work in that new directory.

Clean some of the landmarks

See toDoB in the working directory. Clean the landmarks listed at the top of the file.

"Clean" means to check the state of the landmark and fix any problems.

Bring in Images

Register

Now register the images that are listed in the toDoB.

Autoregister

autoregister takes an image and assigns landmarks to it. This is the opposite of lithos which adds images to a landmark. When you start autoregister, you give it an image name and then tell it if you want to try to add more landmarks. Most times, the answer is yes, but sometimes you want to use the abilities of autoregister without adding more landmarks -- that is done when you've eliminated some landmarks that SPC thinks is value but they are not ready to be used for that image.

* Prepare the quick lookup file LMRKLISTX.TXT

* Run autoregister

* This will take you to the main menu. You will want to removed images that fall out of parameters (emission angle, coverage, resolution limits)

* Now, you will want to check the status of the list of landmarks (review the correlation scores)

* Set the image to be used (i.e. remove the star) for all the landmarks

* Exit autoregister

Now practice autoregister the images that are listed in the toDoB.

Iterate

Now that we've pulled in extra information, we need to iterate to get the information propagated to all the files

Block 5 - Iterate v2

Build a shape model

Create a higher resolution

Block 6B - Bigmap Tiling v2

Blocks

We have provided some procedural blocks for different tasks. They include some additional log and configuration that will be different from you, but the main SPC steps are the same. Additionally, Bob has some "PROCEDURES" directory with his source code. There are instructions there and copy/paste commands.

SPC Blocks, V2

Batch Processing

Register

Autoregister

Tiling by BIGMAP

Block 6B - Bigmap Tiling v2 

  bigmap < support/BIG001.in
  cd MAPFILES
  ln -s RPI001.MAP XXXXXX.MAP
  cd ..
  echo XXXXXX | SHOWMAP
  convert XXXXXX.pgm lowMap.jpg

Checking for existing maplets

  map_coverage
  XXXXXX
  0 .0005
  convert coverage_m.pgm preCoverage.jpg

Building the make_scriptT.in file

  echo N | make_tilefile > tmp
  echo XXXXXX > support/bigmap_tile.in
  echo scripts/XXX035.seed >> support/bigmap_tile.in
  sed 1d tmp >> support/bigmap_tile.in
  ln -s support/bigmap_tile.in make_scriptT.in

Run Tiling

    make_scriptT
    sh run_script.b
    find_nofitT

Support Files

Evaluation of the bigmap

Now that it is done, you can rebuild the bigmap and see the difference 

  bigmap < support/BIG001.in
  echo BIG001 | SHOWMAP
  convert BIG001.pgm highMap.jpg

map_coverage
BIG001
0 .0005
convert coverage_m.pgm postCoverage.jpg

System Evaluation

Iterate over region

This uses the fact that you recently made a bigmap as inputs for running a region-specific iteration. Remember, duplicates takes whatever list of landmarks in LIST.TXT, sorts them, removes duplicates and replaced make_script.in. USED_MAPS.TXT is created by bigmap, along with USED_PICTS.TXT. This contains all of the mapfiles that were used in building the bigmap. 

  make_lmrklistX
  rm TESTFILES*/*
  cp USED_MAPS.TXT LIST.TXT
  duplicates
  make_scriptP > run.sh
  sh run.sh
  find_nofitP

Questions

See