Actualizar (Herramientas de análisis)

Resumen

Calcula la intersección geométrica de las entidades de entrada y de las entidades de actualización. 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

Ilustración de la herramienta Actualizar

Uso

Los valores de los parámetros Entidades de entrada y Entidades de actualización deben ser polígonos.
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 faltan uno o más 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.
La clase de entidad de entrada no se modificará. Los resultados se escribirán en una nueva clase de entidad.
Si el parámetro Bordes está desactivado, 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ó equitativamente, al valor de atributo de cada entidad nueva se le asigna la mitad del valor de 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.
Para mejorar el rendimiento y la escalabilidad, esta herramienta utiliza un proceso de ordenamiento en teselas para manejar datasets muy grandes. Para más información, consulte Procesamiento en teselas de datasets grandes.
Esta herramienta puede generar entidades multiparte en la salida, aunque todas las entradas tengan una única parte. Si no desea tener entidades multiparte, utilice la herramienta De multiparte a parte simple en la clase de entidad de salida.

Etiqueta	Explicación	Tipo de datos
Entidades de entrada	La capa o clase de entidad de entrada. El tipo de geometría debe ser polígono.	Feature Layer
Entidades de actualización	Entidades que se utilizarán para actualizar las entidades de entrada. El tipo de geometría debe ser polígono.	Feature Layer
Clase de entidad de salida	La clase de entidad que contendrá los resultados.	Feature Class
Bordes (Opcional)	Especifica si se conservará el límite de las entidades de polígono de actualización. Activado—El borde exterior del valor del parámetro Entidades de actualización se conservará en el valor del parámetro Clase de entidad de salida. Esta es la opción predeterminada. Desactivado—Desactivado: el borde exterior del valor del parámetro Entidades de actualización no se conservará después de insertarlo en Entidades de entrada. Los valores de los elementos del valor del parámetro Entidades de actualización tienen prioridad sobre los atributos del valor de parámetros de Entidades de entrada.	Boolean
Tolerancia XY (Opcional)	La distancia mínima que separa todas las coordenadas de entidades (nodos y vértices), así como también la distancia que se puede mover una coordenada en X o en Y (o en los dos). Precaución: Si se modifica el valor de este parámetro, pueden producirse fallos 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. De forma predeterminada, se utiliza la propiedad de tolerancia x,y de la referencia espacial de la clase de entidad de entrada.	Linear Unit

arcpy.analysis.Update(in_features, update_features, out_feature_class, {keep_borders}, {cluster_tolerance})

Nombre	Explicación	Tipo de datos
in_features	La capa o clase de entidad de entrada. El tipo de geometría debe ser polígono.	Feature Layer
update_features	Entidades que se utilizarán para actualizar las entidades de entrada. El tipo de geometría debe ser polígono.	Feature Layer
out_feature_class	La clase de entidad que contendrá los resultados.	Feature Class
keep_borders (Opcional)	Especifica si se conservará el límite de las entidades de polígono de actualización. `BORDERS`—El borde exterior del valor del parámetro `update_features` se conservará en el valor del parámetro `out_feature_class`. Esta es la opción predeterminada. `NO_BORDERS`—El borde exterior del valor del parámetro `update_features` se conservará después de insertarlo en el `in_features`. Los valores de los elementos del valor del parámetro `update_features` tienen prioridad sobre los atributos del valor del parámetros `in_features`.	Boolean
cluster_tolerance (Opcional)	La distancia mínima que separa todas las coordenadas de entidades (nodos y vértices), así como también la distancia que se puede mover una coordenada en X o en Y (o en los dos). Precaución: Si se modifica el valor de este parámetro, pueden producirse fallos 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. De forma predeterminada, se utiliza la propiedad de tolerancia x,y de la referencia espacial de la clase de entidad de entrada.	Linear Unit

Muestra de código

Ejemplo 1 de Update (ventana de Python)

La siguiente secuencia de comandos de la ventana de Python demuestra cómo utilizar la función Update en modo inmediato.

import arcpy
arcpy.env.workspace = "c:/data"
arcpy.analysis.Update("city_lots.shp", "data.gdb/flood_levels",
                      "data.gdb/low_lots", "NO_BORDERS")

Ejemplo 2 de Update (script independiente)

El siguiente script independiente muestra cómo utilizar la función Update en un entorno de script.

# Name: UpdateZones.py
# Purpose: Update the "lots" feature class with features from "cutzones"

# Import system modules
import arcpy

# Set the workspace
arcpy.env.workspace = "c:/data/city.gdb"

# Set local parameters
inFeatures = "lots"
updateFeatures = "cutzones"
outFeatures = "futurecut"

# Process: Update
arcpy.analysis.Update(inFeatures, updateFeatures, outFeatures, "NO_BORDERS")

Entornos

Auto ejecución, Mantener totalmente cualificados los nombres de los campos, Valor Z de salida predeterminado, Resolución M, Tolerancia M, Palabra clave CONFIG de salida, Dominio M de salida, Dominio XY de salida, Dominio Z de salida, Sistema de coordenadas de salida, Transformaciones geográficas, Extensión, La salida tiene valores M, La salida tiene valores Z, Resolución XY, Tolerancia XY, Resolución Z, Tolerancia Z, Factor de procesamiento en paralelo, Transferir propiedades de campos de geodatabase

Casos especiales

Factor de procesamiento en paralelo

This tool honors the Parallel Processing Factor environment. If the environment is not set (the default) or is set to 0, parallel processing will be disabled; parallel processing will not be used and processing will be done sequentially. Setting the environment to 100 will enable parallel processing; parallel processing will be used and processing will be done in parallel. Up to 10 cores will be used when parallel processing is enabled.

Parallel processing is currently supported for polygon-on-polygon, line-on-polygon, and point-on-polygon overlay operations.

Información de licenciamiento

Basic: No
Standard: No
Avanzado: Sí