Seleccionar capa por ubicación (Administración de datos)

Resumen

Selecciona entidades en una capa con base en una relación espacial con las entidades de otra capa.

Cada entidad de la Capa de entidades de entrada se evalúa con las entidades de la capa o clase de entidad Seleccionando entidades; si se cumple la Relación especificada, se selecciona la entidad de entrada.

Ejemplos gráficos de relaciones

Uso

• La entrada debe ser una capa de entidades y no una clase de entidad.

• Las entradas válidas para esta herramienta funciona sobre capas en la tabla de contenido de ArcMap, ArcGlobe o ArcScene y también sobre capas creadas en ArcCatalog o en secuencias de comandos con la herramienta Crear capa de entidades.

• El sistema de coordenadas en el que se evalúa la relación espacial puede afectar el resultado. Es posible que las entidades que se intersectan en un sistema de coordenadas se intersecten o no entre ellas.

  • Esta herramienta evalúa la relación espacial en el sistema de coordenadas de la fuente de datos de la Capa de entidades de entrada (la clase de entidad en el disco). Configurar el entorno del sistema de coordenadas de salida para evaluar la relación espacial en un sistema de coordenadas diferente.
  • Las herramientas Seleccionar por ubicación disponibles en el menú Selección de ArcMap, ArcScene y ArcGlobe evalúan la relación espacial en el sistema de coordenadas de la visualización de esa aplicación (el marco de datos actual). Para que la herramienta de geoprocesamiento coincida con este comportamiento (y obtenga resultados idénticos), establezca elentorno del sistema de coordenadas de salida en Como la visualización.

• Esta herramienta puede utilizarse para seleccionar entidades según sus relaciones espaciales con otras entidades dentro de la misma capa. Para obtener algunos ejemplos consulte: Seleccionar por ubicación dentro de una capa

• La herramienta Obtener contador puede utilizarse para encontrar el número de entidades seleccionadas por la herramienta Seleccionar capa por ubicación. Esto puede ser útil para determinar si cualquiera de las entidades coincide con la relación espacial deseada antes de continuar con más análisis como parte de un flujo de trabajo automatizado (es decir, secuencia de comandos o modelo).

• Para obtener más información sobre el uso de relaciones espaciales tridimensionales (INTERSECT_3D y WITHIN_A_DISTANCE_3D), consulte Seleccionar por ubicación: relaciones 3D.

Sintaxis

SelectLayerByLocation_management (in_layer, {overlap_type}, {select_features}, {search_distance}, {selection_type})

Parámetro	Explicación	Tipo de datos
in_layer	Capa que contiene las entidades que serán evaluadas con la capa Seleccionando entidades. Se aplicará la selección a esta capa. La entrada puede ser una capa de la tabla de contenido de ArcMap o una capa creada en ArcCatalog, o en secuencias de comandos con la herramienta Crear capa de entidades. La entrada no puede ser la ruta a una clase de entidad del disco.	Feature Layer; Mosaic Layer; Raster Catalog Layer
overlap_type (Opcional)	Relación espacial que se evaluará. INTERSECT —Las entidades en la capa de entrada se seleccionarán si intersecan con una entidad seleccionada. Esta es la opción predeterminada. INTERSECT_3D —Las entidades de la capa de entrada se seleccionarán si intersecan con una entidad seleccionada en el espacio tridimensional (x, y, z). WITHIN_A_DISTANCE —Las entidades en la capa de entrada se seleccionarán si se encuentran dentro de una distancia especificada de la entidad seleccionada. Especifique una distancia en el parámetro Distancia de búsqueda. WITHIN_A_DISTANCE_3D —Las entidades en la capa de entrada se seleccionarán si se encuentran dentro de una distancia especificada de una entidad seleccionada en el espacio tridimensional. Especifique una distancia en el parámetro Distancia de búsqueda. CONTAINS —Las entidades en la capa de entrada se seleccionarán si contienen a una entidad seleccionada. Las entidades de entrada deben ser polígonos. COMPLETELY_CONTAINS —Las entidades en la capa de entrada se seleccionarán si contienen completamente a una entidad seleccionada. Las entidades de entrada deben ser polígonos. CONTAINS_CLEMENTINI —Esta relación espacial produce los mismos resultados que COMPLETELY_CONTAINS con una excepción. Si la entidad de selección está completamente en el límite de la entidad de entrada (ninguna parte está correctamente dentro o fuera), la entidad no estará seleccionada. CLEMENTINI define el polígono de límite como la línea que separa el interior del exterior, el límite de una línea se define como sus extremos y el límite de un punto siempre está vacío. WITHIN —Las entidades de la capa de entrada se seleccionarán si se encuentran dentro de una entidad seleccionada. Las entidades de la selección deben ser polígonos. COMPLETELY_WITHIN —Las entidades de la capa de entrada se seleccionarán si están completamente dentro o contenidas por una entidad seleccionada. Las entidades de la selección deben ser polígonos. WITHIN_CLEMENTINI —El resultado será idéntico a WITHIN excepto si la totalidad de la entidad de la capa de entrada está sobre el límite de la entidad en la capa seleccionada; en este caso, no se seleccionará la entidad. CLEMENTINI define el polígono de límite como la línea que separa el interior del exterior, el límite de una línea se define como sus extremos y el límite de un punto siempre está vacío. ARE_IDENTICAL_TO —Las entidades de la capa de entrada se seleccionarán si son idénticas (en geometría) a una entidad seleccionada. BOUNDARY_TOUCHES —Las entidades de la capa de entrada se seleccionarán si tienen un límite que toca a una entidad seleccionada. Las entidades de la selección y las entidades de entrada y deben ser líneas o polígonos. Además, la entidad de la capa de entrada debe estar completamente dentro o fuera del polígono de la capa seleccionada. SHARE_A_LINE_SEGMENT_WITH —Las entidades de la capa de entrada se seleccionarán si comparten un segmento de línea con una entidad seleccionada. Las entidades de la selección y las entidades de entrada y deben ser líneas o polígonos. CROSSED_BY_THE_OUTLINE_OF —Las entidades de la capa de entrada se seleccionarán si las cruza el contorno de una entidad seleccionada. Las entidades de la selección y las entidades de entrada y deben ser líneas o polígonos. Si se utilizan polígonos para la capa de entrada o seleccionada, se utilizarán los límites (las líneas) del polígono. Se seleccionarán las líneas que se cruzan en un punto, no las que comparten un segmento de línea. HAVE_THEIR_CENTER_IN —Las entidades de la capa de entrada se seleccionarán si su centro cae dentro de una entidad seleccionada. El centro de la entidad se calcula de la siguiente manera: para los polígonos y los multipuntos se utiliza el centroide de la geometría y para la entrada de línea se utiliza el punto medio de la geometría. CONTAINED_BY —Esto proporciona el mismo resultado que WITHIN. Se mantiene CONTAINED_BY para permitir la compatibilidad con modelos y secuencias de comandos creados en versiones anteriores a ArcGIS 9.3.	String
select_features (Opcional)	Las entidades de la Capa de entidades de entrada se seleccionarán según su relación con las entidades de esta capa o clase de entidad.	Feature Layer
search_distance (Opcional)	Este parámetro sólo es válido si el parámetro Relación se establece en uno de los siguientes: WITHIN_A_DISTANCE, WITHIN_A_DISTANCE_3D, INTERSECT, INTERSECT_3D, HAVE_THEIR_CENTER_IN, CONTAINS, o WITHIN.	Linear unit
selection_type (Opcional)	Determina cómo se aplicará la selección a la entrada y cómo combinarla con una selección existente. Tenga en cuenta que aquí no hay una opción para borrar una selección existente. Para borrar una selección, utilice la opción CLEAR_SELECTION de la herramienta Seleccionar capa por atributo. NEW_SELECTION —La selección resultante reemplaza toda selección existente. Esta es la opción predeterminada. ADD_TO_SELECTION —La selección resultante se agrega a una selección existente, si corresponde. Si no existe ninguna selección, es lo mismo que la opción NEW_SELECTION. REMOVE_FROM_SELECTION —La selección resultante se quita de una selección existente. Si no existe una selección, la operación no tendrá efecto. SUBSET_SELECTION —La selección resultante se combina con una selección existente. Sólo permanecen seleccionados los registros comunes a ambas selecciones. SWITCH_SELECTION —Cambia la selección. Todos los registros seleccionados se quitan de la selección y todos los registros no seleccionados se agregan a la selección. Cuando se selecciona esta opción, se ignoran los parámetros Seleccionando entidades y Relación.	String

Ejemplo de código

Ejemplo 1 de SelectLayerByLocation (ventana de Python)

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

import arcpy  # First, make a layer from the feature class arcpy.MakeFeatureLayer_management("c:/kamsack.gdb/parcel", "parcel_lyr")  # Then add a selection to the layer based on location to features in another feature class  arcpy.SelectLayerByLocation_management ("parcel_lyr", "have_their_center_in", "c:/kamsack.gdb/city_limits")

Ejemplo 2 de SelectLayerByLocation (secuencia de comandos independiente)

La siguiente secuencia de comandos independiente muestra cómo utilizar la función SelectLayerByLocation en un flujo de trabajo para extraer entidades en una nueva clase de entidad basada en la ubicación y en una consulta de atributos.

# Name: ExtactFeaturesByLocationAndAttribute.py # Description: Extract features to a new feature class based on a Location and an attribute query  # Import arcpy and set path to data import arcpy arcpy.env.workspace = "c:/data/mexico.gdb"  # Make a layer and select cities which overlap the chihuahua polygon arcpy.MakeFeatureLayer_management('cities', 'cities_lyr')  arcpy.SelectLayerByLocation_management('cities_lyr', 'intersect', 'chihuahua')   # Within the previous selection sub-select cities which have population > 10,000 arcpy.SelectLayerByAttribute_management('cities_lyr',                                          'SUBSET_SELECTION', '"population" > 10000')  # If features matched criteria write them to a new feature class matchcount = int(arcpy.GetCount_management('cities_lyr').getOutput(0))  if matchcount == 0:     print('no features matched spatial and attribute criteria') else:     arcpy.CopyFeatures_management('cities_lyr', 'chihuahua_10000plus')     print('{0} cities that matched criteria written to {0}'.format(                                                   matchcount, chihuahua_10000plus))

Entornos

Espacio de trabajo actual, Sistema de coordenadas de salida

Información sobre licencias

ArcGIS for Desktop Basic: Sí

ArcGIS for Desktop Standard: Sí

ArcGIS for Desktop Advanced: Sí