Home
About Isis
Support
Download

Isis 3

Documentation
Tutorials
Technical Documents

Isis 2

Documentation
Tutorials
Technical Documents

Search
USGS

Isis 3 Application Documentation

autoregtemplate

Printer Friendly View | TOC | Home

Create autoregistration group template

Overview Parameters Example 1 Example 2

Description

This program creates an autoregistration group template for autoregs. Given a specific algorithm name, it will create that specific algorithm group template. If you are unsure of what algorithm name you want to use, running the application with an 'unknown' algorithm name will give you an error box containing a list of the possible algorithm names. If a tolerance is specified, the application will automatically insert the tolerance keyword and value into the autoreg template. The user must enter values for the chip sizes of both the pattern and search chips. The output templates can be used in applications that use autoregistrations, such as coreg, coregpr, findrx, etc.

Categories

Related Objects and Documents

Applications

History

Elizabeth Miller2005-09-28 Original Version
Jacob Danton2006-01-05 Added SubpixelAccuracy option.
Jacob Danton2006-05-17 Added MinimumPatternZScore option and updated appTest.
Brendan George2006-07-19 Moved MininmumPatternZScore keyword to PatternChip Group

Parameter Groups

Files

Name Description
TO Output text file containing autoreg template

Algorithm

Name Description
ALGORITHM Name of Algorithm to create autoregistration group for
TOLERANCE Tolerance Value
SAMPLING Sampling Percent Value for the Algorithm
SUBPIXELACCURACY Use sub-pixel accuracy
MINIMUMPATTERNZSCORE minimum pattern chip zscore range

PatternChip

Name Description
PSAMP Pattern Chip Sample Size
PLINE Pattern Chip Line Size
PMIN Pattern Chip Valid Minimum Pixel Value
PMAX Pattern Chip Valid Maximum Pixel Value
PPERCENT Pattern Chip Valid Pixel Percent Value

SearchChip

Name Description
SSAMP Search Chip Sample Size
SLINE Search Chip Line Size
SMIN Search Chip Minimum Valid Pixel Value
SMAX Search Chip Maximum Valid Pixel Value
SPERCENT Search Chip Valid Pixel Percent Value
SINC Sample Increment for Search Chip Density
LINC Line Increment for Search Chip Density
X

Files: TO

Description

This file will contain the autoregistration group template.

Type filename
File Mode output
Close Window
X

Algorithm: ALGORITHM

Description

This is the name of the algorithm for the autoregistration group being created. If left as unknown, an error will be reported listing all possible options for the algorithm name.

Type string
Default Unknown
Close Window
X

Algorithm: TOLERANCE

Description

This is the value of the tolerance for the autoregistration. If the user enters a value here, the Tolerance keyword will be set to that value in the template. If left blank, the keyword will be added with a value of Null.

Type double
Internal Default None
Close Window
X

Algorithm: SAMPLING

Description

Type integer
Internal Default None
Close Window
X

Algorithm: SUBPIXELACCURACY

Description

This option allows the user to specify if sub-pixel accuracy will be used in the registration.

Type boolean
Default TRUE
Close Window
X

Algorithm: MINIMUMPATTERNZSCORE

Description

This option allows the user to specify the minimum z-score range for the minimum and maximum values for the pattern chip that will be used in the registration.

Type double
Default 1.0
Close Window
X

PatternChip: PSAMP

Description

The sample size of the pattern chip for the autoregistration. The Sample keyword in the PatternChip group will be set to this value in the autoreg template.

Type integer
Close Window
X

PatternChip: PLINE

Description

The line size of the pattern chip for the autoregistration. The Line keyword in the PatternChip group will be set to this value in the autoreg template.

Type integer
Close Window
X

PatternChip: PMIN

Description

The minimum value a pixel must have in order to be considered valid and used in the autoregistration. This parameter is optional, and does not have to be set.

Type integer
Internal Default None
Close Window
X

PatternChip: PMAX

Description

The maximum value a pixel must have in order to be considered valid and used in the autoregistration. This parameter is optional, and does not have to be set.

Type integer
Internal Default None
Close Window
X

PatternChip: PPERCENT

Description

The minimum percent of pixels in the pattern chip that must be valid in order for the autoregistration of the chip to be used. This parameter is optional, and does not have to be set.

Type integer
Internal Default None
Close Window
X

SearchChip: SSAMP

Description

The sample size of the search chip for the autoregistration. The Sample keyword in the SearchChip group will be set to this value in the autoreg template.

Type integer
Close Window
X

SearchChip: SLINE

Description

The line size of the search chip for the autoregistration. The Line keyword in the SearchChip group will be set to this value in the autoreg template.

Type integer
Close Window
X

SearchChip: SMIN

Description

The minimum value a pixel must have in order to be considered valid and used in the autoregistration. This parameter is optional, and does not have to be set.

Type integer
Internal Default None
Close Window
X

SearchChip: SMAX

Description

The maximum value a pixel must have in order to be considered valid and used in the autoregistration. This parameter is optional, and does not have to be set.

Type integer
Internal Default None
Close Window
X

SearchChip: SPERCENT

Description

The minimum percent of pixels in the pattern chip that must be valid in order for the autoregistration of the chip to be used. This parameter is optional, and does not have to be set.

Type integer
Internal Default None
Close Window
X

SearchChip: SINC

Description

This is the sample increment value for the search chip. It is used for the density keyword. Defaults to 1.

Type integer
Default 1
Close Window
X

SearchChip: LINC

Description

This is the line increment value for the search chip. It is used for the density keyword. Defaults to 1.

Type integer
Default 1
Close Window

Example 1

MaximumCorrelation Autoreg Template w/ no Defaults

Description

This example shows how the autoregtemplate application works. This example only enters the required parameters. 
Object = AutoRegistration
  Group = Algorithm
    Name      = MaximumCorrelation
  End_Group

  Group = PatternChip
    Samples = 15
    Lines   = 15
  End_Group

  Group = SearchChip
    Samples = 31
    Lines   = 31
  End_Group
End_Object
End
The above output is the text file resulting when the following command line is run.

Command Line

autoregtemplate algorithm=MaximumCorrelation psamp=15 pline=15 ssamp=31 sline=31 to=out.txt
Run autoregtemplate with an algorithm name and output file name, and search and pattern chip sizes.

Example 2

MinimumCorrelation Map Template w/ all Parameters used

Description

This example shows how the autoregtemplate application works. The parameters are all enterd by the user for this example. 
 
Object = AutoRegistration
  Group = Algorithm
    Name      = MinimumDifference
    Tolerance = 0.7
    Sampling  = 50 <percent>
  End_Group

  Group = PatternChip
    Samples      = 15
    Lines        = 15
    ValidMinimum = 1200
    ValidMaximum = 2800
    ValidPercent = 75
  End_Group

  Group = SearchChip
    Samples      = 31
    Lines        = 31
    ValidMinimum = 1200
    ValidMaximum = 2800
    ValidPercent = 75
    Density      = (4,6)
  End_Group
End_Object
End
The above output is the text file resulting when the following command line is run.

Command Line

autoregtemplate algorithm=MinimumDifference tolerance=0.7 sampling=50 psamp=15 pline=15 pmin=1200 pmax=2800 ppercent=75 ssamp=31 sline=31 smin=1200 smax=2800 spercent=75 sinc=4 linc=6 to=out.txt
Run autoregtemplate with all parameters overridden by the user.