Home
About Isis
Support
Download

Isis 3

Documentation
Tutorials
Technical Documents

Isis 2

Documentation
Tutorials
Technical Documents

Search

USGS

Isis 3 Application Documentation


cnetedit

Printer Friendly View | TOC | Home

Edits Control Networks

Overview Parameters

Description

This application edits Control Networks by setting the "ignored" status of Control Points and Measures based on user-specified criteria, then optionally deleting them. The user-specified criteria includes ignoring points in a given list, ignoring measures in a given list, and ignoring measures with attributes failing to meet the requirements defined by a definition file. Additional options include the ability to preserve points with less than a single valid measure, ability to retain the Reference even if not validated or exists in the Ignore Cube List 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.

Parameter Groups

Files

Name Description
CNET Input control network
ONET Output control network
LOG Log the control network

Ignore Lists

Name Description
POINTLIST File contains Point Ids which will be ignored if matched in the Control Network
CUBELIST File contains Cube file names from which Serial #'s are generated and matching Control Measures will be ignored in the Control Network.

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

Output Options

Name Description
DELETE Delete Ignored Points and Measures
PRESERVE Preserve Points with Measures equal to One
RETAIN_REFERENCERetain Reference even if not Validated or not in CUBELIST
X

Files: CNET


Description

This file is a control network generated from programs such as autoseed or qnet.

Type filename
File Mode input
Filter *.net
Close Window
X

Files: ONET


Description

The file will contain the updated control network with edits.

Type filename
File Mode output
Filter *.net
Close Window
X

Files: LOG


Description

If this file is entered then the log will be outputted to this file

Type filename
File Mode output
Internal Default None
Filter *.*
Close Window
X

Ignore Lists: POINTLIST


Description

Use this parameter to select the filename which contains a list of point ids. All the Control Points with matching Ids will be ignored. If DELETE is also set to true, all the ignored control measures and points will be deleted.

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

Ignore Lists: CUBELIST


Description

Use this parameter to select the filename which contains a list of cubes. All of the Control Measures matching the serial # of the cube will be ignored. If DELETE is also set to true, the ignored control measures and points will be deleted.

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

Validity Check: CHECKVALID


Description

If set to true, 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
Close Window
X

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

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

Output Options: DELETE


Description

This option deletes all ignored Control Measures and Control Points. If any Control Point results in less than 2 Control Measures, that Control Point will be deleted as well.

Type boolean
Default TRUE
Close Window
X

Output Options: PRESERVE


Description

This option preserves Control Points with Control Measures equal to one.

Type boolean
Default FALSE
Close Window
X

Output Options: RETAIN_REFERENCE


Description

When true, retain the Reference even if not validated by the DefFile and/or if it is in the Ignore List CUBELIST.

Type boolean
Default False
Close Window