Resumen
Calcula una intersección geométrica de las entidades de entrada. Las entidades o partes de entidades que se superponen en todas las capas y/o clases de entidad se escriben en la clase de entidad de salida.
Ilustración
Uso
Las Entidades de Entrada deben ser 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 en la misma que las 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 Tipo de Salida puede ser el de las Entidades de Entrada con la geometría de dimensión inferior o menor. Por ejemplo, si todas las entradas son polígonos, el resultado podría 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 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ó por igual, el valor del atributo de cada nueva entidad recibirá la mitad del valor del atributo de la entidad de entrada. Utilizar política de relación solo se aplica a los tipos de campos numéricos.
Esta herramienta utilizará un proceso de ordenamiento en tesela para controlar datasets muy grandes para mejorar el rendimiento y la escalabilidad. Para obtener información más detallada, vea Geoprocesamiento con datasets grandes.
Sintaxis
Intersect_analysis (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 cluster, 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 uno. Para obtener más información, vea Clasificaciones de prioridad y herramientas de Geoprocesamiento. | Value Table |
out_feature_class | La clase de entidad de salida. | Feature Class |
join_attributes (Opcional) | Determina 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), como también la distancia que se puede mover una coordenada en X o en Y (o en los dos). | Linear unit |
output_type (Opcional) | Elija qué tipo de intersección desea buscar.
| String |
Ejemplo de código
Ejemplo de Intersecar (Ventana de Python)
La siguiente secuencia de comandos de la ventana de Python demuestra cómo utilizar la función Intersecar 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", "", "")
Ejemplo 2 de Intersecar (secuencia de comandos independiente)
La siguiente secuencia de comandos independiente utiliza la función Intersecar 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
try:
# 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"
clusterTolerance = 1.5
arcpy.Intersect_analysis(inFeatures, intersectOutput, "", clusterTolerance, "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 meter 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)
except Exception as err:
print(err.args[0])
Entornos
- Auto ejecución
- Nombres de campos calificados
- Valor Z de salida predeterminado
- Resolución M
- Tolerancia M
- Palabra clave CONFIG de salida
- Dominio M de salida
- Dominio XY de salida
- Dominio Z de salida
- Sistema de coordenadas de salida
- Extensión
- La salida tiene valores M
- La salida tiene valores Z
- Cuadrícula espacial de salida 1
- Cuadrícula espacial de salida 2
- Cuadrícula espacial de salida 3
- Resolución XY
- Tolerancia XY
- Resolución Z
- Tolerancia Z
Información sobre licencias
- ArcGIS for Desktop Basic: Requiere I
- ArcGIS for Desktop Standard: Requiere I
- ArcGIS for Desktop Advanced: Sí