Resumen
Calcula una intersección geométrica de las entidades de entrada. Las entidades o partes de entidades que se superponen con todas las capas o clases de entidad se escriben en la clase de entidad de salida.
Existe una herramienta alternativa para las operaciones de intersección. Consulte la documentación de la herramienta Intersecar por pares para obtener más detalles.
La herramienta Intersecar por pares es similar a la herramienta Intersecar en cuanto a que se calculan las intersecciones geométricas, pero es distinta en cuanto a que las intersecciones se calculan por pares de entidades en vez de por todas las combinaciones de entidades.
Ilustración
Uso
El valor del parámetro Entidades de Entrada debe contener entidades simples: punto, multipunto, línea o polígono. No pueden ser entidades complejas tales como entidades de anotación, entidades de dimensión o entidades de red.
Si las entradas tienen diferentes tipos de geometría (es decir, línea sobre polígono, punto sobre línea, etc.), el tipo de geometría de la Clase de Entidad de Salida se establecerá de manera predeterminada igual que el tipo de geometría Entidades de Entrada, con la geometría de dimensión inferior. Por ejemplo, si una o más de las entradas es de tipo punto, la salida predeterminada será de punto; si una o más de las entradas es de línea, la salida predeterminada será de línea; y si todas las entradas son de polígono, la salida predeterminada será de polígono.
El valor del parámetro Tipo de Salida puede ser el del parámetro Entidades de Entrada con la geometría de dimensión inferior o menor. Por ejemplo, si todas las entradas son polígonos, la salida puede ser de polígono, línea o punto. Si una de las entradas es del tipo línea y ninguna es de punto, la salida puede ser de línea o de punto. Si cualquiera de las entradas es de punto, el valor Tipo de salida solo puede ser de punto.
Los valores de atributo de las clases de entidad de entrada se copiarán a la clase de entidad de salida. Sin embargo, si la entrada hay capas creadas por la herramienta Crear capa de entidades y el campo Utilizar política de relación está activado, se calculará una proporción del valor del atributo de entrada para el valor del atributo de salida. Cuando se habilita Utilizar política de relación, siempre que se divida una entidad en una operación de superposición, los atributos de las entidades resultantes son una relación del valor de atributo de la entidad de entrada. El valor de salida está basado en la relación en la que se dividió la geometría de la entidad de entrada. Por ejemplo, si la geometría de entrada se dividió equitativamente, al valor de atributo de cada entidad nueva se le asigna la mitad del valor de atributo de la entidad de entrada. Utilizar política de relación solo se aplica a los tipos de campos numéricos.
Precaución:
Las herramientas de geoprocesamiento no cumplen las políticas de división de campos de tabla o clases de entidad de geodatabase.
Esta herramienta utilizará un proceso de ordenamiento en tesela para controlar datasets muy grandes para mejorar el rendimiento y la escalabilidad. Para obtener más detalles, consulte Geoprocesamiento con datasets grandes.
Esta herramienta respeta el entorno de Factor de procesamiento en paralelo. Si no se establece el entorno (valor predeterminado) o si se establece en 0, se desactivará el procesamiento en paralelo. Configurar el entorno a 100 desactiva el procesamiento en paralelo.
En estos momentos, Procesamiento en paralelo es compatible con las operaciones de polígono sobre polígono, línea sobre polígono y punto sobre superposición poligonal.
Licencia:
Con las licencias de ArcGIS Desktop Basic y Desktop Standard, la cantidad de capas o clases de entidad de entrada se limita a dos.
Sintaxis
arcpy.analysis.Intersect(in_features, out_feature_class, {join_attributes}, {cluster_tolerance}, {output_type})| Parámetro | Explicación | Tipo de datos |
in_features [[in_features, {Rank}],...] | Una lista de las capas o clases de entidad de entrada. Cuando la distancia entre las entidades es menor que la tolerancia clúster, las entidades con la clasificación más baja se alinearán con la entidad con la clasificación más alta. La clasificación más alta es 1. Para obtener más información, consulte Clasificaciones de prioridad y herramientas de Geoprocesamiento. | Value Table |
out_feature_class | La clase de entidad de salida. | Feature Class |
join_attributes (Opcional) | Especifica qué atributos de las entidades de entrada se transferirán a la clase de entidad de salida.
| String |
cluster_tolerance (Opcional) | La distancia mínima que separa todas las coordenadas de entidades (nodos y vértices), así como también la distancia que se puede mover una coordenada en X o en Y (o en los dos). Precaución:El cambio del valor de este parámetro puede generar un fallo o resultados inesperados. Se recomienda no modificar este parámetro. Se ha eliminado de la vista en el cuadro de diálogo de la herramienta. Se utiliza de forma predeterminada la propiedad tolerancia x,y de referencia espacial de la clase de entidad de entrada. | Linear Unit |
output_type (Opcional) | Especifica el tipo de intersecciones que se devolverán.
| String |
Muestra de código
El siguiente script de la ventana de Python demuestra cómo utilizar la función Intersect en modo inmediato.
import arcpy
arcpy.env.workspace = "C:/data/RedRiver_basin.gdb"
arcpy.Intersect_analysis(["vegetation_stands", "road_buffer200m", "water_buffer100"], "mysites", "ALL")
arcpy.Intersect_analysis([["vegetation_stands", 2], ["road_buffer200m", 1], ["water_buffer100", 2]],
"mysites_ranked", "ALL")El siguiente script independiente utiliza la función Intersect como parte de un flujo de trabajo con otras herramientas de análisis para determinar el tipo de vegetación a menos de 100 metros de todos los cruces de la corriente.
#Name: VegRoadIntersect.py
# Purpose: Determine the type of vegetation within 100 meters of all stream
# crossings
# Import system modules
import arcpy
# Set the workspace (to avoid having to type in the full path to the data every
# time)
arcpy.env.workspace = "c:/data/data.gdb"
# Process: Find all stream crossings (points)
inFeatures = ["roads", "streams"]
intersectOutput = "stream_crossings"
arcpy.Intersect_analysis(inFeatures, intersectOutput, "", "", "point")
# Process: Buffer all stream crossings by 100 meters
bufferOutput = "stream_crossings_100m"
bufferDist = "100 meters"
arcpy.Buffer_analysis(intersectOutput, bufferOutput, bufferDist)
# Process: Clip the vegetation feature class to stream_crossing_100m
clipInput = "vegetation"
clipOutput = "veg_within_100m_of_crossings"
arcpy.Clip_analysis(clipInput, bufferOutput, clipOutput)
# Process: Summarize how much (area) of each type of vegetation is found
# within 100 meters of the stream crossings
statsOutput = "veg_within_100m_of_crossings_stats"
statsFields = [["shape_area", "sum"]]
caseField = "veg_type"
arcpy.Statistics_analysis(clipOutput, statsOutput, statsFields, caseField)Entornos
Información de licenciamiento
- Basic: Limitado
- Standard: Limitado
- Advanced: Sí