Actualizar (Análisis)
Resumen
Calcula una intersección geométrica de entidades de entrada y actualiza entidades. Los atributos y la geometría de las entidades de entrada se actualizan mediante las entidades de actualización en la clase de entidad de salida.
Ilustración
Uso
-
Las Entidades de entrada deben ser de tipo polígono.
-
La clase de entidad de entrada no se modificará mediante esta herramienta. Los resultados de la herramienta se escribirán en una nueva clase de entidad.
-
Las Entidades de actualización deben ser de tipo polígono.
-
Los nombres de campo de la clase de entidad de entrada y la clase de entidad de actualización deben coincidir.
-
Si a la clase de entidad de actualización le falta uno (o varios) de los campos que están presentes en la clase de entidad de entrada, el valor de campo de la clase de entidad de entrada para los campos que faltan se quitará de la clase de entidad de salida.
-
Si el parámetro Bordes está desmarcado en el cuadro de diálogo (o establecido como NO_BORDERS en la secuencia de comandos), se eliminarán los límites de polígono a lo largo del eje exterior de las entidades de actualización. Aunque se eliminan los límites exteriores de algunos polígonos de actualización, los atributos de las entidades de actualización que se superponen con entidades de entrada se asignarán a los polígonos en la clase de entidad de salida.
-
Los valores de atributo de las clases de entidad de entrada se copiarán a la clase de entidad de salida. Sin embargo, si la entrada hay capas creadas por la herramienta Crear capa de entidades y el campo Utilizar política de relación está activado, se calculará una proporción del valor del atributo de entrada para el valor del atributo de salida. Cuando se habilita Utilizar política de relación, siempre que se divida una entidad en una operación de superposición, los atributos de las entidades resultantes son una relación del valor de atributo de la entidad de entrada. El valor de salida está basado en la relación en la que se dividió la geometría de la entidad de entrada. Por ejemplo, si la geometría de entrada se dividió por igual, el valor del atributo de cada nueva entidad recibirá la mitad del valor del atributo de la entidad de entrada. Utilizar política de relación solo se aplica a los tipos de campos numéricos.
Precaución:Las herramientas de geoprocesamiento no cumplen las políticas de división de campos de tabla o clases de entidad de geodatabase.
-
Esta herramienta utilizará un proceso de ordenamiento en tesela para controlar datasets muy grandes para mejorar el rendimiento y la escalabilidad. Para obtener información más detallada, vea Geoprocesamiento con datasets grandes.
-
Esta herramienta puede generar entidades multiparte en la salida aunque todas las entradas tengan una única parte. Si no se desea tener entidades multiparte, utilice la herramienta De multiparte a parte simple sobre la clase de entidad de salida.
Sintaxis
Parámetro | Explicación | Tipo de datos |
in_features |
La capa o clase de entidad de entrada. El tipo de geometría debe ser de polígono. | Feature Layer |
update_features |
Las entidades que se utilizarán para actualizar las entidades de entrada. El tipo de geometría debe ser de polígono. | Feature Layer |
out_feature_class |
La clase de entidad que contendrá los resultados. No establezca el mismo valor de las entidades de entrada. | Feature Class |
keep_borders (Opcional) |
Especifica si se conservará el límite de las entidades de polígono de actualización.
| Boolean |
cluster_tolerance (Opcional) |
La distancia mínima que separa todas las coordenadas de la entidad (nodos y vértices), así como la distancia que una coordenada se puede mover en X o Y (o ambas). | Linear unit |
Ejemplo de código
La siguiente secuencia de comandos de la ventana de Python demuestra cómo utilizar la función Actualizar en el modo inmediato.
import arcpy from arcpy import env env.workspace = "C:/data" arcpy.Update_analysis ("city_lots.shp", "data.gdb/flood_levels", "data.gdb/low_lots", "DROP_BORDER", 0.0003)
La siguiente secuencia de comandos independiente muestra cómo utilizar la función Actualizar en un entorno de secuencia de comandos.
# Name: UpdateZones.py # Purpose: Update the "lots" feature class with features from "cutzones" # Author: ESRI # Import system modules import arcpy from arcpy import env # Set the workspace env.workspace = "c:/data/city.gdb" # Set local parameters inFeatures = "lots" updateFeatures = "cutzones" outFeatures = "futurecut" #Process: Update arcpy.Update_analysis(inFeatures, updateFeatures, outFeatures, "only_fid", 0.25)