Integrar por pares (Analysis)

Resumen

Analiza las ubicaciones de coordenadas de vértices de entidades entre las entidades de una o varias clases de entidad. Se supone que los que están dentro de una distancia determinada de otros representan la misma ubicación y tienen asignado un valor de coordenadas común. La herramienta también agrega vértices donde los vértices de entidades están dentro de la tolerancia x,y respecto de un eje y donde los segmentos de línea se intersecan.

Integrar por pares realiza las siguientes tareas de procesamiento:

• Los vértices dentro de la tolerancia x,y de otros tendrán asignada la misma ubicación de coordenadas.
• Si un vértice de una entidad está dentro de la tolerancia x,y de un eje de cualquier otra entidad, se insertará un vértice nuevo en el eje.
• Cuando los segmentos de línea se intersecan, se inserta un vértice en el punto de intersección de cada entidad de la intersección.

Existe una herramienta alternativa para la integración de datos vectoriales. Consulte la documentación de la herramienta Integrar para obtener detalles.

Ilustración

Uso

Precaución:

Esta herramienta modifica los datos de entrada. Consulte Herramientas que modifican o actualizan los datos de entrada para obtener más información y estrategias para evitar cambios de datos no deseados.

• Si hay entidades de entrada seleccionadas, esta herramienta se ejecutará solo en aquellas entidades que estén seleccionadas.

• Esta herramienta realiza el mismo tipo de trabajo que una topología en que mueve entidades dentro de una tolerancia x, y e inserta vértices donde se intersecan las entidades. Considere utilizar una topología para realizar este tipo de operaciones, ya que una topología le permite especificar las reglas y las condiciones sobre cómo se relacionan las entidades entre sí.

  Utilice Integrar por pares en lugar de una topología en estas circunstancias:

  • No necesita especificar reglas sobre cómo se mueven las entidades y quiere que todas las entidades se fusionen dentro de una tolerancia especificada.
  • Quiera que las líneas tengan vértices donde se intersequen.
  • Esté trabajando con entidades que no son geodatabases, tales como shapefiles, o con entidades de distintas geodatabases (todas las entidades de una topología deben proceder del mismo dataset de entidades).

• Puede que muchos posibles problemas que haya en los datos se resuelvan durante la integración. La manipulación de arcos colgantes y arcos cortos extremadamente pequeños, la eliminación automática de falso polígono de los segmentos duplicados y la simplificación de coordenadas a lo largo de líneas de límite se puede resolver.

• Se recomienda que no utilice el parámetro Tolerancia XY. Si no se especifica, la herramienta comprobará la referencia espacial de las clases de entidad de entrada para determinar la tolerancia x,y a utilizar durante la integración. La referencia espacial de los datos de entrada se debe establecer en su tolerancia x,y y resolución x,y predeterminadas. Para obtener más información, consulte Propiedades de una referencia espacial.

  El parámetro Tolerancia XY no está pensado para generalizar formas geométricas, sino para integrar límites y trabajo de líneas en el contexto de una referencia espacial de clase de entidad de entrada configurada correctamente. Cambiar el parámetro Tolerancia XY para que no sea el predeterminado para la referencia espacial de entrada podría provocar que las entidades se moviesen demasiado o muy poco, lo que causaría problemas de geometría. Si se utilizan las propiedades adecuadas de referencia espacial, al ejecutar la herramienta Integrar se puede minimizar la cantidad de movimiento de los datos durante las operaciones topológicas posteriores (como superposición y disolución).

  El valor del parámetro Tolerancia XY es fundamental. Se recomienda que las propiedades de referencia espacial de la clase de entidad de entrada se definan en los valores predeterminados y que Integrar por pares pueda volver a los valores predeterminados de las propiedades de la clase de entidad de entrada. Para obtener más información sobre el procesamiento clúster, consulte Procesamiento clúster.

• La herramienta Integrar por pares solo acepta clases de entidad simples como entrada (punto, multipunto, línea o polígono).

• Para deshacer cambios en las entidades de entrada, utilice la herramienta Integrar por pares en una sesión de edición.

• El elemento de datos de salida de esta herramienta es una salida derivada de valor múltiple. Para utilizar la salida de esta herramienta con otra herramienta, utilice su entrada directamente y establezca su salida como condición previa de la otra herramienta.

  Más información sobre cómo establecer una condición previa

• 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.PairwiseIntegrate(in_features, {cluster_tolerance})

Parámetro	Explicación	Tipo de datos
in_features [in_features,...]	Clases de entidad que se integrarán. Cuando la distancia entre las entidades es pequeña en comparación con la tolerancia, los vértices o puntos se agruparán (se moverán para que coincidan).	Value Table
cluster_tolerance (Opcional)	La distancia que determina la clasificación en la cual coinciden los vértices de entidades. Para minimizar el movimiento no deseado de los vértices, la tolerancia x, y debe ser relativamente pequeña. Si no se especifica ningún valor, se utilizará la tolerancia x, y del primer dataset en la lista de entradas. 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

Salida derivada

Nombre	Explicación	Tipo de datos
out_features	Las entidades de entrada actualizadas.	Capa de entidades

Muestra de código

Ejemplo 1 de PairwiseIntegrate (ventana de Python)

El siguiente script de la ventana de Python demuestra cómo utilizar la función PairwiseIntegrate en modo inmediato.

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.CopyFeatures_management("Habitat_Analysis.gdb/vegtype", "C:/output/output.gdb/vegtype")
arcpy.PairwiseIntegrate_analysis("C:/output/output.gdb/vegtype")

Ejemplo 2 de PairwiseIntegrate (script independiente)

El siguiente script independiente es un ejemplo de cómo aplicar la función PairwiseIntegrate en un entorno de scripts.

# Description: Run Integrate on a feature class
# Import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = "C:/data/Habitat_Analysis.gdb"
# Set local variables
inFeatures = "vegtype"
integrateFeatures = "C:/output/output.gdb/vegtype"
# Execute CopyFeatures (since Integrate modifies the original data, this 
# ensures the original is preserved)
arcpy.CopyFeatures_management(inFeatures, integrateFeatures)
# Execute Integrate
arcpy.PairwiseIntegrate_analysis(integrateFeatures)

Entornos

Espacio de trabajo actual, Extensión, Tolerancia XY, Factor de procesamiento en paralelo

Información de licenciamiento

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