ISIS Documentation

cnetedit

Edit control networks

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

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.