Select (Coverage)

Summary

Extracts selected features from an input coverage and stores them in the output coverage.

Features are selected for extraction based on logical expressions or by applying the criteria contained in a selection file. Any item, including redefined items, in the specified feature attribute table of the Input coverage can be used.

Usage

• When using the same input coverage and output coverage for feature classes Anno, Section, Route, or Region, the output feature class subclass name must be different from the input feature class subclass name.

• Use of indexed items can speed up the logical selection process. You can use the Index Item tool to create an attribute index.

• The same subclass names may be specified when the Output coverage is not the same as the Input coverage.

• Learn more about How to Build an INFO Query

Syntax

Reselect_arc (in_cover, out_cover, info_express, {in_feature_type}, {selection_file}, {out_feature_type})

Parameter	Explanation	Data Type
in_cover	The input coverage containing the features that will be selected.	Coverage
out_cover	The output coverage containing the selected features.	Coverage
info_express [info_express,...]	Write a query that contains one or more logical expressions to select features from the input coverage. Each expression takes one of the following forms: RESELECT <expression>—Reduces the selected set of records with a selection expression to those that meet its criteria. If no selection expression follows, the selected set will be empty. ASELECT <expression>—Adds unselected records that meet the selection expression criteria to the currently selected set. If no selection expression follows, the selected set will contain all features. NSELECT—Reverses the current selection to the unselected set.	INFO Expression
in_feature_type (Optional)	The feature class to select: Poly —Polygons are reselected using PAT item values. Line —Arcs are reselected using AAT item values. Point —Points are reselected using PAT item values. Anno.<subclass> —Annotation from the specified subclass is reselected using TAT subclass item values. Route.<subclass> —Routes from the specified subclass are reselected using RAT subclass item values. Section.<subclass> —Sections from the specified subclass are reselected using SEC subclass item values. Region.<subclass> —Regions from the specified subclass are reselected using the region PAT subclass item values.	String
selection_file (Optional)	A preexisting file that identifies the features to select.	File
out_feature_type (Optional)	The feature class in the output coverage. This must be the same as that of the input feature class, with this exception: When the input feature class is an Anno, Route, Section, or Region subclass and the output coverage is the same as the Input coverage, the output feature class must have a different subclass name.	String

Code Sample

Reselect example (stand-alone script)

The following stand-alone script demonstrates how to select features from a coverage.

# Name: Reselect_Example.py
# Description: Selects streams of interest from a larger stream coverage
# Requirements: ArcInfo Workstation
# Author: ESRI

# Import system modules
import arcpy
from arcpy import env

# Set environment settings
env.workspace = "C:/data"

# Set local variables
inCover = "stream"
outCover = "C:/output/studystreams"
infoExpress = ["RESELECT stream_name CN 'AQUEDUCT'",
               "NSELECT",
               "RESELECT stream_order > 3",
               "ASELECT length > 10000"]
inFeatureType = "LINE"

# Execute Reselect
arcpy.Reselect_arc(inCover, outCover, infoExpress, inFeatureType, "", "")

Environments

Current Workspace, Level Of Comparison Between Projection Files, Precision For Derived Coverages, Precision For New Coverages, Scratch Workspace

Licensing Information

ArcView: No

ArcEditor: No

ArcInfo: Requires ArcInfo Workstation installed