ISIS Documentation

mat2cnet

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

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

Categories

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.