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

Syntax

Reselect_arc (in_cover, out_cover, info_express, {in_feature_type}, {selection_file}, {out_feature_type})
ParameterExplanationData 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:

  • PolyPolygons are reselected using PAT item values.
  • LineArcs are reselected using AAT item values.
  • PointPoints 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

Related Topics

Licensing Information

ArcView: No
ArcEditor: No
ArcInfo: Requires ArcInfo Workstation installed

Published 6/8/2010