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 todas aquellas entidades de la segunda entrada que se superponen a ella.
La herramienta Intersecar por pares es similar a la herramienta Intersecar en cuanto a que se calculan las intersecciones geométricas, pero es considerablemente distinta en cuanto a que las intersecciones se calculan por pares de entidades en vez de por todas las combinaciones de entidades. Esta herramienta puede resultar útil en situaciones en las que la herramienta Intersecar genera una salida con muchas más entidades que las de entrada (por ejemplo, las entradas contenían decenas de miles de entidades y el resultado es de decenas o cientos de millones de entidades).
Ilustración
Uso
Solamente dos clases de entidad de entrada son compatibles.
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.
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 tendrá valores m ni z.
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.
La referencia espacial de la clase de entidad de salida seguirá siendo 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 de 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 determine 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
PairwiseIntersect(in_features, out_feature_class, {join_attributes}, {cluster_tolerance}, {output_type})| Parámetro | Explicación | Tipo de datos |
in_features [in_feature,...] | 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), 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 intersecció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: Limitado
- Standard: Limitado
- Advanced: Sí