Calcular campo (Administración de datos)

Resumen

Calcula los valores de un campo para una clase de entidad, una capa de entidades o un ráster.

Uso

  • Para obtener más información sobre las expresiones de Python, consulte Ejemplos de Calcular campo de Python.

    Para obtener más información sobre las expresiones de Arcade, consulte la Guía de ArcGIS Arcade.

    Para obtener más información sobre las expresiones de SQL, consulte Calcular valores de campo.

  • Cuando se utiliza con un conjunto seleccionado de entidades, como las creadas a partir de una consulta en las herramientas Crear capa de entidades o Seleccionar capa por atributo, esta herramienta solamente actualiza los registros seleccionados.

  • El cálculo solamente se puede aplicar a un campo por operación. Para aplicar varios cálculos, utilice la herramienta Calcular campos.

  • Los valores de campo existentes se sobrescriben. Realice una copia de la tabla de entrada si desea conservar los valores originales.

  • En los cálculos de Python, los nombres de campo deben estar entre signos de exclamación (por ejemplo, !fieldname!).

    En los cálculos de Arcade, los nombres de campo deben tener el prefijo $feature. (por ejemplo, $feature.fieldname).

  • Para calcular cadenas para campos de texto o de caracteres, en el cuadro de diálogo la cadena debe estar entre comillas dobles ("cadena") y, en un script, la cadena entre comillas dobles también debe estar entre comillas simples (por ejemplo, '"string"').

  • Si desea calcular un campo para que sea un valor numérico, introduzca el valor numérico en el parámetro Expresión sin encerrar el valor entre comillas.

  • Heredado:

    arcgis.rand() ya no se admite desde ArcGIS Pro 2.0. En su lugar, se deben usar otras funciones similares del módulo random de Python. Para usar correctamente el módulo random, agréguelo como importación en el parámetro Bloque de código.

  • Puede crear expresiones complejas utilizando el parámetro Bloque de código. Introduzca el bloque de código directamente en el cuadro de diálogo o como una cadena en el script. La expresión y el bloque de código están conectados. El bloque de código debe estar relacionado con la expresión; el resultado del bloque de código se debe pasar a la expresión.

    El parámetro Bloque de código solo se admite en expresiones de Python.

  • Puede utilizar el módulo Python math y formatear en el parámetro Bloque de código. También puede importar módulos adicionales. El módulo math proporciona funciones de representación y de teoría de números, funciones potencia y logarítmicas, funciones trigonométricas, funciones de conversión angular, funciones hiperbólicas y constantes matemáticas. Para obtener más información sobre el módulo math, consulte la Ayuda de Python.

  • Se pueden crear expresiones de Python utilizando las propiedades del objeto Geometry, como type, extent, centroid, firstPoint, lastPoint, area, length, isMultipart y partCount (por ejemplo, !shape.area!).

  • Puede utilizar las propiedades de geometría area y length en las expresiones Python con una unidad lineal o de área para convertir el valor en una unidad de medida diferente (por ejemplo, !shape.length@kilometers!). Si los datos se almacenan en un sistema de coordenadas geográficas y se proporciona una unidad lineal (por ejemplo, millas), la longitud se calculará mediante un algoritmo geodésico. El uso de unidades de área en los datos geográficos producirá resultados cuestionables, ya que los grados decimales no son iguales en todo el mundo.

    • A continuación, se muestran palabras clave de unidades de medida de área:
      • ACRES | ARES | HECTARES | SQUARECENTIMETERS | SQUAREDECIMETERS | SQUAREINCHES | SQUAREFEET | SQUAREKILOMETERS | SQUAREMETERS | SQUAREMILES | SQUAREMILLIMETERS | SQUAREYARDS | SQUAREMAPUNITS | UNKNOWN
    • A continuación, se muestran palabras clave de unidades de medida lineales:
      • CENTIMETERS | DECIMALDEGREES | DECIMETERS | FEET | INCHES | KILOMETERS | METERS | MILES | MILLIMETERS | NAUTICALMILES | POINTS | UNKNOWN | YARDS
  • Se pueden usar expresiones de Python para calcular la longitud o el área geodésica de una entidad mediante el uso de las propiedades geodesicArea o geodesicLength combinadas con unidades de medida lineales o de área (por ejemplo, !shape.geodesicArea@hectares! o !shape.geodesicLength@miles!).

  • Las aplicaciones de ArcGIS usan la codificación UTF-16-LE para la lectura y escritura de archivos .cal. Otras aplicaciones (por ejemplo, Bloc de notas) se pueden utilizar para crear o modificar archivos .cal, siempre que la salida se escriba usando la codificación UTF-16-LE. El uso de cualquier otra codificación generará un archivo que no se cargará en el bloque de código.

  • Cuando calcula datos unidos, no puede calcular directamente las columnas unidas. Sin embargo, puede calcular directamente las columnas de la tabla de origen. Para calcular los datos unidos, primero agregue las tablas o capas unidas al mapa. Después puede realizar cálculos en estos datos por separado. Estos cambios se reflejarán en las columnas que se unieron.

  • Las expresiones de Python que intentan concatenar campos de cadena de caracteres que incluyen un nulo o dividen el valor entre cero devolverán un nulo para ese valor de campo.

  • Las expresiones SQL permiten cálculos más rápidos en servicios de entidades y geodatabases corporativas. En lugar de realizar cálculos entidad por entidad o fila por fila, se define una sola solicitud para el servidor o la base de datos, lo cual genera cálculos más rápido.

    Solamente los servicios de entidades y las geodatabases corporativas son compatibles con expresiones de SQL. Para otros formatos, utilice expresiones de Python o Arcade.

    El uso de la opción SQL para el parámetro Tipo de expresión presenta las siguientes limitaciones:

    • La opción solo se admite con geodatabases corporativas de Db2, Oracle, PostgreSQL, SAP HANA y SQL Server.
    • No se admite el cálculo de valores de campo en tablas unidas.
    • Los datos versionados y archivados no son compatibles.
    • No se admite la función de deshacer operaciones de geoprocesamiento.

    Consulte la ayuda de las expresiones SQL en la documentación del proveedor de base de datos.

Parámetros

EtiquetaExplicaciónTipo de datos
Tabla de entrada

Tabla que contiene el campo que se actualizará con el cálculo nuevo.

Mosaic Layer; Raster Layer; Table View
Nombre de campo (existente o nuevo)

Campo que se actualizará con el cálculo nuevo.

Si no existe ningún campo con el nombre especificado en la tabla de entrada, se agregará.

Field
Expresión

Expresión de cálculo simple que se utiliza para crear un valor que completará las filas seleccionadas.

SQL Expression
Tipo de expresión
(Opcional)

Especifica el tipo de expresión que se utilizará.

Para obtener más información sobre las expresiones de Python, consulte Ejemplos de Calcular campo de Python.

Para obtener más información sobre las expresiones de Arcade, consulte la Guía de ArcGIS Arcade.

Para obtener más información sobre las expresiones de SQL, consulte Calcular valores de campo.

Las expresiones SQL permiten cálculos más rápidos en servicios de entidades y geodatabases corporativas. En lugar de realizar cálculos entidad por entidad o fila por fila, se define una sola solicitud para el servidor o la base de datos, lo cual genera cálculos considerablemente más rápido.

Solamente los servicios de entidades y las geodatabases corporativas son compatibles con expresiones de SQL. Para otros formatos, utilice expresiones de Python o Arcade.

  • Python 3Se utilizará el tipo de expresión de Python. Esta es la opción predeterminada.
  • ArcadeSe utilizará el tipo de expresión de Arcade.
  • SQLSe utilizará el tipo de expresión de SQL.
String
Bloque que código
(Opcional)

Un bloque de código que se introducirá para expresiones complejas.

String
Tipo de campo
(Opcional)

Especifica el tipo de campo del nuevo campo. Este parámetro solo se utiliza si el nombre de campo no existe en la tabla de entrada.

Si el campo es de texto, el nuevo campo tendrá una longitud de 512. En el caso de los shapefiles y los archivos de dBASE, el campo tendrá una longitud de 254. La longitud del nuevo campo se puede ajustar con la herramienta Modificar campo.

  • TextoSe puede usar cualquier cadena de caracteres.
  • Flotante (precisión simple)Se pueden usar números fraccionarios entre -3,4E38 y 1,2E38.
  • Doble (precisión doble)Se pueden usar números fraccionarios entre -2,2E308 y 1,8E308.
  • Corto (entero pequeño)Se pueden usar números enteros entre -32.768 y 32.767.
  • Largo (entero grande)Se pueden usar números enteros entre -2.147.483.648 y 2.147.483.647.
  • FechaSe usarán la fecha y la hora.
  • Blob (datos binarios)Se usará una secuencia larga de números binarios.
  • Imágenes rásterSe usarán imágenes ráster. Aunque se pueden almacenar todos los formatos de dataset ráster admitidos por el software de ArcGIS, se recomienda utilizar solamente imágenes pequeñas.
  • GUID (identificador único a nivel mundial)Se utilizará un identificador único a nivel mundial.
String
Imponer dominios
(Opcional)

Especifica si se impondrán reglas de dominio de campo.

  • Activado: se impondrán reglas de dominio de campo. Si no se puede actualizar un campo, el valor del campo no cambiará y los mensajes de la herramienta incluirán un mensaje de advertencia.
  • Desactivado: no se impondrán reglas de dominio de campo. Esta es la configuración predeterminada
Boolean

Salida derivada

EtiquetaExplicaciónTipo de datos
Tabla de entrada actualizada

La tabla actualizada.

Table View; Raster Layer; Mosaic Layer

arcpy.management.CalculateField(in_table, field, expression, {expression_type}, {code_block}, {field_type}, {enforce_domains})
NombreExplicaciónTipo de datos
in_table

Tabla que contiene el campo que se actualizará con el cálculo nuevo.

Mosaic Layer; Raster Layer; Table View
field

Campo que se actualizará con el cálculo nuevo.

Si no existe ningún campo con el nombre especificado en la tabla de entrada, se agregará.

Field
expression

Expresión de cálculo simple que se utiliza para crear un valor que completará las filas seleccionadas.

SQL Expression
expression_type
(Opcional)

Especifica el tipo de expresión que se utilizará.

  • PYTHON3Se utilizará el tipo de expresión de Python. Esta es la opción predeterminada.
  • ARCADESe utilizará el tipo de expresión de Arcade.
  • SQLSe utilizará el tipo de expresión de SQL.

Para obtener más información sobre las expresiones de Python, consulte Ejemplos de Calcular campo de Python.

Para obtener más información sobre las expresiones de Arcade, consulte la Guía de ArcGIS Arcade.

Para obtener más información sobre las expresiones de SQL, consulte Calcular valores de campo.

Las expresiones SQL permiten cálculos más rápidos en servicios de entidades y geodatabases corporativas. En lugar de realizar cálculos entidad por entidad o fila por fila, se define una sola solicitud para el servidor o la base de datos, lo cual genera cálculos considerablemente más rápido.

Solamente los servicios de entidades y las geodatabases corporativas son compatibles con expresiones de SQL. Para otros formatos, utilice expresiones de Python o Arcade.

String
code_block
(Opcional)

Un bloque de código que se introducirá para expresiones complejas.

String
field_type
(Opcional)

Especifica el tipo de campo del nuevo campo. Este parámetro solo se utiliza si el nombre de campo no existe en la tabla de entrada.

Si el campo es de texto, el nuevo campo tendrá una longitud de 512. En el caso de los shapefiles y los archivos de dBASE, el campo tendrá una longitud de 254. La longitud del nuevo campo se puede ajustar con la herramienta Modificar campo.

  • TEXTSe puede usar cualquier cadena de caracteres.
  • FLOATSe pueden usar números fraccionarios entre -3,4E38 y 1,2E38.
  • DOUBLESe pueden usar números fraccionarios entre -2,2E308 y 1,8E308.
  • SHORTSe pueden usar números enteros entre -32.768 y 32.767.
  • LONGSe pueden usar números enteros entre -2.147.483.648 y 2.147.483.647.
  • DATESe usarán la fecha y la hora.
  • BLOBSe usará una secuencia larga de números binarios.
  • RASTERSe usarán imágenes ráster. Aunque se pueden almacenar todos los formatos de dataset ráster admitidos por el software de ArcGIS, se recomienda utilizar solamente imágenes pequeñas.
  • GUIDSe utilizará un identificador único a nivel mundial.
String
enforce_domains
(Opcional)

Especifica si se impondrán reglas de dominio de campo.

  • ENFORCE_DOMAINSSe impondrán reglas de dominio de campo.
  • NO_ENFORCE_DOMAINSNo se impondrán reglas de dominio de campo. Esta es la opción predeterminada.
Boolean

Salida derivada

NombreExplicaciónTipo de datos
out_table

La tabla actualizada.

Table View; Raster Layer; Mosaic Layer

Muestra de código

Ejemplo 1 de CalculateField (ventana de Python)

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

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.AddField_management("vegtable.dbf", "VEG_TYP2", "TEXT", "", "", "20")
arcpy.CalculateField_management("vegtable.dbf", "VEG_TYP2", 
                                '!VEG_TYPE!.split(" ")[-1]', "PYTHON3")
Ejemplo 2 de CalculateField (script independiente)

Utilizar la función CalculateField para asignar valores de centroide a campos nuevos.

# Name: CalculateField_centroids.py

# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = "C:/data/airport.gdb"
 
# Set local variables
inFeatures = "parcels"
fieldName1 = "xCentroid"
fieldName2 = "yCentroid"
fieldPrecision = 18
fieldScale = 11
 
# Add fields
arcpy.AddField_management(inFeatures, fieldName1, "DOUBLE", 
                          fieldPrecision, fieldScale)
arcpy.AddField_management(inFeatures, fieldName2, "DOUBLE", 
                          fieldPrecision, fieldScale)
 
# Calculate centroid
arcpy.CalculateField_management(inFeatures, fieldName1, 
                                "!SHAPE.CENTROID.X!",
                                "PYTHON3")
arcpy.CalculateField_management(inFeatures, fieldName2, 
                                "!SHAPE.CENTROID.Y!",
                                "PYTHON3")
Ejemplo 3 de CalculateField (script independiente)

Utilizar la función CalculateField con un bloque de código para calcular valores basados en rangos.

# Name: CalculateField_ranges.py

# Import system modules
import arcpy
 
# Set environment settings
arcpy.env.workspace = "C:/data/airport.gdb"
 
# Set local variables
inTable = "parcels"
fieldName = "areaclass"
expression = "getClass(float(!SHAPE.area!))"

codeblock = """
def getClass(area):
    if area <= 1000:
        return 1
    if area > 1000 and area <= 10000:
        return 2
    else:
        return 3"""
 
# Execute AddField
arcpy.AddField_management(inTable, fieldName, "SHORT")
 
# Execute CalculateField 
arcpy.CalculateField_management(inTable, fieldName, expression, "PYTHON3", 
                                codeblock)
Ejemplo 4 de CalculateField (script independiente)

Utilizar la función CalculateField para asignar valores aleatorios a un campo nuevo.

# Name: CalculateField_Random.py

# Import system modules
import arcpy
import random
 
# Set environment settings
arcpy.env.workspace = "C:/data/airport.gdb"
  
# Set local variables
inFeatures = "parcels"
fieldName = "RndValue"
expression = "random.randint(0, 10)"
code_block = "import random"
 
# Execute AddField
arcpy.AddField_management(inFeatures, fieldName, "LONG")
 
# Execute CalculateField 
arcpy.CalculateField_management(inFeatures, fieldName, expression, "PYTHON3", 
                                code_block)
Ejemplo 5 de CalculateField (ventana de Python)

El siguiente script de la ventana de Python demuestra cómo utilizar la función CalculateField con ARCADE en el modo inmediato.

import arcpy
arcpy.env.workspace = "C:/data/fgdb.gdb"
arcpy.CalculateField_management("data", "new_value", "$feature.value1 + $feature.value2", "ARCADE")
Ejemplo 6 de CalculateField (ventana de Python)

El siguiente script de la ventana de Python demuestra cómo utilizar la función CalculateField con SQL en el modo inmediato.

import arcpy
feature_service = "<a feature service url>"
arcpy.CalculateField_management("data", "NEW_VALUE", "SAMPLE * (BASELINE - 40)", "SQL")

Entornos

Casos especiales

Transferir descripciones de dominio de campo

Cuando este entorno se activa, todos los campos que tienen un dominio asociado usarán la descripción del dominio en vez del valor del campo. Los valores de campos que no tienen un dominio no se verán afectados.

Información de licenciamiento

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

Temas relacionados