Isis 3 Application Documentation
cnetextract | Standard View | TOC | Home |
Extracts portions of an existing Control Network
Description
Categories
Groups
History
Extracts Control Points into a new Control Network from a specified Control Network in accordance to specified filters.
A summary of the Control Points not extracted, listed by the filter which prevented them from being extracted, can be included in optional report files. See the PREFIX and filter keywords for details.
Currently, the filters are divided into four categories: Exclusive Filters, Inclusive Filters, Cube Filters, and Lat/Lon Filters.
Exclusive Filters prevent extraction. They are taken into consideration last and have the highest priority. This means that if any other filter creates a selected Exclusive Filter condition during processing, that Exclusive Filter will prevent the extraction. For example, if the Cube Filters CUBES, CUBELIST, and CUBEMEASURES are used along with the Exclusive Filter NOSINGLEMEASURES, then an input Control Point which contains only one cube in the CUBELIST will not be extracted, regardless of the number of Control Measures it had on input. This is because NOSINGLEMEASURES will see it as a Control Point with exactly one Control Measure and prevent its extraction. If only Exclusive Filters are used, all Control Points/Measures that do not have an exclusive property will be extracted.
Inclusive Filters allow extraction. They only extract Control Points and/or Measures that are included in the Inclusive Filter. In addition, each Inclusive Filter is associated with an explicit property of the Control Point/Measure. If more than one Inclusive Filter is selected, only Control Points/Measures that contain all inclusive properties will be extracted.
Cube Filters also allow extraction, however, they pertain to the cubes contained within the Control Points/Measures. Option RETAIN_REFERENCE will extract the Reference even if not in the Cube List.
Lat/Lon Filters allow extraction as well, however, they only extract Control Points/Measures that lie in the lat/lon bounding box.
Name | Description |
---|---|
FROMLIST | List of ISIS3 cubes in the input Control Network |
CNET | Input Control Network filename |
Name | Description |
---|---|
PREFIX | A string used to enable output of optional report file(s) of excluded information |
TOLIST | List of ISIS3 cubes in the output Control Network file |
ONET | Output Control Network filename |
NETWORKID | Set Networkid keyword to this value in the extracted Control Network |
DESCRIPTION | Set Description keyword to this value in the extracted Control Network. |
Name | Description |
---|---|
NOIGNORE | Do not extract ignored Control Points and ignored Control Measures |
NOMEASURELESS | Do not extract Control Points with exactly zero Control Measures |
NOSINGLEMEASURES | Do not extract Control Points with exactly one Control Measure |
Name | Description |
---|---|
REFERENCE | Only extract explicit reference Control Measures |
FIXED | Only extract fixed Control Points |
TOLERANCE | Only extract Control Points with line or sample residual greater than PIXELTOLERANCE |
PIXELTOLERANCE | Only extract Control Points with a line or sample residual greater than this value |
POINTLIST | File containing Control Point Ids which will be extracted |
Name | Description |
---|---|
CUBES | Enable extraction of Control Points/Measures based on listed cubes |
CUBELIST | Only extract Control Points containing the listed cubes |
CUBEMEASURES | Only extract Control Measures containing a cube in CUBELIST |
RETAIN_REFERENCE | Retain Reference even if not in the CUBELIST |
Name | Description |
---|---|
LATLON | Only extract Control Points in the lat/lon range |
MINLAT | Minimum Control Point Latitude |
MAXLAT | Maximum Control Point Latitude |
MINLON | Minimum Control Point Longitude |
MAXLON | Maximum Control Point Longitude |
A text file containing one column of ISIS3 cube file names. Every cube used in the input control network should be contained in this list.
Type | filename |
---|---|
File Mode | input |
Internal Default | No input cube list |
Filter | *.txt *.lis *.list |
A filename containing control network points and measures to extract the ONET from.
Type | filename |
---|---|
File Mode | input |
Filter | *.net |
A short single word string used as a prefix on output report file(s) generated based on extraction criteria entered by the user. If a PREFIX is provided, the Control Points and Control Measures not extracted will be placed into output report files with the given PREFIX. If a PREFIX is not entered, no report files will be output. See each option in the "Filter" groups to see which report files are created for each given filter.
Type | string |
---|---|
File Mode | output |
Internal Default | Prefix of NO results reports |
This optional output text file contains one column of ISIS3 cube file names associated with the ONET. This list can only include cubes that were provided in the FROMLIST.
Type | filename |
---|---|
File Mode | output |
Internal Default | No output cube list |
Filter | *.txt *.lis *.list |
The resultant Control Network file extracted from CNET.
Type | filename |
---|---|
File Mode | output |
Filter | *.net |
The Networkid keyword of the extracted Control Network will be set to this string value. The Networkid is a single word identifier or name assigned to a Control Network. This string should be unique.
Type | string |
---|---|
Internal Default | Parent Network Id |
The Description keyword of the extracted Control Network will be set to this string value. This should be a brief description of the purpose of the extracted control network.
Type | string |
---|---|
Default | cnetextracted |
When selected, all ignored Control Points and all ignored Control Measures provided by the input Control Net will not be included in the output Control Network.
When option PREFIX is used, report files [PREFIX]IgnoredPoints.txt and [PREFIX]IgnoredMeasures.txt will also be created. These files list which Control Points and Control Measures were not extracted due to this filter.
Type | boolean |
---|---|
Default | False |
When selected, all Control Points that are reduced to zero Control Measures (from other selected filters or have zero measures on input) will not be included in the output Control Network.
When option PREFIX is used, report file [PREFIX]MeasurelessPoints.txt will also be created. Each Control Point it lists was not extracted due to this filter.
Type | boolean |
---|---|
Default | False |
When selected, all Control Points that are reduced to one Control Measure (from other selected filters or only have one measure on input) will not be included in the output Control Network.
When option PREFIX is used, report file [PREFIX]SingleMeasurePoints.txt will also be created. Each Control Point it lists was not extracted due to this filter.
Type | boolean |
---|---|
Default | False |
Exclusions |
|
When selected, only explicit reference Control Measures will be extracted into the output Control Network.
When this filter is used, NOMEASURELESS will be selected automatically, and NOSINGLEMEASURES will be disabled.
When option PREFIX is used, report file [PREFIX]NonReferenceMeasures.txt will also be created. Each Control Measure it contains was not extracted due to this filter.
Type | boolean |
---|---|
Default | False |
Exclusions |
|
When selected, only fixed Control Points will be extracted into the output Control Network file.
When option PREFIX is used, report file [PREFIX]NonFixedPoints.txt will also be created. Each Control Point it lists was not extracted due to this filter.
Type | boolean |
---|---|
Default | False |
When selected, extract all Control Points which have a line or a sample residual greater than or equal to the PIXELTOLERANCE value.
The PIXELTOLERANCE is compared to the keywords LineResidual and SampleResidual in the input Control Network.
When option PREFIX is used, report file [PREFIX]TolerancePoints.txt will also be created. Each Control Point it lists was not extracted due to this filter.
Type | boolean |
---|---|
Default | False |
Inclusions |
|
Control Points which contain at least one Control Measure with a line or a sample residual error greater than or equal to this value will be extracted.
Type | double |
---|---|
Default | 10.0 |
Use this parameter to select a text file that contains a list of Control Point Ids. All the Control Points with matching Ids will be extracted as long as another selected filter does not exclude the Control Point.
When option PREFIX is used, report file [PREFIX]NonListedPoints.txt will also be created. Each Control Point it contains was not extracted due to this filter.
Type | filename |
---|---|
File Mode | input |
Internal Default | None |
Filter | *.lis |
When selected, only Control Points which contain the cubes listed in CUBELIST will be extracted.
Type | boolean |
---|---|
Default | False |
Inclusions |
|
Use this parameter to select a text file that contains a list of ISIS3 cubes. All the Control Points which contain at least one of these cubes will be extracted.
When option PREFIX is used, report file [PREFIX]NonCubePoints.txt will also be created. Each Control Point it lists was not extracted due to this filter.
Type | filename |
---|---|
File Mode | input |
Filter | *.lis |
When selected, extract all Control Measures from extracted Control Points that contain a cube in the CUBELIST list. This option can only be used when a file has been provided for CUBELIST.
When this filter is used, NOMEASURELESS will be selected automatically.
When option PREFIX is used, report file [PREFIX]NonCubeMeasures.txt will also be created. Each Control Measure it lists was not extracted due to this filter.
Type | boolean |
---|---|
Default | False |
Inclusions |
|
When selected, retain the Reference in the extracted Control Points even if it is not in the the CUBELIST list.
When this filter is used, NOMEASURELESS will be selected automatically.
When option PREFIX is used, report file [PREFIX]NonCubeMeasures.txt will also be created. It will list the Reference which is not in the list but retained because this option was selected.
Type | boolean |
---|---|
Default | False |
When selected, all Control Points that are inside of the provided latitude longitude range will be extracted. Control Points whose latitude longitude cannot be computed will not be extracted.
Fixed Points will use the lat/lon values provided in the CNET while Free Points will calculate their lat/lon from the images provided by the FROMLIST. These calculated lat/lon values will be added to Free Points in the ONET for reference purposes. No Isis application will use these added lat/lons.
When option PREFIX is used, report files [PREFIX]LatLonOutOfRange.txt and [PREFIX]NoLatLonPoint.txt will also be created. Each Control Point they list was not extracted due to this filter.
Control Points in [PREFIX]LatLonOutOfRange.txt did not fall within the provided lat/lon bound. Each Control Points listed in [PREFIX]NoLatLonPoint.txt do not have a determinable Latitude or Longitude.
Note: This option is expensive.
Type | boolean |
---|---|
Default | False |
Inclusions |
|
Any Control Point with a latitude less than MINLAT will be removed.
Type | double |
---|---|
Default | -90.0 |
Minimum | -90.0 (inclusive) |
Maximum | 90.0 (inclusive) |
Any Control Point with a latitude greater than MAXLAT will be removed.
Type | double |
---|---|
Default | 90.0 |
Minimum | -90.0 (inclusive) |
Maximum | 90.0 (inclusive) |
Greater Than or Equal |
|
Any Control Point with a longitude less than MINLON will be removed.
If MINLON is greater than MAXLON than the longitude range is assumed to cross the 0/360 longitude boundry, where points with longitude greater than MINLON or less than MAXLON will be included.
Type | double |
---|---|
Default | 0.0 |
Minimum | 0.0 (inclusive) |
Maximum | 360.0 (inclusive) |
Any Control Point with a longitude greater than MAXLON will be removed.
If MAXLON is less than MINLON than the longitude range is assumed to cross the 0/360 longitude boundry, where points with longitude greater than MINLON or less than MAXLON will be included.
Type | double |
---|---|
Default | 360.0 |
Minimum | 0.0 (inclusive) |
Maximum | 360.0 (inclusive) |
Christopher Austin | 2009-07-22 | Original version |
Christopher Austin | 2009-07-31 | Refactored for readability, added parameter defaults, and added detail to the application log. |
Christopher Austin | 2009-08-11 | Added an additional output progress bar. |
Christopher Austin | 2009-08-21 | Added the points kept to the print file. |
Christopher Austin | 2009-08-28 | Fixed TOLIST blank lines, added the POINTLIST option, and changed the CUBEPOINTS parameter to take a filename instead of a boolean. |
Christopher Austin | 2009-09-29 | Added the TOLERANCE parameter. |
Christopher Austin | 2009-10-02 | Changed the TOLERANCE keyword to extract points with an error greater than or equal to the TOLERANCE, instead of less than or eqaul to. |
Christopher Austin | 2009-10-15 | Fixed the TOLERANCE code. |
Christopher Austin | 2009-11-02 | Fixed the interface to be more clear. |
Christopher Austin | 2009-11-09 | Added the GROUND parameter. |
Christopher Austin | 2010-01-20 | Added the USENETWORK parameter to avoid the need for spiceinit prior to knowing which cubes are necessary for the extracted control network. |
Christopher Austin | 2010-02-01 | FROMLIST is now an option parameter, however, to be able to generate a TOLIST, the FROMLIST must be provided. Also did some code cleanup. |
Christopher Austin | 2010-03-01 | Changed NOSINGLEMEASURES to NOMEASURELESS and fixed a simple progress bug. |
Christopher Austin | 2010-03-03 | Fixed min/max lat/lon bounding issues. |
Christopher Austin | 2010-03-08 | Brought back NOSINGLEMEASURES while leaving NOMEASURELESS as is. |
Christopher Austin | 2010-06-18 | Added PREFIX and moved all detailed output from the print.prt to the PREFIX files for each filter parameter. |
Christopher Austin | 2010-06-30 | Rewrote documentation and reorganized keywords into groups. |
Christopher Austin | 2010-11-08 | Fixed for binary cnet conversion. |
Christopher Austin | 2011-01-18 | Altered to compile with the new Control redesign. |
Jai Rideout | 2011-04-12 | Changed OUTNET to ONET for consistency. |
Sharmila Prasad | 2011-05-27 | Added an option RETAIN_REFERENCE to extract the Reference measure even if it is not in the CUBELIST |
Debbie A. Cook and Tracie Sucharski | 2011-06-07 | Change point types "Ground" to "Fixed" and "Tie" to "Free". |
Stuart Sides | 2011-10-07 | Added documentation with Annie Howington-Kraus and Ella Lee. |