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
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.