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

cnetedit

Standard View | TOC | Home

Edit control networks

Description
Categories
Groups
History

Description

This application applies a series of edits to a control network based on the control point IDs and control measure cube filenames specified in various edit lists. All edit operations are optional, and performed in a sequential order that cannot be changed. If the user wises to perform any edit operations in a different order, it is suggested that they run the application multiple times in a pipeline fashion.

The primary, and most typical, function of this application is to selectively delete unwanted points and measures from a network by flagging them as "ignored". Other operations are generally in place to facilitate this purpose, but can also be used on their own.

The available operations are as follows:

  1. Unlock
  2. Ignore
  3. Delete
  4. Lock
Before any points or measures are ignored and deleted, the listed points and measures can be unlocked if edit locked in the input. Listed points and measures can then be ignored, and subsequently any ignored points and measures can be deleted from the network. The deletion operation deletes all ignored points and measures, not just those specified in the lists. Finally, any listed points or measures can be locked to prevent further modification.

Additional options include the ability to preserve points with less than a single valid measure, ability to retain the reference, and the ability to print detailed logging results to a text file.

Categories

Parameter Groups

Files

Name Description
CNET Input control network
ONET Output control network
LOG Log of all ignored or deleted points and measures

Edit Lists

Name Description
POINTLIST List of IDs mapping to points to be edited
CUBELIST List of cube filenames to be edited
MEASURELIST List of paired Point IDs and cube filenames

Edit Operations

Name Description
UNLOCK Unlock listed points and measures
IGNORE Ignore listed points and measures
DELETE Delete ignored points and measures
LOCK Lock listed points and measures

Validity Check

Name Description
CHECKVALID Ignore all control measures outside user-specified tolerances
FROMLIST List of all Input cubes in the control network
DEFFILE PVL file containing the description of the Validity Keywords

Deletion Options

Name Description
PRESERVE Do not delete points with only one remaining measure
RETAIN_REFERENCE Never ignore a reference measure unless the entire point is removed
IGNOREALL Ignore the whole point when the reference measure is ignored

Files: CNET

Description

A control network generated from programs such as autoseed or qnet.

Type filename
File Mode input
Filter *.net

Files: ONET

Description

Updated control network with the applied edits.

Type filename
File Mode output
Filter *.net

Files: LOG

Description

This file provides a PVL record of all points and measures ignored or deleted from the input network. It also makes note of points and measures that could not be ignored or deleted, and provides rationales for each.

Type filename
File Mode output
Internal Default None
Filter *.pvl *.txt

Edit Lists: POINTLIST

Description

The given edit operations will be applied to all the points in the control network mapped by the IDs in this list. Each entry in this list should be a control point ID on its own line. Operations such as unlocking, ignoring, and locking will only be applied at the point level (e.g. locking lat/lon but not measurements). Deleting a point, however, will remove it and all its measures from the network.

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

Edit Lists: CUBELIST

Description

The given edit operations will be applied to all the measurements taken on a cube in this list. This information is derived from the measurement's cube serial number, mapping to a filename in this list.

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

Edit Lists: MEASURELIST

Description

A file containing a list of paired Point IDs and cube filenames, uniquely identifying specific measures to be edited. Each pairing must be on its own line and have the Point ID and filename separated by a comma (',').

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

Edit Operations: UNLOCK

Description

Any listed point or measure will have its edit lock removed if it has one in the input network. If not, nothing will happen to the point or measure and processing will continue. Unlocking a point does not automatically unlock its measurements, except for the reference.

Type boolean
Default False

Edit Operations: IGNORE

Description

Any listed point or measure will be ignored. Ignoring can sometimes fail, for example, if the point or measure is edit locked, and the UNLOCK operation is not enabled.

Type boolean
Default True
Inclusions
  • CHECKVALID

Edit Operations: DELETE

Description

Any ignored point or measure will be deleted, regardless of whether or not it is present in an edit list. Deleting a point will delete all its measurements in the process. If any control point has less than two remaining measures after all measurement deletions have been performed, then that point will be deleted as well. This can be prevented by enabling the PRESERVE option. Furthermore, the RETAIN_REFERENCE option can be enabled to prevent reference measures from being deleted under any circumstance.

Type boolean
Default TRUE
Inclusions
  • PRESERVE
  • RETAIN_REFERENCE

Edit Operations: LOCK

Description

Any listed point or measure will have its edit lock set if it does not already have one in the input network. Otherwise, nothing will happen to the point or measure and processing will continue. Locking a point does not automatically lock its measurements, except for the reference.

Type boolean
Default False

Validity Check: CHECKVALID

Description

If enabled, the application will check the validity of each control measure against the tolerances set in the relevant definition file (DEFFILE). Because validity checking requires camera information not contained within the control measure itself, a list of all cubes in the network is necessary (FROMLIST), and could result in a noticeably more time-intensive run of the program. For the aforementioned reasons, this option is disabled by default.

Type boolean
Default False
Inclusions
  • FROMLIST
  • DEFFILE

Validity Check: FROMLIST

Description

This parameter specifies a list of cube names corresponding to the serial numbers for every control measure in the input control network.

Type filename
File Mode input
Filter *.lis

Validity Check: DEFFILE

Description

This parameter specifies a PVL file containing descriptions for the validity keywords when the user chooses to perform a validity check on each of the measures in the input control network. Invalid control measures will be ignored and, unless otherwise specified, removed.

Type filename
File Mode input
Filter *.def

Deletion Options: PRESERVE

Description

PRESERVE is only applied when DELETE=YES. This option will prevent the DELETE operation from removing control points that only have one measure remaining at the end of the deletion process.

Type boolean
Default FALSE

Deletion Options: RETAIN_REFERENCE

Description

RETAIN_REFERENCE is only applied when DELETE=YES. This option will prevent reference measures from being ignored when they are included in the MEASURELIST, CUBELIST, or determined to be invalid when CHECKVALID is used. It does not prevent them from being deleted if they are already ignored prior to running cnetedit. Note: After the deletion process, if the RETAIN_REFERENCE=YES and the reference measure is the only remaining single measure of a point and PRESERVE=NO, the entire point will be deleted. In order to gurarntee retaining a reference in this case, set both PRESERVE=YES and RETAIN_REFERENCE=YES.

Type boolean
Default False

Deletion Options: IGNOREALL

Description

If a reference measure is ignored, the whole point is ignored. If DELETE=yes, then the whole point will be deleted.

Type boolean
Default False

History

Tracie Sucharski2008-08-14 Original version
Christopher Austin2008-12-29 Added options, including EXCLUDELIST and DELETE
Christopher Austin2009-01-09 Renamed EXCLUDELIST to IGNORELIST and made other similar name changes.
Sharmila Prasad2009-07-17 Renamed IGNORELIST to FROMLIST and made other similar name changes Added options HOLD and UNHOLD Set the default as FALSE for DELETE Ignored Control Points and Measures
Sharmila Prasad2009-07-24 Renamed IGNORELIST to FROMLIST and reverted back to previous format
Sharmila Prasad2009-08-11 Set the default as FALSE for DELETE Ignored Control Points and Measures
Christopher Austin2009-08-11 Fixed an out of index bug.
Sharmila Prasad2009-08-25 Added parameter LOG to write logs into the file if explicitly stated, parameter POINTLIST to read Control Point ID's from a file reverted DELETE default to be TRUE
Sharmila Prasad2009-09-14 Added parameter PRESERVE with default FALSE. If set the Control Points with Measures equal to one are not deleted
Travis Addair2010-11-24 Added optional measure validity check, removed a redundant deletion pass, and fixed a bug causing points to be deleted before all measures had been checked.
Travis Addair2010-11-29 Changed parameter FROMLIST to CUBELIST and ALLFROMLIST to FROMLIST.
Travis Addair2010-11-30 Added progress bar for validity checking and automatic logging of the DEFFILE to the print file when entered.
Travis Addair2010-12-08 Added check to ensure that ignored reference measures are not deleted, but that the entire point is deleted instead, by setting the containing point to ignored whenever the reference is.
Travis Addair2010-12-20 Added information to the log file pertaining to each point and measure ignored/deleted with an associated reason why.
Christopher Austin2011-01-18 Altered to compile with the new Control redesign.
Sharmila Prasad2011-05-14 Validate DefFile before processing. Added ability to validate measure by sample/line residuals or Residual Magnitude
Sharmila Prasad2011-05-23 Helper function to be able to edit the Deffile.
Sharmila Prasad2011-06-02 Added option RETAIN_REFERENCE to retain reference even if not validated or if it is in the ignore CubeList
Debbie A. Cook and Tracie Sucharski2011-06-07 Changed point type "ground" to "fixed"
James Alexander Crough2011-07-13 Changed output of ignored points to show EditLocked points as ignored.
James Alexander Crough2011-07-14 Changed output again this time in order to seperate skipping EditLocked points into their own PVL objects.
Travis Addair2012-02-24 Changed from ignoring/deletion program to a series of sequential and optional operations (unlock, ignore, delete, lock). Added MEASURELIST to allow editing specific measures. Updated documentation.
Steven Lambright2012-05-03 Added "IGNOREALL" option. Fixes #293.
Kristin Berry2015-07-30 Updated so that behavior is consistent with documentation. Now when a reference measure is removed, the whole point is only removed if IGNOREALL is true. Fixes #2238.
Tyler Wilson2016-01-04 Fixed a problem with single measure points being deleted when running a validity check even when delete = false. Zero measure points are now deleted no matter what. Ref #2342.