User Tools

Site Tools


jvs:fscan:manual:chapter2:align

This is an old revision of the document!


fScan Reference Manual, Chapter 2 (CmdLineOptions): align

Align -- Auto align images by optimizing mutual information

usage: -align dataset flag ncycles nsteps nbits imin shift1 shift2 doff drot dscale

ALIGN superimposes the data set to be aligned (DATASET) onto the current data set (reference) and then adjusts the alignment data set to optimize its registration with the reference data set. If the current data set has another image data set overlaid on it, then DATASET will default to that overlay data set. Otherwise, if DATASET is omitted it is assumed to be the image data set in the previous active window.

Adjustment is done by stepping through several possible alignment settings and calculating a “mutual information” index for each step. The parameter settings that can be adjusted are Translation, Rotation, and Scaling along each of the 3 cardinal image axes (X, Y, and Z). The FLAG option can be used to control which parameters are to be adjusted.

FLAG (octal values in parenthesis – combine options by adding values):

  • 1 (1) - open and display dynamic MutualInformation window
  • 2 (2) - Coarse adjustment
  • 4 (4) - NoMove, simply calculate Mutual Information for current registration
  • 8 (010) - Adjust Offset (translation along axis)
  • 16 (020) - Adjust Rotation (around axis)
  • 32 (040) - Adjust Scaling (along axis)
  • 64 (0100) - X axis
  • 128 (0200) - Y axis
  • 256 (0400) - Z axis
  • 1024 (02000) - Use current image overlay as alignment data set (default if DATASET omitted)

Default FLAG is 0733: Adjust X,Y,Z axes for Coarse Offset and Rotation (not Scaling), displaying progress window.

For each parameter being adjusted, ALIGN tests NSTEPS values (default=5), with NSTEPS/2 values on either side of the starting value. It performs NCYCLES of adjustment (default=3) of all parameters, decreasing the step size on each cycle.

The adjustment stepsize is specified by a combination of the FLAG, NCYCLES, DOFF, DROT, and DSCALE parameters. The finest adjustment step for the last adjustment cycle is (assuming no Coarse FLAG option):

  • DOFF - translation offset step (default=0.25 mm)
  • DROT - rotation step (default=0.25 degrees)
  • DSCALE - scale step (default=1.0)

See Also:
Overlay and Alignment, Overlay

fScan Home, fScan Manual, CmdLineOptions, Manual Help

jvs/fscan/manual/chapter2/align.1357320734.txt.gz · Last modified: 2014/08/04 16:03 (external edit)