Integrar (Administración de datos)

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 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 Integrar por pares para obtener más información.

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 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 identificar la tolerancia x,y que se va 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 sobre las referencias espaciales, 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 de Tolerancia XY es fundamental. Se recomienda que las propiedades de referencia espacial de la clase de entidad de entrada se definan como las predeterminadas y que Integrar 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 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 en una sesión de edición.

• Al procesar datasets que contienen entidades individuales con un número muy elevado de vértices (por ejemplo, de cientos de miles a millones de vértices en una sola entidad), algunas operaciones de procesamiento geométrico pueden quedarse sin memoria. Para obtener más detalles, consulte Geoprocesamiento con datasets grandes.

• 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 precondición

Sintaxis

arcpy.management.Integrate(in_features, {cluster_tolerance})

Parámetro	Explicación	Tipo de datos
in_features [[Feature Layer, Long],...]	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). La capa o clase de entidad que tenga la clasificación más baja se ajustará a la entidad de la capa o clase de entidad que tenga la clasificación más alta (1 es una clasificación más alta que 2). Las entidades de la clase de entidad con una clasificación de 1 se pueden mover si se utiliza una tolerancia x,y grande. Para obtener más información, consulte Clasificaciones de prioridad y herramientas de Geoprocesamiento.	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 Integrar (ventana de Python)

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

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

Ejemplo 2 de Integrar (script independiente)

El siguiente script independiente es un ejemplo de cómo aplicar la función Integrate 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.Integrate_management(integrateFeatures)

Entornos

Espacio de trabajo actual, Extensión, Tolerancia XY

Información de licenciamiento

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