autoregtemplate

This program creates an auto registration 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 a tolerance is specified, the application will automatically insert the tolerance keyword and value into the auto registration 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). This is where you will find the available auto registration algorithms.

NOTE: This program lacks updates for the Gruen pattern matching algorithm. In the future, this program will be deprecated 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 topvl=out.txt

This example shows the process and results of creating an auto registration 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 INTERP parameter is not specified in the command line. 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 psamp=15 pline=15 ssamp=31 sline=31 topvl=out.txt

This example shows the kinds of values one might potentially enter for every valid keyword in an auto registration 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. Interp is set to the nearest neighbor chip interpolator type.

            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
              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 interp=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 topvl=out.txt