ISIS 3 Application Documentation
Combine one to many control networks with common control points.
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
Applications
History
Kris Becker | 2015-10-11 |
Original Version
|
Kris Becker | 2015-10-22 |
Corrected the count when SAVEMINS=TRUE.
|
Kris Becker | 2015-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 Backer | 2016-03-11 |
Added program to ISIS package.
|
|
Parameter Groups
Input
Name
|
Description
|
CNETBASE | Master control network file to match |
CNETFROM | Merger control network file |
CNETLIST | List of merger control network files |
REFERENCE | Cube file to use as a reference image for IMAGE mode |
Output
Name
|
Description
|
ONET |
Merged Control Network
|
NETWORKID | The NetworkId keyword value for the merged ControlNet |
DESCRIPTION | The Description keyword value for the merged ControlNet |
Parameters
Name
|
Description
|
MODE | Type of control point merger to apply |
DISTANCE |
Specifies the radial search distance for merge candidates
|
IMAGETOL | Pixel distance tolerance to determine merge of point |
GROUNDTOL |
Specifies distance on ground to merge point if no common image measures .
|
KDNODES | Specify the leaf size of the kd-tree |
SETAPRIORIBEST |
Reset the apriori surface point to best available
|
REJECTEDMEASURES | Tweek rejected measures |
MINMEASURES | Select minimim number of measures that are valid |
SAVEMINS |
Save points that have less than the mininum measures
|
|
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:
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 |
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.
|
|
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.
Parameters:
IMAGETOL
Description
The acceptable distance, in pixels, for merging points.
Parameters:
GROUNDTOL
Description
The acceptable distance, in ground measurements, for merging points.
Parameters:
KDNODES
Description
Number of leafs in the kd-tree structure.
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.
|
|
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.