JavaScript is not enabled. Please enable JavaScript for this site or view Printer Friendly version of this document.

Isis 3

Technical Documents

Isis 2

Technical Documents

Search

Isis 3 Application Documentation

cnetextract

Printer Friendly View | TOC | Home

Extracts portions of an existing Control Network

Overview

Parameters

Description

Extracts Control Points into a new Control Network from a specified Control Network in accordance to specified filters. A results group will be recorded, including the Control Points removed during extraction, as well as all of the Control Points which had Control Measures removed from them. In addition, Control Points extracted as well as a summary of the results group are both included in the record.

Categories

Control Networks

History

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.

Parameter Groups

Input Files

Name	Description
FROMLIST	List of ISIS3 input cubes in the Control Network
CNET	Isis3 input Control Network file

Output

Name	Description
TOLIST	List of ISIS3 output cubes
OUTNET	Isis3 output Control Network file
NETWORKID	Name of the extracted Control Network
DESCRIPTION	The description of the extracted network.

Filters

Name	Description
NOIGNORE	Remove ignored points when extracting the Control Net
NOHELD	Remove held points when extracting the Control Net
NOSINGLEMEASURE	Remove Control Points with one Control Measure
REFERENCE	Extract reference Control Measures
CUBEPOINTS	Extract Control Points containing these input cube
CUBEMEASURES	Extract Control Measures containing an input cube
POINTLIST	File containing Control Point Ids which will be extracted
LATLON	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

X

Input Files: FROMLIST

Description

A text file containing one column of ISIS3 cube file names. Every file used in the match point file should be represented in this list.

Type	filename
File Mode	input
Filter	.txt .lis *.list

X

Input Files: CNET

Description

Use this parameter to specify the control network file to extract the OUTNET from.

Type	filename
File Mode	input
Filter	*.net

X

Output: TOLIST

Description

This text file contains one column of ISIS3 cube file names associated with the OUTNET. This list can only include cubes that were privided in the FROMLIST.

Type	filename
File Mode	output
Filter	.txt .lis *.list

X

Output: OUTNET

Description

The resultant Control Network extracted from CNET.

Type	filename
File Mode	output
Filter	*.net

X

Output: NETWORKID

Description

The ID or name of the extracted Control Network. This string should be unique.

Type	string
Internal Default	Parent Network Id

X

Output: DESCRIPTION

Description

A string describing purpose of this extracted control network.

Type	string
Default	cnetextracted

X

Filters: NOIGNORE

Description

When true, all ignored Control Points and all ignored Control Measures provided by the Control Net will be removed. The keywords IgnoredPoints and IgnoredMeasures will be logged when using this option. They depict which Control Points and Control Measures were not extracted due to this filter.

Type	boolean
Default	False

X

Filters: NOHELD

Description

When true, all held Control Points in the Control Net will be removed. The keyword HeldPoints will be logged when using this option. Each Control Point it contains was not extracted due to this filter.

Type	boolean
Default	False

X

Filters: NOSINGLEMEASURE

Description

When true, all Control Points that are reduced to zero or one Control Measure (from other selected filters) will not be included in the output Control Network. The keyword SingleMeasurePoints will be logged when using this option. Each Control Point it contains was not extracted due to this filter.

Type	boolean
Default	False
Exclusions	REFERENCE

X

Filters: REFERENCE

Description

When true, only reference Control Measures will be extracted into the output Control Net. This option cannot be used in conjunction with the NOSINGLEMEASURE option since there is only a single reference measure in any Control Point. The keyword NonReferenceMeasures will be logged when using this option. Each Control Measure it contains was not extracted due to this filter.

Type	boolean
Default	False
Exclusions	NOSINGLEMEASURE

X

Filters: CUBEPOINTS

Description

Use this parameter to select the filename which contains a list of cubes. All the Control Points which contain at least on of these cubes will be extracted. The keyword NonCubePoints will be logged when using this option. Each Control Point it contains was not extracted due to this filter.

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

X

Filters: CUBEMEASURES

Description

When true, remove all Control Measures from extracted Control Points which do not contain a cube from the CUBEPOINTS list. This option can only be used when a file has been provided for CUBEPOINTS. The keyword NonCubeMeasures will be logged when using this option. Each Control Measure it contains was not extracted due to this filter.

Type	boolean
Default	False

X

Filters: 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 extracted as long as another seleted filter does not exclude the Control Point. The keyword NonListedPoints will be logged when using this option. Each Control Point it contains was not extracted due to this filter.

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

X

Filters: LATLON

Description

When true, all Control Points that are outside of the provided latitude longitude range will be removed. Control Points whos latitude longitude cannot be computed will be removed. Ground Points will use the lat/lon values provided in the CNET while Tie Points will calculate their lat/lon from the images provided by the FROMLIST. These calculated lat/lon values will be added to Tie Point in the OUTNET for reference purposes. No Isis application will use these added Control Point keywords. The keywords LatLonOutOfRange and NoLatLonPoints will be logged when using this option. Each Control Point they contain were not extracted due to this filter, were LatLonOutOfRange is the Control Points who did not fall within the provided range, and NoLatLonPoints were the Control Points for which a Latitude and Longitude could not be determined. Note: This option is expensive.

Type	boolean
Default	False
Inclusions	MINLAT MAXLAT MINLON MAXLON

X

Filters: MINLAT

Description

Any Control Point with a latitude less than LATMIN will be removed.

Type	double
Default	-90.0

X

Filters: MAXLAT

Description

Any Control Point with a latitude greater than LATMAX will be removed.

Type	double
Default	90.0

X

Filters: MINLON

Description

Any Control Point with a longitude less than LONMIN will be removed. If MINLON is greater than MAXLON than the latitude range is assumed to cross the 0/360 latitude boundry, where points with latitudes greater than MINLON or less than MAXLON will be included.

Type	double
Default	0.0

X

Filters: MAXLON

Description

Any Control Point with a longitude greater than LONMAX will be removed. If MAXLON is less than MINLON than the latitude range is assumed to cross the 0/360 latitude boundry, where points with latitudes greater than MINLON or less than MAXLON will be included.

Type	double
Default	360.0