ISIS Documentation

cnetcombinept

Combine one to many control networks with common control points.

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


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.