Resumen
Calcula una intersección por pares de las entidades de entrada. Las entidades o partes de entidades que se superponen con las capas de entidades o las clases de entidad de entrada se escriben en la clase de entidad de salida. La intersección por pares se refiere a la selección de una entidad de la primera entrada y su intersección con las entidades de la segunda entrada que se superponen a ella.
Existe una herramienta alternativa para las operaciones de intersección. Consulte la documentación de la herramienta Intersecar para obtener 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
Solamente dos clases de entidad de entrada son compatibles.
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.
A diferencia de la herramienta Intersecar, las clasificaciones no son compatibles.
De forma predeterminada, las entidades de curva de la entrada se densifican en la salida. Para admitir curvas en la salida, utilice el entorno Mantener segmentos de curva.
Esta herramienta se basa en las entidades de entrada que tienen un índice espacial. Utilice la herramienta Agregar índice espacial para crear un índice (especialmente para los shapefiles) o volver a generar un índice existente si hay alguna duda de que sea correcto.
Si sus entidades de entrada tienen valores m o z, solo los valores m y z de la primera clase de entidad se transfieren a las entidades de salida. Si la primera clase de entidad no tiene valores m ni z, la salida tampoco contendrá valores m ni z.
La referencia espacial de la clase de entidad de salida será la de la primera clase de entidad del parámetro Entidades de entrada. Consulte Referencia espacial y geoprocesamiento para obtener más información.
Esta herramienta respeta el entorno Factor de procesamiento en paralelo. Si el entorno no está configurado (predeterminado) o está configurado con el valor 100, se permitirá el procesamiento en paralelo completo y la herramienta intentará distribuir el trabajo entre todos los núcleos lógicos del equipo. Configurar el entorno a 0 desactiva el procesamiento en paralelo. Especificar un factor entre 1 y 99 hará que la herramienta identifique el porcentaje de núcleos lógicos que debe usar aplicando la fórmula (Factor de procesamiento en paralelo / 100 * Núcleos lógicos) redondeada al entero más próximo. Si el resultado de la fórmula es 0 o 1, no se habilitará el procesamiento en paralelo.
Sintaxis
arcpy.analysis.PairwiseIntersect(in_features, out_feature_class, {join_attributes}, {cluster_tolerance}, {output_type})| Parámetro | Explicación | Tipo de datos |
in_features [in_features,...] | Las capas o clases de entidad de entrada para intersecar. Solo se permiten dos entradas. | 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), 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 PairwiseIntersect en el modo inmediato:
import arcpy
arcpy.env.workspace = "C:/data/RedRiver_basin.gdb"
arcpy.PairwiseIntersect_analysis(["vegetation_stands", "road_buffer200m", "water_buffer100"],
"mysites", "ALL")Buscar el tipo de vegetación por el que se desplazan los arroyos.
# Name: StreamsInVegetationIntersect.py
# Purpose: Determine the vegetation type streams are traveling through.
# 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 streams in each vegetation type
inFeatures = ["vegetation", "streams"]
intersectOutput = "streams_in_vegtype"
arcpy.PairwiseIntersect_analysis(inFeatures, intersectOutput)Entornos
Información de licenciamiento
- Basic: Sí
- Standard: Sí
- Advanced: Sí