autoregtemplate

This program creates an autoregistration group template for applications such as "coreg", "pointreg", "qnet", "findrx", and other ISIS software with a pattern matching component. 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.

It is highly recommended that users review the Pattern Matching document (in the "Related Objects and Documents" section).

NOTE: This program lacks updates for the Gruen pattern matching algorithm. In the future this program will be depricated and replaced with a wizard (expert system) which will help guide the user in the selection of the appropriate algorithm and parameter values.

This example shows how the autoregtemplate application works, and how to create a simple AutoReg template. Here, only the required parameters have been entered. Because SubpixelAccuracy is "true" by default, there is a SurfaceModel group in the output PVL containing the default DistanceTolerance and WindowSize.

            Object = AutoRegistration
              Group = Algorithm
                Name             = MaximumCorrelation
                Tolerance        = 0.7
                SubpixelAccuracy = True
              End_Group

              Group = PatternChip
                Samples = 15
                Lines   = 15
              End_Group

              Group = SearchChip
                Samples = 31
                Lines   = 31
              End_Group

              Group = SurfaceModel
                DistanceTolerance = 1.5
                WindowSize        = 5
              End_Group
            End_Object
            End
        

The above output is the text file resulting when the following command line is run:

autoregtemplate algorithm=MaximumCorrelation tolerance=0.7 psamp=15 pline=15 ssamp=31 sline=31 to=out.txt

This example shows the process and results of creating an AutoReg template that disables calculating to subpixel accuracy. All the parameter values from the previous example are left the same, except that the SUBPIXELACCURACY keyword is set to "false". As a result, there is no SurfaceModel PVL group, and none of those keywords may be entered. Notice, the INTERPOLATORTYPE parameter is not specified in the commandline. Thus, the default cubic convolution type of interpolator is used to load chips.

            Object = AutoRegistration
              Group = Algorithm
                Name             = MaximumCorrelation
                Tolerance        = 0.7
                SubpixelAccuracy = False
                ChipInterpolator = CubicConvolutionType
              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:

autoregtemplate algorithm=MaximumCorrelation tolerance=0.7 subpixelaccuracy=false chipinterpolator=true psamp=15 pline=15 ssamp=31 sline=31 to=out.txt

This example shows the kinds of values one might potentially enter for every valid keyword in an AutoReg template. Every parameter is specified in the template for this example. The only parameter not specified in the command line is subpixel accuracy, which must remain at its default ("true") in order to have a SurfaceModel group in the output PVL. ChipInterpolator is enabled in order to choose an interpolator type. Also, EccentricityTesting and ResidualTesting must be enabled in order to enter values for their keywords, because unlike MinimumZScore and ValidPercent (keywords that have defaults inside AutoReg if not specified in the template), Eccentricity and Residual testing are disabled altogether if EccentricityRatio and ResidualTolerance are not specified in the AutoReg template.

            Object = AutoRegistration
              Group = Algorithm
                Name             = MinimumDifference
                Tolerance        = 0.7
                ReductionFactor  = 2
                SubpixelAccuracy = True
                ChipInterpolator = NearestNeighborType
              End_Group

              Group = PatternChip
                Samples       = 15
                Lines         = 15
                ValidMinimum  = 1200
                ValidMaximum  = 2800
                MinimumZScore = 0.5
                ValidPercent  = 75.0
              End_Group

              Group = SearchChip
                Samples             = 31
                Lines               = 31
                ValidMinimum        = 1200
                ValidMaximum        = 2800
                SubchipValidPercent = 80.0
              End_Group

              Group = SurfaceModel
                DistanceTolerance = 2.5
                WindowSize        = 11
                EccentricityRatio = 5.0
                ResidualTolerance = 0.001
              End_Group
            End_Object
            End
       

The above output is the text file resulting when the following command line is run:

autoregtemplate algorithm=MinimumDifference tolerance=0.7 reductionfactor=2 chipinterpolator=true interpolatortype=nearestneighbor psamp=15 pline=15 pmin=1200 pmax=2800 pvalidpercent=75 ssamp=31 sline=31 smin=1200 smax=2800 minimumzscore = 0.5 ssubchipvalidpercent = 80 distancetolerance=2.5 windowsize=11 eccentricitytesting=true eccentricityratio=5.0 residualtesting=true residualtolerance=0.001 to=out.txt