ISIS Application Documentation

mat2cnet

Printer Friendly View | TOC | Home

Converts an ISIS2 match point file to an ISIS control network file.

Overview

Parameters

Example 1

Example 2

Description

This program converts an ISIS2 match point file to an ISIS control network file. It requires a list file of ISIS2 cubes and corresponding list file of ISIS cubes. Note: In order to identify which ISIS cube corresponds to a particular ISIS2 cube, these lists must be the same length and ordering. That is, if the first cube of the ISIS2 list was imported from a particular raw image (observation), then the first cube of the ISIS list must be imported from the same image (observation), and so on for each cube listed.

This application also requires a match point file, an output Control Network pvl name, a network ID, a target and a description. The user may also choose whether to input a RAND PPP file containing latitude, longitude and radius for each corresponding point ID and to create an output RAND PPP log. This program converts the radius values in these files from km to meters before adding them to the output control network. If a RAND PPP file is not entered, all the points in the MATCH file will be set to type Free. If a RAND PPP is input, then any points not found in this file will still be set to Free and the user may choose whether to set points found in both the RAND and MATCH files to Fixed or Free. Any points found in the RAND file without measurements in the MATCH file will not be included in the output control net. The corresponding lines from the RAND PPP file for these points will be copied to the RAND PPP log.

The following indicates how the ISIS2 Class is translated to an ISIS MeasureType

"T" (Truth) is translated to Reference
"S" (SubPixel) is tranlated to RegisteredSubPixel
"M" (Measured) is translated to RegisteredPixel
"A" (Approximate) is tranlated to Candidate
"U" (Unmeasured) is translated to Candidate and the measure is set to Ignore

History

Brendan George	2007-08-10	Original version
Steven Lambright	2007-12-14	Now IMAGE_NUMBER will be used before IMAGE_ID for matching files
Stuart Sides	2008-04-15	Fixed bug where serial numbers were not correct.
Steven Lambright	2008-05-19	Error message added for missing FSC's
Christopher Austin	2008-07-01	Added exception message when the given MATCH file's "Matchpoint total" keyword is less than the number of actual Match Points in the file.
Jeannie Walldren	2009-11-06	Added RAND input parameter and updated documentation. Added exception messages for invalid match point file headers and values. Added 1% Progress updates to show potentially slower steps. Added appTests for RAND parameter and to catch errors. Added examples to xml file.
Jeannie Walldren	2009-12-17	Modify code to allow use of particular types of edited RAND files. Updated description of RAND parameter to reflect this change.
Jeannie Walldren	2010-03-21	Convert RAND radius values from kilometers to meters. Added option to
Jeannie Walldren	2010-04-15	Added option to create RAND only points (no measures in the matchpoint file) as GROUND points.
Jeannie Walldren	2010-04-19	Modified error messages to output filename typed in by user rather than entire path.
Jeannie Walldren	2010-06-30	Changed CONTROL parameter name to CNET for consistency with other ISIS3 programs. Added INPUTPPP parameter. Changed parameter name from RAND to PPP for more precise description and modified POINTTYPE parameter usage. Added results to GUI log and added output PPPLOG parameter.
Jeannie Walldren	2010-12-01	Modified to be compatible with binary control network. Modified errors app test Makefile.
Travis Addair	2011-04-11	Changed CNET to ONET and PPPLOG to LOG as per consistency wiki.
Debbie A. Cook	2011-06-07	Changed point types "Ground" to "Fixed" and "Tie" to "Free".
Jeannie Backer	2011-07-20	Clarified documentation. Added POINTLOCK and MEASURELOCK parameters to allow the user to determine whether to EditLock points and measures. Added appTests for new parameters and gave more meaningful names to existing appTests.
Jeannie Backer	2016-04-22	Modified to use cube labels to set control net target if unable to set with only the user given TARGET. References #3892
Jesse Mapel	2018-07-06	Changed to just use the input target name because it is not needed to compute target radii. Fixes #5457.

U.S. Department of the Interior | U.S. Geological Survey
ISIS | Privacy & Disclaimers | Astrogeology Research Program
To contact us, please post comments and questions on the USGS Astrogeology Discussion Board
To report a bug, or suggest a feature go to: ISIS Github
File Modified: 02/21/2025 19:28:12

Parameter Groups

ISIS2 Files

Name	Description
LIST2	List of ISIS2 input cubes in the match point file.
MATCH	ISIS2 match point file
INPUTPPP	Input a RAND PPP file
PPP	RAND PPP file containing latitude, longitude, and radius values for given Point IDs.
POINTTYPE	ControlPoint type for points found in RAND PPP and MATCH files.
POINTLOCK	Indicates how to set EditLock keyword for points in RAND PPP file
LOG	Optional RAND PPP log file.

ISIS3 Files

Name	Description
LIST3	List of ISIS input cubes in the match point file.
ONET	ISIS output control network file

Control Network Keyword Settings

Name	Description
DESCRIPTION	Set Description keyword to this value in output ControlNet
NETWORKID	Set NetworkId keyword to this value in output ControlNet
TARGET	Set TargetName keyword to this value in output ControlNet
MEASURELOCK	Indicates how to set EditLock keyword for measures in MATCH file

ISIS2 Files: LIST2

Description

A text file containing one column of ISIS2 cube file names. Every file used in the match point file should be represented in this list. Note: The cubes must be available for the program to open and must be in the same order as the ISIS cubes in LIST3. An error will be thrown if the number of files in this list does not match the number of files in LIST2, or if the IMAGE_ID and IMAGE_NUMBER keywords are not found in any ISIS2 cube.

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

Close Window

ISIS2 Files: MATCH

Description

Use this parameter to specify the ISIS2 match point file to be converted to an ISIS control network file. This file must contain a two line header. The first line of the header must have the "Matchpoint Total" keyword and a value for the number of measures in the match point file. The second line of the header should be text labels for each column. The match point file has 7 columns: PointID, FSC, LINE, SAMP, CLASS, DIAMETER, and Comments. The Point ID is made up of alphanumeric characters, FSC is an integer, LINE and SAMP must be doubles. CLASS is used to determine the measure type. Valid values include T (set to reference measure, validated manual), M (validated manual), S (validated automatic), or U (if line/samp=0/0, set unmeasured, otherwise set estimated). The DIAMETER column is used in the case of a crater. Comments are not read in to this application. A match point file may only have one line for a particular PointID/FSC combination, otherwise an error will be thrown since there is no way to determine which line contains correct values.

Type	filename
File Mode	input
Filter	.mat .dat .txt .tbl

Close Window

ISIS2 Files: INPUTPPP

Description

This parameter indicates whether a RAND PPP (Pole, Point, Picture) file will be input. Valid RAND PPP files for mat2cnet are detailed in the PPP parameter description.

Type	boolean
Default	FALSE
Inclusions	PPP POINTTYPE POINTLOCK LOG

Close Window

ISIS2 Files: PPP

Description

Use this parameter to specify the RAND PPP file to assign lat/lon/rad values associated with corresponding point IDs from the MATCH file. These files do not contain headers and have 4 unlabeled columns: LATITUDE, LONGITUDE, RADIUS, and PointID. The lines of original RAND PPP files have exactly 79 characters, and columns are right justified with specific lengths, namely, 24, 24, 24, and 7. The only edited RAND PPP files that are valid for this program are those that have a single space added between the RADIUS and the PointID. LATITUDE, LONGITUDE, and RADIUS values must be doubles and PointID is alphanumeric. If this file contains a Point ID that does not exist in the match point file, it will not be added to the ControlNet output and the corresponding lines from the RAND PPP file will be copied to the LOG output file.

Type	filename
File Mode	input
Filter	.ppp .dat

Close Window

ISIS2 Files: POINTTYPE

Description

This parameter determines the ControlPoint type to which points will be set if they are found in the RAND PPP file and have corresponding measurements in the MATCH file. This parameter defaults to Fixed. Note: All points from the MATCH file not found in the RAND PPP file will be set to Free and all points from the RAND PPP file not found in the MATCH file will be omitted from the output Control Network.

Type

string

Default

FIXED

Option List:

Option	Brief	Description
FIXED	Set PointType keyword to Fixed for points in RAND PPP file	If this option is selected, any points in the RAND PPP file that has measurements in the MATCH file will have its PointType keyword set to Fixed in the output ControlNet.
FREE	Set PointType keyword to Free for points in RAND PPP file	If this option is selected, any points in the RAND PPP file that has measurements in the MATCH file will have its PointType keyword set to Free in the output ControlNet.

Close Window

ISIS2 Files: POINTLOCK

Description

This parameter indicates whether control points found in the RAND PPP file will be locked. That is, if this parameter is set to true, then each ControPoint in the output ControlNet that exists in the RAND PPP file will have the keyword EditLock set to true. This prevents any editing by most ISIS programs (with the exception of jigsaw) to the latitude, longitude, and radius values associated to the points in the RAND PPP file. Furthermore, the reference measures of each of these points will be treated as if they are locked, preventing any editing by ISIS programs to the sample and line values found in the match point file. This parameter defaults to TRUE and can only be used if the INPUTPPP parameter is set to true.

Type	boolean
Default	TRUE

Close Window

ISIS2 Files: LOG

Description

This file will contain the Point IDs of all control points that were found in the RAND PPP file but had no measurements in the MATCH file. Note: This log is not a typical results log that contains the GUI log output.

Type	filename
File Mode	output
Internal Default	No Log Output
Filter	.log .txt

Close Window

ISIS3 Files: LIST3

Description

A text file containing one column of ISIS cube file names. Every file used in the match point file should be represented in this list. Note: The cubes must be available for the program to open and must be in the same order as the ISIS2 cubes in LIST2. An error will be thrown if the number of files in this list does not match the number of files in LIST2.

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

Close Window

ISIS3 Files: ONET

Description

Use this parameter to specify the file name of the output ISIS3 control network.

Type	filename
File Mode	output
Filter	.net .pvl .ctl .cnet

Close Window

Control Network Keyword Settings: DESCRIPTION

Description

The Description keyword of the output ControlNet will be set to this string value. This should be a brief description of the control network file to be created.

Type	string

Close Window

Control Network Keyword Settings: NETWORKID

Description

The NetworkId keyword of the output ControlNet will be set to this string value. The NetworkId is a single word identifier assigned to this particular ControlNet file. This string should be unique to this output file.

Type	string

Close Window

Control Network Keyword Settings: TARGET

Description

The TargetName keyword of the output ControlNet will be set to this string value. This is the planetary body targeted in the images in the input file lists. The TargetName value should appear in all cubes used in the output ControlNet.

Type	string

Close Window

Control Network Keyword Settings: MEASURELOCK

Description

This parameter indicates whether control measures found in the match point file will be locked. That is, if this parameter is set to true, then each ControlMeasure in the output ControlNet file will have the keyword EditLock set to true. This prevents any editing by ISIS3 programs to the sample and line values associated to each measure found in the match point file. This parameter defaults to FALSE.

Type	boolean
Default	FALSE

Close Window

Example 1

Create control net from match point file

Description

This example demonstrates how to use the mat2cnet application to create a control network from a match point file. In this case, no RAND PPP file is used.

Command Line

mat2cnet list2=../IN/isis2cubes.lis match=../IN/matchpointfile.mat list3=../IN/isis3cubes.lis control=../OUT/controlnet.net description="Default Test Network" networkid= TestNet01 target=Titan

Run the mat2cnet application to create a ControlNet file from a match point file with corresponding ISIS2 cubelist and ISIS cubelist

GUI Screenshot

Mat2cnet Gui using match point file

Example Gui

Screenshot of GUI with parameters filled in to perform the mat2cnet application. The RAND PPP parameter is left as the default of "None".

Data Files

Links open in a new window.

Example of match point file.	This text file is an example of a valid match point file with proper header and columns.
Example of control net file.	This pvl file is an example of the output control network created from the given match point file. Notice the NetworkId, TargetName, and Description are assigned the values from the command line.

Example 2

Create control net from match point file and RAND PPP file

Description

This example demonstrates how to use the mat2cnet application to create a control network from a match point file and corresponding RAND PPP file.

Command Line

mat2cnet list2=../IN/isis2cubes.lis match=../IN/matchpt.mat inputppp=true ppp=../IN/rand.ppp list3=../IN/isis3cubes.lis control=../OUT/control.net description="RAND PPP Test Network" networkid= TestNet02 target=Titan

Run the mat2cnet application to create a ControlNet file from a match point file with corresponding ISIS2 cubelist, ISIS3 cubelist, RAND PPP file with a default point type of fixed.

GUI Screenshot

Mat2cnet Gui using intensity

Example Gui

Screenshot of GUI with parameters filled in to perform the mat2cnet application with a RAND PPP file.

Data Files

Links open in a new window.

Example of match point file.	This text file is an example of a valid match point file with proper header and columns.
Example of RAND PPP file.	This text file is an example of a valid RAND PPP file. Notice that there are 2 points in this file to add.
Example of control net file.	This pvl file is an example of the output control network created from the given match point file and RAND PPP file. Notice the following: the first point in the RAND PPP file has 3 measures in the MATCH file and is written to the control network as type Fixed and the second point in the RAND PPP file is not contained in the Control Network since there are no measures with this ID in the MATCH file.
Example of RAND PPP output log file.	This text file is an example of the output RAND PPP log created when there are points in the RAND PPP file that do not have measures in the MATCH file.

Quick Links

Documentation Versions

mat2cnet

Description

Categories

History

Parameter Groups

ISIS2 Files

ISIS3 Files

Control Network Keyword Settings

ISIS2 Files: LIST2

Description

ISIS2 Files: MATCH

Description

ISIS2 Files: INPUTPPP

Description

ISIS2 Files: PPP

Description

ISIS2 Files: POINTTYPE

Description

ISIS2 Files: POINTLOCK

Description

ISIS2 Files: LOG

Description

ISIS3 Files: LIST3

Description

ISIS3 Files: ONET

Description

Control Network Keyword Settings: DESCRIPTION

Description

Control Network Keyword Settings: NETWORKID

Description

Control Network Keyword Settings: TARGET

Description

Control Network Keyword Settings: MEASURELOCK

Description

Example 1

Description

Command Line

GUI Screenshot

Data Files

Example 2

Description

Command Line

GUI Screenshot

Data Files