= 1st Annual PRI Workshop on Image-Based Modeling and Navigation for Space Applications =
  June 6-8 Short Course

Welcome to the 1st Annual RPI Workshop on Image-Based Modeling and Navigation for Space Applications.  This is a persistent webpages (will continue to exists after the training) that contains the information you need to get ready and the lesson info.


== Goals ==

 * Bring the students to the "SPC Training Level 2" [[TrainingLevels]]
  * Provide enough SPC hand-on skills that basic shape models can be built
  * Provides enough background so that additional practice and instruction can occur
  * It will be insufficient to fully train new personal to a level in which they could run an entire mission without support

 * Specific things to learn
  * Be able to create landmarks and add images
  * Basic trouble shooting and fixing mis-registration
  * Perform tiling (both globally and BIGMAP)
  * Do iterations
  * Run residuals, geometry
  * Register images to shape model or maps
  * Autoregister

 * Practice.  A key component of this training is to practice.  The practice allows for key concepts to become understood at a sufficient level to allow for more advanced concepts to make sense.  




== 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.

 * Stuff to read (links below)
   * Gaskell's 2008
   * Palmer's 2016, sections 2.4 and 5

== Required Tasks To Complete Before Class Starts ==

 * Sign the Licensing Agreement.  This must be on file before the software can be distributed.  //Complete//
 * Download SPC software -- encrypted link will be sent only to class attendees
 * Compile and install SPC.  [[https://oort.psi.edu/public/1a09b8/dl/spc_v3.1B2.zip]]  (password will be sent via a separate email)
   * [[Installing SPC Instructions]] 
 * Download sample data.  The data volume is large, so it is important to do it ahead of time. Some of the files need to be expanded and moved.
   * Starting directory & SPICE (600MB):  https://oort.psi.edu/public/98a344
   * Images:
     * Approach (300MB):  https://oort.psi.edu/public/1b733b
     * Preliminary Survey (1GB):  https://oort.psi.edu/public/d0e1ec
   * Support Tools:  https://oort.psi.edu/public/67588b



== Extra software that is useful ==

 * Software - Please load the following
   * 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/
 * SPC tools - This is a suite of tools that make measuring pixel/line locations and offsets easier.  This is not required and class time won't be used for installing this.  Install instructions are coming soon
   * apache -- The is installed as default for most UNIX (and Mac) systems.
   * spc_tool javascript libraries
   * updateDisplay.sh - script to convert SPC output to a web-accessible format
   * How to install and run - [[SPC-GUI-tools]]
  
----
= Itinerary =


== Day 1 ==

 * Introductions

 *Discussion of the Wiki/User’s manual
 *Unix file layout and paths
	* executables
	* source code
	* helpers
	* scripts
	* support
	
 * SPC files
	* working
	* mapfile/landmark files
	* kernels
	* images

 * Show Theory of SPC

 * <LUNCH>

 * SPC Landmarks
	* display landmark
	* landmark management
		* create
		* delete
		* rename
	* images
		* add images
		* remove images - auto and manual
		* select useable, correlation and manual
		* adjust image position, auto, manual
	* global shift
	* build template
		* 0 0 40
		* 0 c
		* 0 1234
	* find height
		* options

 * Tile 120
	* make_scriptT.seed
	* make_scriptT
	* sh run_script.b
	* find_nofit
	* TESTFILES, TESTFILES1
	


== Day 2 ==

Let's talk about images

 * IMAGEFILES
	* format -- 16bit, 32bit
	* SPC options

 * Describe NOMINALS, SUMFILES

 * Overview of adding images
	* process_fits
	* make_sumfiles
	* make_sumfiles.txt
	* make_sumfilex.in

 * Register
	* Demo
	* Practice
	* Batch

 * Autoregister
	* Demo
	* Practice
	* Batch


 * <Lunch>

 * Iteration
	* Setup
		* cp LMRKLIST.TXT make_script.in
		* ln -s <whatever> make_scriptP.seed
		* make_scriptP > run.sh
	* Running
		* sh run.sh
	* Evaluation
		* find_nofitP

 * Tile 75
	* Setup
		* ln -s make_scriptT_75.seed make_scriptT.in
		* make_script
	* Running
		* sh run_script.b


== Day 3 ==

 * Clean up from 75cm tiling

 * SPC Technical Info - Gaskell 
	* Discussion of SPC Design
	* Technical details
	* Issues and complexities 

 * Evaluation
	* RESIDUALS, *INFO


 * <LUNCH>

 * Tiling by BIGMAP
	* Making a bigmap
	* Criteria for size, scale
	* Setup
	* Running
	* Evaluation

 * More evaluation
 * Error evaluation
 * Questions






----
= Support Files =
 * {{attachment:gaskell-2008-paper.pdf}}
 * {{attachment:Palmer-2016.pdf}}