Training_Notes - SPC Wiki

Goals

Main goal is to get Dr. Weirich up to speed to run Sensitivity Tests
Install SPC software for users
Specific things to learn
- Be able to create landmarks and add images
- Basic trouble shooting and fixing mis-registeration
- Perform tiling
- Do iterations
- Run residuals, geometry
Optional, depending on time and understanding
- Register images to shape model or maps
- Autoregister
Practice
- Create landmarks
- Tile landmarks
- Run Calibration test
- Try out error-injected images into the calibration test

Student Prep

Stuff to read
- Gaskell's 2008
- Palmer's basic write up
- Jackman's slides
- Get a copy of the manual
Software - Please load the following
- XCode - Apple's main compiler for OS X. It has many libraries you need. - https://developer.apple.com/xcode/
- gfortran - https://gcc.gnu.org/wiki/GFortranBinaries#MacOS
- spicelib - http://naif.jpl.nasa.gov/naif/toolkit_FORTRAN.html
- MacPorts - http://www.macports.org/install.php
- gnuplot - Installing using MacPorts, "sudo port install gnuplot"
- imagemagick Installing using MacPorts, "sudo port install ImageMagick"
- GraphicConverter -- http://www.lemkesoft.de/en/products/graphicconverter/

Stuff I need to get ready

Test Data
- Need a test case -- mostly finished object.
- Somewhere where they can tile
- Images of what the current shape model and what should look like when done
Documentation
- done - Get Jackman's notes into Wiki
- done - Get Bob's abstracts (doxygen) into the Wiki
- Get Component Test Procedures into the Wiki
done - Get room and display set up
in progress - Develop a NDA

Activities

Day 1, Tuesday
- Introductions and facilities
- NDA
- Install the software and test cases
- Introduce SPC and Bob
- Review test plan
- Review Component Test Readness Review
- Teach basics of SPC
  - Show wiki
  - Provide documentations, unix help
Day 2, Wednesday
- Basic SPC stuff
  - Make more landmarks
  - Look at Rosetta's difficulties
- Tiling
  - map_coverage
  - bigmap
  - make_tilefile
  - make_scriptT
  - find_nofitT
Day 3, Thursday
- Look at the map coverage
  - map_coverage
  - EQNOR4
  - 0 .001
- Build and view the bigmap
  - bigmap < support/BigEqN4.in
  - echo EQNOR4 | showmap
  - convert EQNOR4.pgm whatever.jpg
- Review some output files
  - find_nofitT
  - more 173.OOT
- Do a Standard_iteration (see wiki --> Work Flow)
- Show how to fill a landmark with a bigmap
- Make more landmarks (near the poles)
- Show how to "find" in lithos
Day 4, Friday
- Introduce
- Error analysis
- Run calibration
  - Do tile
  - Look at errors
    - CompareOBJ
    - Other tools

Training Skill Levels

Level 1 - Introduction to SPC and the most basic tasks with landmarks.
- Create a landmark
- Add images
- Autoremove images
- Build template
  - Select images
  - Show which ones
  - Correlate
- Align
  - Autoalign
  - Align with image
  - Align with gradients
- Topography
  - Just using defaults
Level 2 - Basic user - Basic ability to do SPC's most key functions. Can support operations under direct supervision of a fully-trained SPC user. Can run most key SPC functions, but requires help bridging gaps
- Building workspaces
  - Bigmap
  - Showmap
  - Lithos -> find
- Batch landmark generation
  - Map_coverage
  - Make_tilefile
  - Make_scriptT
  - Find_nofitT
  - Export
- Batch Run
  - Duplicates
  - Make_LMRKLISTX
  - Make_scriptP
  - Find_nofitP
- Display
Level 3 - Experienced User - Capable of doing all essential functions of SPC to process data and build shape model. Can run most of a project, but would need support for initial setup and trouble shooting
- Establishing and Verifying Connections
  - Overlaps
  - Limbs
- Build Shape
  - Densify
  - Dumber
  - CompareOBJ
  - ICQ format
- Analysis
  - Residuals
  - Geometry
  - Sigmas
- Ingesting images
  - Makesumfile.txt -- adding kernels
  - Autoregister
  - Register
  - Make_scriptR
  - Make_scriptA
- Advanced landmark techniques
  - Setting normal
  - Options for solving the height
  - Landmark resize
  - Replacing topo with map or shape
  - Troubleshooting problem landmarks
- Visualizing
  - Surface_imager
  - Imager_grid
  - Imager_MG
  - view_image_stereo/rgb
  - view_maps
  - view_shape (geometry.in)
  - shape2map
Level 4 - Expert User - Capable of executing all functions needed to run a SPC project, to include configuration, kernel management and navigation.
- Run a full project
  - Define configuration files and keywords
- Setup
  - Init_lithos
  - Make_sumfiles.txt
  - Setup SPICE
  - Spacecraft uncertanity
  - Distortion field
  - Blemishes
  - Limber/Tyler
  - Dynamics
- Coordinate frames
  - Pole
  - Omega
  - Shift
  - New_pole
- Weighting
  - LMKWTS
  - PICWTS
- Import
- Integration with navigation
Level 5 - Expert Developer. Understands the internal structure of SPC's code and file format in order to make software changes.
- Advanced troubleshooting
- Modifications to SPC code
  - Make updates to process_fits/img
  - Creating SUMFILES/NOMINALS using non-SPICE geometric data
- Error propagation

Test Prep

Test Plan
Regression Test
Check all data -- make directory
Get ready for evaluation
- Compare obj
- Easier test
Develop tracking log
Read over procedures
Teach how to build a shape (using script)
Work out tools to do evaluation