Resumen
Integrar se utiliza para mantener la integridad de los límites compartidos de las entidades al hacer que las entidades coincidan si caen dentro de la tolerancia x, y especificada. Las entidades que caen dentro de la tolerancia x, y especificada se consideran idénticas o coincidentes.
Por ejemplo, supongamos que especifica una tolerancia x, y de cinco unidades (como pies o metros) y los datos tienen un límite de parcela que debería compartirse con el límite de parcela adyacente, pero se encuentra a cuatro unidades de distancia. Después de ejecutar esta herramienta, los límites de las dos parcelas coincidirían porque se encuentran dentro de la tolerancia x, y de cinco unidades.
Integrar realiza las siguientes tareas de procesamiento:
- Busca entidades que estén dentro de la tolerancia x, y dada.
- Inserta vértices coordenados comunes para entidades que caen dentro de la tolerancia x, y dada y agrega vértices donde se intersecan los segmentos de entidades.
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 porque 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 cuando:
- 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 como, por ejemplo, shapefiles, o con entidades de distintas geodatabases (todas las entidades de una topología deben venir del mismo dataset de entidades).
El valor para la Tolerancia XY es crítico; una tolerancia muy grande puede colapsar y eliminar los polígonos o las líneas, o mover los vértices que no deberían moverse. Para minimizar el error, el valor que elija para la tolerancia x, y debe ser tan pequeño como sea posible.
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 contengan entidades individuales con un número muy grande de vértices (por ejemplo, cientos de miles a millones de vértices dentro de 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 las salidas de esta herramienta con otra herramienta, utilice sus entradas directamente y establezca su salida como condición previa de la otra herramienta. Más información acerca de cómo establecer una precondición.
Sintaxis
Integrate_management (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). Tenga en cuenta que las entidades en la clase de entidad con una clasificación de 1 se pueden mover cuando se utilice una tolerancia x, y grande. | 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 |
Muestra de código
Ejemplo 1 de Integrar (ventana de Python)
La siguiente secuencia de comandos de la ventana de Python demuestra cómo utilizar la función Integrate en el 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", 0.01)
Ejemplo 2 de Integrar (secuencia de comandos independiente)
La siguiente secuencia de comandos independiente es un ejemplo de cómo aplicar la función Integrate en un entorno de secuencias de comandos.
# 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"
xyTolerance = "0.1 feet"
# Execute CopyFeature (since Integrate modifies the original data
# this ensures the original is preserved)
arcpy.CopyFeatures_management(inFeatures, integrateFeatures)
# Execute Integrate
arcpy.Integrate_management(integrateFeatures, xyTolerance)
Entornos
Información sobre licencias
- ArcGIS Desktop Basic: Sí
- ArcGIS Desktop Standard: Sí
- ArcGIS Desktop Advanced: Sí