TJ's Digital Image Application Set Files

This folder contains the latest modified runnable versions of Voyager and 
imgcore. They are not intended to be reliable versions, and require some
guidance to run properly.

Voyager / Snake / Parametric

	Instructions:
	
	* Load (NOT Open!) a 32-bit float single channel image from the File menu.
	  (This should be a gradient magnitude image)
	  
	  + A sample 256x178 pixel gradient magnitude image is uploaded "gm.tif".
	  
	* Drag this image from the list view onto "Src Img" label of the Parametric
	  tab. Any old image WILL NOT DO! (Sorry for shouting :-).) It must be a
	  gradient magnitude image where the contour to which the snake should be 
	  attracted should be typified by points of high values.
	  
	* Either: Load a set of contour control points from file for the "Initial C
	  ontour,
	  
	  + A sample 32-point sample curve is uploaded as "p-in.asc".
	  
	  Or: "Click the "Overlay / Edit" button to open a display window. Click 4
	  inital points and a cubic curve will be drawn connecting them together.
	  Continue clicking to add points to this curve. Right-clicking causes it
	  to be drawn as a closed loop.
	  
	* Set "Tension", "Stiffness", and optionally "Pressure" values.
	* Select some modes for the algorithm, specifying the form of internal and
	  external forces.
	* The "Play" button becomes enabled when a source image and an initial contour
	  are specified.
	  
	Limitations:
	
	* Parameter values are tricky to guess (no surprises here.)
	* Several more that you might skid on as you progress...

Voyager / Snake / Minimax

	Instructions:
	
	* Load (NOT Open!) TWO 32-bit float single channel images from the File menu.
	  (These should be x- and y- gradient images respectively, but must be two 
      distinct images)
	  
	  + Two sample 256x178 pixel x- and y- gradient images are available as 
      "xg.tif" and "yg.tif".
	  
	* Drag these images from the list view onto the two "Src Img" labela of the 
      Snake / Minimax tab.
	  
	* Either: Load a set of contour control points from file for the "Initial C
	  ontour,
	  
	  + A sample 32-point sample curve is uploaded as "p-in.asc".
	  
	  Or: "Click the "Overlay / Edit" button to open a display window. Click 4
	  inital points and a cubic curve will be drawn connecting them together.
	  Continue clicking to add points to this curve. Right-clicking causes it
	  to be drawn as a closed loop.
	  
	* There are NO parameters to set (whoopee!). There is however, a normalisation
      step that can be adjusted: Choose between None, Max only and Min_and_Max.
      Basically, everything is meant to be scaled between [0..1].
	* Select some modes for the algorithm, specifying the form of external forces.
	* The "Play" button becomes enabled when a source image and an initial contour
	  are specified.
	  
	Limitations:
	
    I can't think of any -- it performs as well as any parametric snake that just
    works on gradient.

	Have fun.
	
--------------
TDJ 2012.02.06