Calcular campo (Administración de datos)

Resumen

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

Ver ejemplos de usos de la herramienta Calcular campo

Uso

• Se pueden crear expresiones en Python con las propiedades del objetode geometría (type, extent, centroid, firstPoint, lastPoint, area, length, isMultipart y partCount).

  !shape.area!
  

• Las expresiones de Python pueden utilizar las propiedades area y length de la geometría con una unidad lineal o de área para convertir el valor en una unidad de medida diferente (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. Utilizar unidades de área en los datos geográficos producirá resultados cuestionables ya que los grados decimales no son consistentes en el globo.

  • Palabras clave de unidad de medida de área:
    • ACRES | ARES | HECTARES | SQUARECENTIMETERS | SQUAREDECIMETERS | SQUAREINCHES | SQUAREFEET | SQUAREKILOMETERS | SQUAREMETERS | SQUAREMILES | SQUAREMILLIMETERS | SQUAREYARDS | SQUAREMAPUNITS | UNKNOWN
  • Palabras clave de unidad de medida lineal:
    • CENTIMETERS | DECIMALDEGREES | DECIMETERS | FEET | INCHES | KILOMETERS | METERS | MILES | MILLIMETERS | NAUTICALMILES | POINTS | UNKNOWN | YARDS

• En el cuadro de diálogo de la herramienta, se puede introducir una expresión directamente en el parámetro Expresión o se puede construir una expresión interactivamente con la Calculadora de campo.

• Cuando se utiliza con un conjunto seleccionado de entidades, como las creadas a partir de una consulta en 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.

• Los valores de campo existentes se sobrescriben. Si desea preservar los valores originales, se debe hacer una copia de la tabla de entrada.

• Para cálculos en Python, los nombres de campo deben estar entre signos de admiración (!fieldname!).

  Para cálculos en VB, los nombres de campo deben estar entre corchetes ([fieldname]).

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

• Esta herramienta también se puede utilizar para actualizar elementos de caracteres. Las expresiones que utilizan una cadena de caracteres deben estar entre comillas simples, por ejemplo, [CHARITEM] = 'CADENA NUEVA'. Sin embargo, si la cadena de caracteres ya tiene comillas simples, enciérrela entre comillas dobles, por ejemplo, [CHARITEM] = "TIPO'A'".

• Para calcular un campo para que sea un valor numérico, introduzca el valor numérico en el parámetro Expresión; no se requieren comillas para este valor.

• Cuando se especifica una expresión en Python, esta herramienta admite la función arcgis.rand(). La función arcgis.rand() se creó para las herramientas de ArcGIS y no debe confundirse con la función Python Rand(). La sintaxis de las distribuciones disponibles para la función arcgis.rand() se puede encontrar en La sintaxis de distribución de los valores aleatorios.

• La expresión y el código bloque están conectados. El código bloque debe estar relacionado con la expresión; el resultado del código bloque se debe pasar a la expresión.

• El parámetro Código bloque permiten crear expresiones complejas. Puede introducir el código bloque directamente en el cuadro de diálogo o como una cadena continua en una secuencia de comandos.

• El módulo y el formato de matemática de Python están disponibles para utilizarse en el parámetro Código bloque. Puede importar módulos adicionales. El módulo de matemática proporciona funciones de teoría de números y de representación, 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 de matemática, consulte la ayuda de Python.

• Los archivos .cal VB guardados de versiones anteriores de ArcGIS pueden funcionar o pueden precisar modificaciones mínimas. Si tiene código VBA de versiones anterior que utilizan ArcObjects, deberá modificar los cálculos para que funcionen.

• 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 debe agregar las tablas o capas unidas a ArcMap. Después puede realizar cálculos en estos datos por separado. Estos cambios se reflejarán en las columnas que se unieron.

• Ejemplos de Calcular campo

Sintaxis

CalculateField_management (in_table, field, expression, {expression_type}, {code_block})

Parámetro	Explicación	Tipo de datos
in_table	Tabla que contiene el campo que se actualizará con el cálculo nuevo.	Mosaic Layer; Raster Catalog Layer; Raster Layer; Table View
field	Campo que se actualizará con el cálculo nuevo.	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)	Especifique el tipo de expresión que se utilizará. VB —La expresión se escribe en formato VB estándar. Esta es la opción predeterminada. PYTHON —La expresión se escribe en un formato estándar de Python. El uso de propiedades y métodos de geoprocesadores es igual a la creación de un geoprocesador de la versión 9.2. PYTHON_9.3 —La expresión se escribe en un formato estándar de Python. El uso de propiedades y métodos de geoprocesadores es igual a la creación de un geoprocesador de la versión 9.3.	String
code_block (Opcional)	Permite introducir un bloque de código para expresiones complejas.	String

Ejemplo de código

Ejemplo de CalculateField (ventana de Python)

La siguiente secuencia de comandos de la ventana de Python muestra cómo utilizar la función CalculateField en el modo inmediato.

import arcpy from arcpy import env env.workspace = "C:/data" arcpy.AddField_management("vegtable.dbf", "VEG_TYP2", "TEXT", "", "", "20") arcpy.CalculateField_management("vegtable.dbf", "VEG_TYP2",                                  '!VEG_TYPE!.split(" ")[-1]', "PYTHON_9.3")

Ejemplo de CalculateField: Calcular centroides

Utilice CalculateField para asignar valores del centroide a campos nuevos.

# Name: CalculateField_Centroids.py # Description: Use CalculateField to assign centroid values to new fields  # Import system modules import arcpy from arcpy import env  try:      # Set environment settings     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!",                                     "PYTHON_9.3")     arcpy.CalculateField_management(inFeatures, fieldName2,                                      "!SHAPE.CENTROID.Y!",                                     "PYTHON_9.3") except Exception as e:     # If an error occurred, print line number and error message     import traceback     import sys     tb = sys.exc_info()[2]     print("Line {0}".format(tb.tb_lineno))     print(e.message)

Ejemplo de CalculateField: Calcular rangos

Utilice CalculateField con un código bloque para calcular los valores basados en rangos.

# Name: CalculateField_Ranges.py # Description: Use CalculateField with a codeblock to calculate values #  based on ranges  # Import system modules import arcpy from arcpy import env   # Set environment settings 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, "PYTHON_9.3",                                  codeblock)

Ejemplo de CalculateField: Calcular valores aleatorios

Utilice CalculateField para asignar valores aleatorios al campo nuevo.

# Name: CalculateField_Random.py # Description: Use CalculateField to assign random values to a new field   # Import system modules import arcpy from arcpy import env   # Set environment settings env.workspace = "C:/data/airport.gdb"    # Set local variables inFeatures = "parcels" fieldName = "RndValue" expression = "arcgis.rand('Integer 0 10')"   # Execute AddField arcpy.AddField_management(inFeatures, fieldName, "LONG")   # Execute CalculateField  arcpy.CalculateField_management(inFeatures, fieldName, expression, "PYTHON_9.3")

Entornos

Espacio de trabajo actual