Home
About Isis
Support
Download

Isis 3

Documentation
Tutorials
Technical Documents

Isis 2

Documentation
Tutorials
Technical Documents

Search
USGS

Isis 3 Application Documentation

pointreg

Standard View | TOC | Home

Point Registration

Description
Categories
Groups
Examples
History

Description

This program takes a control network and a registration algorithm and returns a refined control network based on the algorithm.

Categories

Related Objects and Documents

Applications

Documents

Parameter Groups

Input

Name Description
FILES Input File List
CNET Input ControlNet
TEMPLATE Auto Regestration Template

Output

Name Description
TO Resulting ControlNet
FLATFILE Text file of pointreg data
OUTPUTIGNORED Keep Ignored ControlPoints
OUTPUTUNMEASURED Keep Unmeasured ControlMeasures

PointsToRegister

Name Description
REGISTERIGNOREDONLY Register only the "ignored" points

Input: FILES

Description

This file contains all the files used in the control network.

Type filename
File Mode input
Filter *.txt *.lis *.lst *.list

Input: CNET

Description

This file contains the initial control network.

Type filename
File Mode input
Filter *.net

Input: TEMPLATE

Description

This is the auto regestration template file which contains all the information on the registration algorithm to be used.

Type filename
File Mode input
Filter *.def

Output: TO

Description

This is the output ControlNet file containing the registered information.

Type filename
File Mode output
Filter *.net

Output: FLATFILE

Description

This file will contain data collected from the pointreg application. The data will be comma separated and contain a line for each measurement of all non-ignored points in the output control net. This will include the point id, orignal sample position, original line position, new sample position, new line position, sample difference, line difference, minimum z-score, maximum z-score, and goodness of fit.

Type filename
File Mode output
Internal Default None
Filter *.txt *.lis *.lst *.list

Output: OUTPUTIGNORED

Description

Specifies if Ignored ControlPoints will remain in the ControlNet.

Type boolean
Default True

Output: OUTPUTUNMEASURED

Description

Specifies if Unmeasured ControlMeasures will remain in the ControlNet.

Type boolean
Default True

PointsToRegister: REGISTERIGNOREDONLY

Description

This parameter is used to reprocess ignored points. It can set them to "valid" if they are acceptable in a new tolerance range. If this parameter is not selected, only the "valid" or "non-ignored" points will be registered.

Type boolean
Default False

Examples

Example 1

Default registration settings include ignored and unmeasured points in the output control net.

Description

In this example, the pointreg application is used to register valid, i.e. "non-ignored", points from two images and output a new control network that includes ignored control points and unmeasured control measures.

Command Line

pointreg files=../IN/fileList.lis cnet=../IN/controlNet.net template=../IN/autoRegTemplate.def to=../OUT/outputIgnoredAndUnmeasured.net flatfile=../OUT/outputIgnoredAndUnmeasured.txt
This example shows the use of pointreg with the OUTPUTIGNORED and OUTPUTUNMEASURED parameters left with the default values of "True" and REGISTERIGNOREDONLY with the default value of "False". This implies that only "non-ignored" points will be registered but all control points and control measures will be included in the output.

GUI Screenshot

pointreg GUI

Example GUI

Screen shot of GUI with parameters filled in to perform point registration that includes ignored control points and unmeasured control measures in the output but does not register the ignore points.

Data Files

View Input File List Input text file containing a list of all files in the control network. All cubes in this list should be located in the same directory that the application is run in.
View Entire Input ControlNet Input text file containing the initial control network. There are 10 control points, one is passed in as an ignored point and two are unmeasured.
View Auto Registration Template Input auto registration template file in PVL format containing the registration algorithm information to be used to register the points.
View resulting ControlNet Output control network file containing the registered information. Notice that all ignored points and unmeasured control measures are kept in this network.
View resulting flat file Output flat file containing the data collected from the pointreg application.
View resulting application log. This log is output to the screeen and contains a count of the following: "ignore" points upon completion; validated, registered, unregistered and unmeasured ControlMeasures; successful and failed registrations; PatternChip and SurfaceModel statistics.

Example 2

Register "ignored" points in a control network and include ignored and unmeasured points in the output control net.

Description

In this example, the pointreg application is used to register "ignore" points from two images and output a new control network that includes valid and ignored points and unmeasured control measures.

Command Line

pointreg files=../IN/fileList.lis cnet=../IN/controlNet.net template=../IN/autoRegTemplate.def to=../OUT/outputIgnoredAndUnmeasuredRegIgnored.net flatfile=../OUT/outputIgnoredAndUnmeasuredRegIgnored.txt registerignoredonly=yes
This example shows the use of pointreg with the OUTPUTIGNORED, OUTPUTUNMEASURED and REGISTERIGNOREDONLY parameters as "True". This implies that only "ignored" points will be registered but all control points and control measures will be included in the output.

GUI Screenshot

pointreg GUI

Example GUI

Screen shot of GUI with parameters filled in to perform ignored point registration that includes ignored control points and unmeasured control measures in the output but does not register the "valid" points.

Data Files

View Input File List Input text file containing a list of all files in the control network. All cubes in this list should be located in the same directory that the application is run in.
View Entire Input ControlNet Input text file containing the initial control network. There are 10 control points, one is passed in as an ignored point and two are unmeasured.
View Auto Registration Template Input auto registration template file in PVL format containing the registration algorithm information to be used to register the points.
View resulting ControlNet Output control network file containing the registered information. Notice that all ignored points and unmeasured control measures are kept in this network.
View resulting flat file Output flat file containing the data collected from the pointreg application.
View resulting application log. This log is output to the screeen and contains a count of the following: "ignore" points upon completion; validated, registered, unregistered and unmeasured ControlMeasures; successful and failed registrations; PatternChip and SurfaceModel statistics.

Example 3

Register "valid" points in a control network and omit ignored points and unmeasured measures from the output control net.

Description

In this example, the pointreg application is used to register "valid" points from two images and output a new control network that omits ignored control points and unmeasured control measures.

Command Line

pointreg files=../IN/fileList.lis cnet=../IN/controlNet.net template=../IN/autoRegTemplate.def to=../OUT/discardIgnoredAndUnmeasured.net flatfile=../OUT/discardIgnoredAndUnmeasured.txt outputignored=no outputunmeasured=no
This example shows the use of pointreg with the OUTPUTIGNORED, OUTPUTUNMEASURED and REGISTERIGNOREDONLY parameters set to "False". This implies that only "valid" points will be registered and included inthe output control network.

GUI Screenshot

pointreg GUI

Example GUI

Screen shot of GUI with parameters filled in to perform point registration that omits ignored control points and unmeasured control measures from the output.

Data Files

View Input File List Input text file containing a list of all files in the control network. All cubes in this list should be located in the same directory that the application is run in.
View Entire Input ControlNet Input text file containing the initial control network. There are 10 control points, one is passed in as an ignored point and two are unmeasured.
View Auto Registration Template Input auto registration template file in PVL format containing the registration algorithm information to be used to register the points.
View resulting ControlNet Output control network file containing the registered information. Notice that all ignored points and unmeasured control measures are omitted from this network.
View resulting flat file Output flat file containing the data collected from the pointreg application.
View resulting application log. This log is output to the screeen and contains a count of the following: "ignore" points upon completion; validated, registered, unregistered and unmeasured ControlMeasures; successful and failed registrations; PatternChip and SurfaceModel statistics.

Example 4

Register "ignored" points in a control network and omit ignored and unmeasured points in the output control net.

Description

In this example, the pointreg application is used to register "ignore" points from two images and output a new control network that omits ignored control points and unmeasured control measures.

Command Line

pointreg files=../IN/fileList.lis cnet=../IN/controlNet.net template=../IN/autoRegTemplate.def to=../OUT/discardIgnoredAndUnmeasuredRegIgnored.net flatfile=../OUT/discardIgnoredAndUnmeasuredRegIgnored.txt outputignored=no outputunmeasured=no registerignoredonly=yes
This example shows the use of pointreg with the OUTPUTIGNORED and OUTPUTUNMEASURED parameters set to "False" and REGISTERIGNOREDONLY set to "True". This implies that only "ignored" points will be registered while ignored control points and unmeasured control measures are omitted from the output.

GUI Screenshot

pointreg GUI

Example GUI

Screen shot of GUI with parameters filled in to perform ignored point registration that omits ignored control points and unmeasured control measures from the output.

Data Files

View Input File List Input text file containing a list of all files in the control network. All cubes in this list should be located in the same directory that the application is run in.
View Entire Input ControlNet Input text file containing the initial control network. There are 10 control points, one is passed in as an ignored point and two are unmeasured.
View Auto Registration Template Input auto registration template file in PVL format containing the registration algorithm information to be used to register the points.
View resulting ControlNet Output control network file containing the registered information. Notice that all ignored points and unmeasured control measures are omitted from this network.
View resulting flat file Output flat file containing the data collected from the pointreg application.
View resulting application log. This log is output to the screeen and contains a count of the following: "ignore" points upon completion; validated, registered, unregistered and unmeasured ControlMeasures; successful and failed registrations; PatternChip and SurfaceModel statistics.

History

Jacob Danton2006-01-11 Original Version
Brendan George2006-10-02 Modified call to get current time to use Time class, instead of Application class
Steven Lambright2007-07-23 Fixed typos, changed category to Control Networks and removed example
Steven Lambright2008-06-23 Fixed memory leak, progress, updated to work with AutoReg change
Steven Koechle2008-11-13 Added option to process ignored points (new parameters PROCESSIGNORED and PROCESSVALID), Added FlatFile output parameter. Renamed IGNORED parameter to OUTPUTIGNORED Renamed UNMEASURED parameter to OUTPUTUNMEASURED.
Steven Koechle2008-11-13 Fixed pointreg to modify ChooserName and DateTime of measures it alters
Jeannie Walldren2008-11-14 Changed PROCESSIGNORED parameter name to REGISTERIGNOREDONLY. Removed PROCESSVALID parameter since "valid" points are only processed if REGISTERIGNOREDONLY is false. Changed extension filters for CNET, TEMPLATE and TO from (*.txt *.lis *.lst) to *.net, *.def, and *.net, respectively. Fixed bug in program so ignored control points only are included in the output when the OUTPUTIGNORED parameter is selected. And valid points are always included in the output.
Jeannie Walldren2008-11-17 Added examples to xml file. Fixed bug so that, when registering ignored points, any unmeasured ControlMeasure is omitted if OUTPUTUNMEASURED=no. Added appTest cases for new parameters.
Steven Koechle2008-11-18 Added PointId to the FlatFile output
Jeff Anderson2008-12-04 Modified to allow control points to have measures which can't be registered to not be ignored. The point is not ignored so long as at least two measures can be registered.
Jeannie Walldren2008-12-22 Modified to set successfully registered measures to Ignore=False and Ignore=True otherwise.
Jeannie Walldren2008-12-23 Modified code that sets point's "Ignore" Keyword to "True" only if it is neither a ground point nor a held point. Modified app test truth files to reflect changes.
Jeannie Walldren2008-12-24 Modified flatfile parameter to output the lines and samples of the original and registered measurements, rather than the original and reference measurements. Modified app test truth files to reflect changes.
Steven Lambright2009-02-13 This program now uses CubeManager to more properly balance memory usage and run time. This program should run faster because it is leaving more cubes in memory instead of opening and closing them each time.
Travis Addair2009-08-10 Auto registration parameters are now placed into the print file.