Home
About ISIS
Support
Download

ISIS 3

Documentation
Tutorials
Technical Documents

ISIS 2

Documentation
Tutorials
Technical Documents

Search

USGS

ISIS 3 Application Documentation


cnetcombinept

Printer Friendly View | TOC | Home

Combine one to many control networks with common control points.

Overview Parameters

Description

This program will create a control network by combining control points from one or more control networks into single points that satisfy either ground or image distance criteria. It employs a more robust technique than cnetmerge. This technique evaluates each control point in the combined network by applying a search of radial spatial distance (in meters) to collect all points that may be of the same feature. This search will find a list of candidate control points, i.e. points that the algorithm has found might be matches. Distance statistics of common control measures from the image are computed using the source point and each candidate control point. The MODE parameter for this program specifies the maximum distance, in IMAGE (pixel units) or GROUND (meter units), allowed to determine whether the two control points are measurements of the same image feature. If the average of all common measures is less than or equal to the distance (in the given IMAGE or GROUND units), then all control measures from the candidate control point are copied to the source control point (increasing image match depth) and the candidate control point is disabled so that it will never be considered for another merger. The now augmented control point is added back to the search pool for further merger considerations.

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.

Parameter Groups

Input

Name Description
CNETBASEMaster control network file to match
CNETFROMMerger control network file
CNETLISTList of merger control network files
REFERENCECube file to use as a reference image for IMAGE mode

Output

Name Description
ONET Merged Control Network
NETWORKIDThe NetworkId keyword value for the merged ControlNet
DESCRIPTIONThe Description keyword value for the merged ControlNet

Parameters

Name Description
MODEType of control point merger to apply
DISTANCE Specifies the radial search distance for merge candidates
IMAGETOLPixel distance tolerance to determine merge of point
GROUNDTOL Specifies distance on ground to merge point if no common image measures .
KDNODESSpecify the leaf size of the kd-tree
SETAPRIORIBEST Reset the apriori surface point to best available
REJECTEDMEASURESTweek rejected measures
MINMEASURESSelect minimim number of measures that are valid
SAVEMINS Save points that have less than the mininum measures
X

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
Close Window
X

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
Close Window
X

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
Close Window
X

Input: REFERENCE


Description

The reference cube for matching by image.

Type cube
File Mode input
Internal Default None
Filter *.cub
Close Window
X

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
Close Window
X

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
Close Window
X

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
Close Window
X

Parameters: MODE


Description

The MODE parameter indicates whether to use ground or image coordinates to determine merge points.

Type string
Default GROUND
Option List:
Option Brief Description
GROUND Use ground coordinates to determine merge points Measure point distance in ground units (i.e. meters or kilometers).
IMAGE Use image coordinates from a specfied named reference cube Measure point distance in pixel units.
Close Window
X

Parameters: DISTANCE


Description

The radial search range from the source control point to find all candidate control points to consider for merging. This distance is specified in meters. Users must carefully consider this value as it must be large enough to include the maximum uncertainity in the SPICE ephemeris data for all images. Note if the adjusted latitude/longitude coordiate exists in the point, it will be used to determine the ground coordinate, otherwise apriori latitude/longitudes are used to compute distances from each control point. It also should not be so small that it will not find all the points of the same feature.

Type double
Close Window
X

Parameters: IMAGETOL


Description

The acceptable distance, in pixels, for merging points.

Type double
Default 1.0
Close Window
X

Parameters: GROUNDTOL


Description

The acceptable distance, in ground measurements, for merging points.

Type double
Default 0.0
Close Window
X

Parameters: KDNODES


Description

Number of leafs in the kd-tree structure.

Type integer
Default 10
Close Window
X

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
Close Window
X

Parameters: REJECTEDMEASURES


Description

Determeines how to deal with rejected measures.

Type string
Default NOACTION
Option List:
Option Brief Description
NOACTION Do not perform any action on non-normal measures If selected, the program will leave rejected measures with their current settings.
IGNORE Set (jigsaw) rejected measures to IGNORE If selected, the program will set rejected measures to Ignore.
REMOVE Remove (jigsaw) rejected measures from point If selected, the program will remove rejected measures from the control point.
Close Window
X

Parameters: MINMEASURES


Description

This allows users to disable (by setting measures as ignored) 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.

Type integer
Default 0
Close Window
X

Parameters: SAVEMINS


Description

When TRUE, all points found to have the minimum number of measures are set to ignore and written to the output control network. When FALSE, they are excluded(removed) from the output network.

Type boolean
Default false
Close Window