Integrar por pares (Análisis)

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 integrar datos vectoriales. Consulte la documentación de la herramienta Integrar para obtener más información.

Ilustración

Ilustración de la herramienta Integrar por pares

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 esta herramienta 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 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 no proporcionar un valor para el parámetro Tolerancia XY. Si no se proporciona un valor, 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. Asegúrese de que la referencia espacial de los datos de entrada se ajusta a su resolución x,y y tolerancia x,y predeterminadas.

    El parámetro Tolerancia XY no debe utilizarse para generalizar formas geométricas. Está pensado 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 en un valor distinto del 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).

    Más información sobre el procesamiento en clúster

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

  • Para deshacer cambios en las entidades de entrada, utilice esta herramienta 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. 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

EtiquetaExplicaciónTipo de datos
Entidades de entrada

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
Tolerancia XY
(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 pequeña. Si no se proporciona 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

EtiquetaExplicaciónTipo de datos
Entidades de entrada actualizadas

Las entidades de entrada actualizadas.

Feature Layer

arcpy.analysis.PairwiseIntegrate(in_features, {cluster_tolerance})
NombreExplicaciónTipo 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 pequeña. Si no se proporciona 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

NombreExplicaciónTipo de datos
out_features

Las entidades de entrada actualizadas.

Feature Layer

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 de modo inmediato.

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.management.CopyFeatures("Habitat_Analysis.gdb/vegtype", "C:/output/output.gdb/vegtype")
arcpy.analysis.PairwiseIntegrate("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 PairwiseIntegrate 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"

# Run CopyFeatures (since PairwiseIntegrate modifies the original data, this 
# ensures the original is preserved)
arcpy.management.CopyFeatures(inFeatures, integrateFeatures)

# Run PairwiseIntegrate
arcpy.analysis.PairwiseIntegrate(integrateFeatures)

Información de licenciamiento

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

Temas relacionados