Home

User Documentation

Getting Started
Learn More
Explore in Detail
Get Inspired

Contributor Documentation

Getting Started
Learn More
Explore in Detail
Get Inspired

Quick Links

Software Manual
AstroDiscuss
GitHub
API Reference

Documentation Versions

Public Release
8.2.0
8.1.0
8.0.0
7.2.0
7.1.0
7.0.0
6.0.0
3.9.0
3.5.0

ISIS 2

Documentation
Tutorials
Technical Documents
USGS

ISIS Application Documentation


mat2cnet

Standard View | TOC | Home

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

Description
Categories
Groups
Examples
History


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


Categories


Parameter Groups

ISIS2 Files

Name Description
LIST2 List of ISIS2 input cubes in the match point file.
MATCH ISIS2 match point file
INPUTPPPInput 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

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

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

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

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.

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

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

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

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

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

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

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

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

Examples


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

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

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.

History

Brendan George2007-08-10 Original version
Steven Lambright2007-12-14 Now IMAGE_NUMBER will be used before IMAGE_ID for matching files
Stuart Sides2008-04-15 Fixed bug where serial numbers were not correct.
Steven Lambright2008-05-19 Error message added for missing FSC's
Christopher Austin2008-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 Walldren2009-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 Walldren2009-12-17 Modify code to allow use of particular types of edited RAND files. Updated description of RAND parameter to reflect this change.
Jeannie Walldren2010-03-21 Convert RAND radius values from kilometers to meters. Added option to
Jeannie Walldren2010-04-15 Added option to create RAND only points (no measures in the matchpoint file) as GROUND points.
Jeannie Walldren2010-04-19 Modified error messages to output filename typed in by user rather than entire path.
Jeannie Walldren2010-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 Walldren2010-12-01 Modified to be compatible with binary control network. Modified errors app test Makefile.
Travis Addair2011-04-11 Changed CNET to ONET and PPPLOG to LOG as per consistency wiki.
Debbie A. Cook2011-06-07 Changed point types "Ground" to "Fixed" and "Tie" to "Free".
Jeannie Backer2011-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 Backer2016-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 Mapel2018-07-06 Changed to just use the input target name because it is not needed to compute target radii. Fixes #5457.