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


ISIS 2

Documentation
Tutorials
Technical Documents
USGS

ISIS Application Documentation


cnetcombinept

Standard View | TOC | Home

Combine one to many control networks with common control points.

Description
Categories
Groups
History


Description

This program will create a control network by combining control points from one or more control networks into single points that satisfy image distance criteria. It employs a more robust/direct technique than cnetmerge. This technique evaluates each control point in all input networks by finding all candidate merger control points who have a measure within IMAGETOL. Then, for each candidate point, the average distance of the measures in the candidate to a measure in the source point is computed. If the average distance to any measure in the source point is less than IMAGETOL, then the candidate point and source point are merged. The candidate control point is disabled so that it will never be considered for another merger and the now augmented control point is added back to the search pool for further merger considerations, which can occur when other common measures are considered.

When all control points have been searched and all mergers have taken place, a new single combined control network is created.

Note that this application can be ran more than once and directly on the output of any past run (in other words, you need only provide a single network, if desired).


Categories


Related Objects and Documents

Applications


Parameter Groups

Input

Name Description
CNETBASEMaster control network file to match
CNETFROMMerger control network file
CNETLISTList of merger control network files

Output

Name Description
ONET Merged Control Network
TOSN Write a list of all serial numbers contained in the network
NETWORKIDThe NetworkId keyword value for the merged ControlNet
DESCRIPTIONThe Description keyword value for the merged ControlNet
LOGFILEFile that logs which points were merged together

Parameters

Name Description
IMAGETOLPixel distance tolerance to determine merge of point
KDNODESSpecify the leaf size of the kd-tree
SETAPRIORIBEST Reset the apriori surface point to best available
CLEANNETRemove all invalid or ignored control points/measures
CLEANMEASURESRemove all invalid or ignored control measures
MINMEASURESSelect minimim number of valid measures/point

Input: CNETBASE

Description

The base control network file to which others will be matched.

Type filename
File Mode input
Internal Default None
Filter *.net *.cnet *.ctl

Input: CNETFROM

Description

A control network that will be matched to the base (i.e. master) network.

Type filename
File Mode input
Internal Default None
Filter *.net *.cnet *.ctl

Input: CNETLIST

Description

A list of control network file names that will be matched to the base (i.e. master) network.

Type filename
File Mode input
Internal Default None
Filter *.lis *.txt

Output: ONET

Description

The output Control Network, which is the combined result of the input networks.

Type filename
File Mode output
Internal Default None
Filter *.net *.cnet *.ctl

Output: TOSN

Description

Provided with a filename in this option, all the cube serial numbers that are contained in the network are written to this file as soon as it is determined in the processing.

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

Output: NETWORKID

Description

The NetworkId keyword for the newly merged ControlNet will be set to this given value. The Networkid is a single word identifier or name assigned to a Control Network.

Type string
Internal Default None

Output: DESCRIPTION

Description

The Description keyword for the newly merged ControlNet will be set to this given value. This should be a brief description of the purpose of the merged control network.

Type string
Internal Default None

Output: LOGFILE

Description

A four column CSV file that contains which input control points were merged into output control points. The first column contains the ID of each output control point that had at least one input control point merged into it. The second column contains the number of measures in the input control point. The third column contains the number of measures in the output control point. The fourth column contains a space separated list of the IDs of input control points that were merged into the output control point.

Type filename
Internal Default None

Parameters: IMAGETOL

Description

The acceptable distance, in pixels, for merging points.

Type double
Default 1.0

Parameters: KDNODES

Description

Number of leaves in the kd-tree structure.

Type integer
Default 10

Parameters: SETAPRIORIBEST

Description

When TRUE, all points apriori latitude/longitude surface point is updated to use the best one available. This is often the resulting coordinate after jigsaw has adjusted the surface point.

Type boolean
Default false

Parameters: CLEANNET

Description

When true, all invalid or ignored control points and measures are removed from the output control network as one of the main objectives of this application is to remove redundancies and mimimize the size of networks. However, for evaluation purposes, you can set this to false, which will preserve all control points.

When specifying the minimum number of measures/control point using the MINMEASURES parameter, any control point that does not meet this criteria will also be removed from the netwrk when CLEANNET=true, otherwise these points will be set to ignored.

Type boolean
Default true

Parameters: CLEANMEASURES

Description

When true, all invalid or ignored control points and measures are removed from the output control network as one of the main objectives of this application is to remove redundancies and mimimize the size of networks. However, for evaluation purposes, you can set this to false, which will preserve all control points.

When specifying the minimum number of measures/control point using the MINMEASURES parameter, any control point that does not meet this criteria will also be removed from the netwrk when CLEANNET=true, otherwise these points will be set to ignored.

Type boolean
Default true

Parameters: MINMEASURES

Description

This allows users to disable points that have less than MINMEASURES control measures/control point. For example, if you want to flag all points as ignored with 2 measures or less, set MINMEASURES=3. Points that don't meet this critieria are set to ignore and are subject to the CLEANNET action requested by the user (i.e., all ignored points are removed from the network if CLEANNET=true).

Type integer
Default 0

History

Kris Becker2015-10-11 Original Version
Kris Becker2015-10-22 Corrected the count when SAVEMINS=TRUE.
Kris Becker2015-11-13 Uses modified ControlNet class which provides the ability to take ownership of all points in the control net efficiently. This is needed in order to ensure only a single copies of control points are utlized to minimize memory overhead.
Jeannie Backer2016-03-11 Added program to ISIS package.
Jeannie Backer2016-04-22 Modified to set the new control net's target and radii by using the input control net's values. References #3892
Kris Becker2016-12-05 Modified merging algorithm and parameters. Fixes #4558.
Jesse Mapel2016-12-06 Created new tests and updated documentation. References #4558.
Tyler Wilson2017-06-29 Modified ControlPointMerger::merge function to properly hand combining control points that contain the same control measures in each point. Fixes #4869.
Tyler Wilson2017-06-29 Modified ControlPointMerger::merge function so that merged control measure types are set to candidate (except when they have the same reference measure). Fixes #4870.
Tyler Wilson2017-06-29 cnetcombinept now properly sets apriori lat/lon values to adjusted values. Fixes #4772.
Jesse Mapel2018-07-06 Removed calls to set control net target radii because they are no longer needed by the control network. Fixes #5457.
Jesse Mapel2020-06-09 Added a the LOGFILE argmuent that generates a log of which control points were merged together.