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.
Ilustración
Uso
Si hay alguna entidad de entrada seleccionada, esta herramienta se ejecutará sólo 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í. Para obtener más información sobre el uso de las topologías, consulte Fundamentos de topología.
Utilice Integrar en lugar de una topología en estas circunstancias:
- No necesite especificar reglas sobre cómo se mueven las entidades (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 de la herramienta 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 sobre referencias espaciales, consulte Las 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.
Integrar acepta sólo clases de entidad simples como entrada (punto, multipunto, línea o polígono).
Para deshacer cambios en las entidades de entrada, utilice 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.
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. | 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
Información de licenciamiento
- Basic: Sí
- Standard: Sí
- Advanced: Sí