Intersecar por pares (Análisis)

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.

Más información sobre cómo funciona Intersecar por pares

Ilustración

Ilustración de Intersecar por pares

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.

Parámetros

EtiquetaExplicaciónTipo de datos
Entidades de entrada

Las capas o clases de entidad de entrada para intersecar. Solo se permiten dos entradas.

Value Table
Clase de entidad de salida

La clase de entidad de salida.

Feature Class
Vincular atributos
(Opcional)

Especifica qué atributos de las entidades de entrada se transferirán a la clase de entidad de salida.

  • Todos los atributosTodos los atributos de las entidades de entrada se transferirán a la clase de entidad de salida. Esta es la opción predeterminada.
  • Todos los atributos excepto los Id. de entidadTodos los atributos excepto el FID de las entidades de entrada se transferirán a la clase de entidad de salida.
  • Solo Id. de entidadSolo se transferirá a la clase de entidad de salida el campo FID de las entidades de entrada.
String
Tolerancia XY
(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
Tipo de salida
(Opcional)

Especifica el tipo de intersecciones que se devolverán.

  • Igual que la entradaLas intersecciones devueltas serán del mismo tipo de geometría que las entidades de entrada con la geometría de dimensión más baja. Si todas las entradas son polígonos, la clase de entidad de salida contendrá polígonos. Si una o más de las entradas son líneas y ninguna de las entradas son puntos, la salida serán líneas. Si una o más de las entradas son puntos, la clase de entidad de salida contendrá puntos. Esta es la opción predeterminada.
  • LineLas intersecciones que se devuelven serán de líneas. Esto solo es válido si ninguna de las entradas son puntos.
  • PointLas intersecciones que se devuelven serán de puntos. Si las entradas son de línea o polígono, el resultado será una clase de entidad multipunto.
String

arcpy.analysis.PairwiseIntersect(in_features, out_feature_class, {join_attributes}, {cluster_tolerance}, {output_type})
NombreExplicaciónTipo 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)

Especifica qué atributos de las entidades de entrada se transferirán a la clase de entidad de salida.

  • ALLTodos los atributos de las entidades de entrada se transferirán a la clase de entidad de salida. Esta es la opción predeterminada.
  • NO_FIDTodos los atributos excepto el FID de las entidades de entrada se transferirán a la clase de entidad de salida.
  • ONLY_FIDSolo se transferirá a la clase de entidad de salida el campo FID de las entidades de entrada.
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.

  • INPUTLas intersecciones devueltas serán del mismo tipo de geometría que las entidades de entrada con la geometría de dimensión más baja. Si todas las entradas son polígonos, la clase de entidad de salida contendrá polígonos. Si una o más de las entradas son líneas y ninguna de las entradas son puntos, la salida serán líneas. Si una o más de las entradas son puntos, la clase de entidad de salida contendrá puntos. Esta es la opción predeterminada.
  • LINELas intersecciones que se devuelven serán de líneas. Esto solo es válido si ninguna de las entradas son puntos.
  • POINTLas intersecciones que se devuelven serán de puntos. Si las entradas son de línea o polígono, el resultado será una clase de entidad multipunto.
String

Muestra de código

Ejemplo 1 de PairwiseIntersect (ventana de Python)

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")
Ejemplo 2 de PairwiseIntersect (script independiente)

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)

Información de licenciamiento

  • Basic: Sí
  • Standard: Sí
  • Advanced: Sí

Temas relacionados