Seleccionar (Análisis)

Resumen

Extrae entidades de una clase de entidad de entrada o una capa de entidades de entrada, generalmente mediante una expresión de selección o SQL y las almacena en una clase de entidad de salida.

Uso

  • La expresión de selección o SQL se construye con el Generador de consultas o se escribe. Para obtener información detallada sobre la sintaxis de la expresión, consulte Introducción a las expresiones de consulta o Referencia de SQL para las expresiones de consulta utilizadas en ArcGIS.

  • Si se utiliza una capa para el valor del parámetro Entidades de entrada y no se introduce ninguna expresión, solo se escribirán las entidades seleccionadas en la clase de entidad de salida. Si se utiliza una capa con una selección para el valor del parámetro Entidades de entrada y se especifica un valor de parámetro Expresión, dicha expresión solo se ejecutará en las entidades seleccionadas, y el subconjunto basado en la expresión del conjunto seleccionado se escribirá en la clase de entidad de salida. Si las entidades seleccionadas no contienen entidades que coincidan con la expresión, en la salida solo se escribirán las entidades del conjunto seleccionado.

  • Si ya tiene una capa con un conjunto seleccionado de entidades, use la herramienta Copiar entidades para crear una clase de entidad.

Parámetros

EtiquetaExplicaciónTipo de datos
Entidades de entrada

Capa o clase de entidad de entrada de la que se seleccionan las entidades.

Feature Layer
Clase de entidad de salida

La clase de entidad de salida que se creará. Si no se utiliza ninguna expresión, la salida contendrá todas las entidades de entrada.

Feature Class
Expresión
(Opcional)

Una expresión SQL utilizada para seleccionar un subconjunto de entidades.

SQL Expression

arcpy.analysis.Select(in_features, out_feature_class, {where_clause})
NombreExplicaciónTipo de datos
in_features

Capa o clase de entidad de entrada de la que se seleccionan las entidades.

Feature Layer
out_feature_class

La clase de entidad de salida que se creará. Si no se utiliza ninguna expresión, la salida contendrá todas las entidades de entrada.

Feature Class
where_clause
(Opcional)

Expresión SQL que se utilizará para seleccionar un subconjunto de entidades. Para obtener más información sobre la sintaxis SQL, consulte Referencia SQL para las expresiones de consulta utilizadas en ArcGIS.

SQL Expression

Muestra de código

Ejemplo 1 de Seleccionar (ventana de Python)

La siguiente secuencia de comandos de la ventana de Python muestra cómo utilizar la función Select de modo inmediato.

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.analysis.Select("majorrds.shp", "C:/output/majorrdsClass4.shp", '"CLASS" = \'4\'')
Ejemplo 2 de Seleccionar (script independiente)

La siguiente secuencia de comandos Pythonindependiente muestra cómo utilizar la función Select en una secuencia de comandos independiente.


# Name: Select_Example2.py
# Description: Select roads of Class 4 from major roads in the gnatcatcher habitat study area

# Import system modules
import arcpy

# Set workspace
arcpy.env.workspace = "C:/data"

# Set local variables
in_features = "majorrds.shp"
out_feature_class = "C:/output/majorrdsClass4.shp"
where_clause = '"CLASS" = \'4\''

# Run Select
arcpy.analysis.Select(in_features, out_feature_class, where_clause)

Información de licenciamiento

  • Basic: Sí
  • Standard: Sí
  • Advanced: Sí

Temas relacionados