SAGA-GIS Module Library Documentation (v2.1.4)

Module IMCORR - Feature Tracking

The module performs an image correlation based on two raster data sets.
Additionally, two DTMs can be given and used to optain 3D displacement vectors.

This is a SAGA implementation of the standalone IMCORR software provided by the National Snow and Ice Data Center in Boulder, Colorado / US.

The standalone software and documentation is available from:
http://nsidc.org/data/velmap/imcorr.html

References:
Scambos, T. A., Dutkiewicz, M. J., Wilson, J. C., and R. A. Bindschadler (1992): Application of image cross-correlation to the measurement of glacier velocity using satellite image data. Remote Sensing Environ., 42(3), 177-186.

Fahnestock, M. A., Scambos, T.A., and R. A. Bindschadler (1992): Semi-automated ice velocity determination from satellite imagery. Eos, 73, 493.

Parameters

 NameTypeIdentifierDescriptionConstraints
InputGrid 1Grid (input)GRID_1The first grid to correlate-
Grid 2Grid (input)GRID_2The second grid to correlate-
DTM 1 (*)Grid (optional input)DTM_1The first DTM used to assign height information to grid 1-
DTM 2 (*)Grid (optional input)DTM_2The second DTM used to assign height information to grid 2-
OutputCorrelated PointsShapes (output)CORRPOINTSCorrelated points with displacement and correlation information-
Displacement VectorShapes (output)CORRLINESDisplacement vectors between correlated points-
OptionsSearch Chip Size (Cells)ChoiceSEARCH_CHIPSIZEChip size of search chip, used to find correlating reference chipAvailable Choices:
[0] 16x16
[1] 32x32
[2] 64x64
[3] 128x128
[4] 256x256
Default: 2
Reference Chip Size (Cells)ChoiceREF_CHIPSIZEChip size of reference chip to be found in search chipAvailable Choices:
[0] 16x16
[1] 32x32
[2] 64x64
[3] 128x128
Default: 1
Grid Spacing (Map Units)Floating pointGRID_SPACINGGrid spacing used for the construction of correlated points [map units]Minimum: 0.100000
Maximum: 256.000000
Default: 10.000000
(*) optional

Command-line

Usage: saga_cmd grid_analysis 19 -GRID_1 <str> -GRID_2 <str> [-DTM_1 <str>] [-DTM_2 <str>] [-CORRPOINTS <str>] [-CORRLINES <str>] [-SEARCH_CHIPSIZE <str>] [-REF_CHIPSIZE <str>] [-GRID_SPACING <str>]
  -GRID_1:<str>         	Grid 1
	Grid (input)
  -GRID_2:<str>         	Grid 2
	Grid (input)
  -DTM_1:<str>          	DTM 1
	Grid (optional input)
  -DTM_2:<str>          	DTM 2
	Grid (optional input)
  -CORRPOINTS:<str>     	Correlated Points
	Shapes (output)
  -CORRLINES:<str>      	Displacement Vector
	Shapes (output)
  -SEARCH_CHIPSIZE:<str>	Search Chip Size (Cells)
	Choice
	Available Choices:
	[0] 16x16
	[1] 32x32
	[2] 64x64
	[3] 128x128
	[4] 256x256
	Default: 2
  -REF_CHIPSIZE:<str>   	Reference Chip Size (Cells)
	Choice
	Available Choices:
	[0] 16x16
	[1] 32x32
	[2] 64x64
	[3] 128x128
	Default: 1
  -GRID_SPACING:<str>   	Grid Spacing (Map Units)
	Floating point
	Minimum: 0.100000
	Maximum: 256.000000
	Default: 10.000000