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 escribirán 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

Uso

• Solamente dos clases de entidad de entrada son compatibles.

• La entrada deben ser entidades simples, por ejemplo, entidades de punto, multipunto, línea o polígono. No puede utilizar 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, el tipo de geometría de salida será por defecto la dimensión más baja de las entradas.

  • Si la entrada son entidades de puntos, la salida predeterminada serán entidades de puntos.
  • Si una entrada son entidades de línea y no hay entradas con entidades de puntos, la salida predeterminada serán entidades de línea.
  • Si todas las entradas son entidades de polígono, la salida predeterminada serán entidades 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.

• El parámetro Usar precisión máxima solo se aplica cuando el valor del parámetro Tipo de salida es Punto. La precisión es una combinación de la resolución x,y y la tolerancia x,y que se utiliza durante el procesamiento. De forma predeterminada se utilizan estas propiedades de la referencia espacial de la primera clase de entidad Entidades de entrada.

  Cuando el parámetro Precisión está seleccionado, se utilizará el valor de precisión máximo posible para la salida de puntos. La herramienta utiliza la máxima precisión de la que dispone, que depende del valor absoluto de las coordenadas geométricas y de la precisión de la coma flotante del hardware. Una estimación aproximada de la tolerancia máxima que se utilizará es de 0,002 mm frente al valor predeterminado de 1 mm.

  Al escribir la salida, se aplicará la resolución de la referencia espacial, por lo que los puntos pueden desplazarse ligeramente.

  Cuando los datos de entrada contienen segmentos no lineales (curvas), para obtener mejores resultados active el entorno Mantener segmentos de curva y establezca el entorno Método de procesamiento de curvas en EXACTO.

• 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.

• Todas las entradas deben tener 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 posibilidad de que sea incorrecto.

• Cuando las entidades de entrada tienen valores m o z, solo los valores Mm o z de la primera clase de entidad se transferirán 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. Si el entorno se establece en 0, no se habilitará el procesamiento paralelo. Si se especifica un factor entre 1 y 99, la herramienta identificará 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

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Entidades de entrada	Capas o clases de entidad de entrada que intersecarán. Solo se admiten 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 atributos—Todos 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 entidad—Todos los atributos excepto el FID de las entidades de entrada se transferirán a la clase de entidad de salida. Solo Id. de entidad—Solo 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 van a devolver. Igual que la entrada—Las 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. Línea—Las intersecciones que se devuelven serán de líneas. Esto solo es válido si ninguna de las entradas son puntos. Punto—Las 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
Usar precisión máxima (Opcional)	Especifica el nivel de precisión que se utilizará cuando el valor del parámetro Tipo de salida sea Punto. Este parámetro no se admite cuando el valor del parámetro Tipo de salida es Igual que entrada o Línea. Seleccione este parámetro cuando desee que la herramienta aplique un nivel de precisión superior al predeterminado para la referencia espacial de entrada al determinar la salida de puntos. Seleccionado: se utilizará la precisión máxima para determinar la salida de puntos. No seleccionado: se utilizará la precisión de la primera clase de entidad de entrada para determinar la salida de puntos. Esta es la opción predeterminada.	Boolean

Python

arcpy.analysis.PairwiseIntersect(in_features, out_feature_class, {join_attributes}, {cluster_tolerance}, {output_type}, {precision})

Nombre	Explicación	Tipo de datos
in_features [in_features,...]	Capas o clases de entidad de entrada que intersecarán. Solo se admiten 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. ALL—Todos los atributos de las entidades de entrada se transferirán a la clase de entidad de salida. Esta es la opción predeterminada. NO_FID—Todos los atributos excepto el FID de las entidades de entrada se transferirán a la clase de entidad de salida. ONLY_FID—Solo 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 van a devolver. INPUT—Las 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. LINE—Las intersecciones que se devuelven serán de líneas. Esto solo es válido si ninguna de las entradas son puntos. POINT—Las 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
precision (Opcional)	Especifica el nivel de precisión que se utilizará cuando el valor del parámetro output_type sea POINT. Este parámetro no se admite cuando el valor del parámetro output_type es INPUT o LINE. Utilice la opción MAX_PRECISION cuando desee que la herramienta aplique un nivel de precisión superior al predeterminado para la referencia espacial de entrada al determinar la salida de puntos. MAX_PRECISION—Se utilizará la precisión máxima para determinar la salida de puntos. DEFAULT_PRECISION—Se utilizará la precisión de la primera clase de entidad de entrada para determinar la salida de puntos. Esta es la opción predeterminada.	Boolean

Muestra de código

Ejemplo 1 de PairwiseIntersect (ventana de Python)

La siguiente secuencia de comandos de la ventana de Python muestra cómo utilizar la función PairwiseIntersect de modo inmediato.

import arcpy
arcpy.env.workspace = "C:/data/RedRiver_basin.gdb"
arcpy.analysis.PairwiseIntersect(["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 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.analysis.PairwiseIntersect(inFeatures, intersectOutput)

Entornos

Auto ejecución, Nombres de campos calificados, Valor Z de salida predeterminado, Resolución M, Tolerancia M, Palabra clave CONFIG de salida, Palabra clave CONFIG de salida, Dominio XY de salida, Dominio Z de salida, Sistema de coordenadas de salida, Transformaciones geográficas, Extensión, La salida tiene valores M, La salida tiene valores Z, Resolución XY, Tolerancia XY, Resolución Z, Tolerancia Z, Factor de procesamiento en paralelo, Mantener segmentos curvos, Método de procesamiento de curvas, Transferir dominios de campo, subtipos y reglas de atributo

Información de licenciamiento

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