Calcular campo (GeoAnalytics Desktop)

Resumen

Crea una capa con los valores de campo calculados.

Uso

• Calcular campo se completa en tablas o entidades de puntos, líneas o polígonos.

• Calcular campo creará siempre una capa. No modificará la entrada. Solo puede calcular valores para un único campo cada vez.

• Puede calcular los valores para un campo existente o para un campo nuevo que agregue creando un nombre de campo único.

• Las expresiones se crean mediante expresiones de Arcade. Consulte Expresiones de Arcade en las herramientas de GeoAnalytics Desktop para obtener más información.

• Las expresiones de Arcade pueden realizar seguimiento. Las expresiones que realizan seguimiento requieren que los datos tengan la función de tiempo habilitada y el tipo de tiempo de instante y que se especifique un campo de recorrido. Para obtener más información sobre cómo crear expresiones que realicen seguimiento, consulte Ejemplos con seguimiento.

• Para incluir un cálculo que realice seguimiento, debe hacer lo siguiente:

  • Utilice una capa que tenga la función de tiempo habilitada y sea de tipo de tiempo de instante.
  • Active la casilla de verificación Tiempo habilitado.
  • Seleccione los campos utilizados para identificar recorridos.

• Los recorridos se representan mediante la combinación única de uno o más campos de recorrido. Por ejemplo, si se utilizan los campos flightID y Destination como identificadores de recorrido, las entidades ID007, Solden y ID007, Tokyo estarían separadas en dos recorridos, dado que tienen valores diferentes para el campo Destination.

• Se puede completar un análisis similar usando lo siguiente:

  • La herramienta Calcular campo de la caja de herramientas Administración de datos

• Aplicar segmentos de límites de intervalos de tiempo realiza un seguimiento en un intervalo definido. Por ejemplo, si establece el límite de intervalo de tiempo en 1 día, a partir de las 9:00 AM del 1 de enero de 1990, cada recorrido se truncará a las 9:00 AM cada día y se analizará dentro de dicho segmento. Esta división acelera el tiempo de procesamiento, ya que crea recorridos más pequeños para el análisis. Si a su análisis le conviene dividir por un límite de intervalo de tiempo recurrente, le recomendamos que lo haga para procesar big data. El análisis debe realizar seguimiento para definir un límite de tiempo.

• Además del campo calculado, la salida puede incluir los siguientes tipos de campo nuevos:

  • ObjectID
  • Datetime: si los resultados tienen seguimiento de tiempo. Los campos nuevos son instant_date, para el tipo de tiempo de instante, y start_date y end_date para tiempo de tipo de intervalo.

• Es posible mejorar el rendimiento de la herramienta Calcular campo realizando una o varias de las siguientes acciones:

  • Defina el entorno de extensión para analizar únicamente datos de interés.
  • Si va a utilizar recorridos, divídalos con el parámetro División de límite de tiempo.
  • Seleccione Tiempo habilitado solo si su expresión incluye una expresión de recorrido.
  • Utilice datos locales en los que se ejecute el análisis.

• Esta herramienta de geoprocesamiento se basa en Spark. El análisis se completa en su equipo de escritorio utilizando varios núcleos en paralelo. Consulte Consideraciones acerca de las herramientas de GeoAnalytics Desktop para obtener más información acerca de la ejecución de análisis.

• Al ejecutar herramientas de GeoAnalytics Desktop, el análisis se completa en su equipo de escritorio. Para un rendimiento óptimo, los datos deben estar disponibles en su escritorio. Si utiliza una capa de entidades alojada, se recomienda utilizar ArcGIS GeoAnalytics Server. Si sus datos no están almacenados localmente, se tardará más tiempo en ejecutar una herramienta. Para utilizar ArcGIS GeoAnalytics Server con el fin de realizar un análisis, consulte GeoAnalytics Tools.

Sintaxis

arcpy.gapro.CalculateField(input_layer, output, field_to_calculate, {field_name}, {existing_field}, {field_type}, expression, {track_aware}, track_fields, {time_boundary_split}, {time_boundary_reference})

Parámetro	Explicación	Tipo de datos
input_layer	Las entidades de entrada para las que se calculará un campo.	Table View
output	Un dataset nuevo con campos calculados.	Feature Class;Table
field_to_calculate	Especifica si se calcularán valores para un campo recién creado o para un campo existente. NEW_FIELD —Se calcularán valores para un campo recién creado. EXISTING_FIELD —Se calcularán valores para un campo existente.	String
field_name (Opcional)	El nuevo campo para el que se calcularán valores.	String
existing_field (Opcional)	El campo existente para el que se calcularán valores.	Field
field_type (Opcional)	Especifica el tipo de campo para el campo calculado. STRING —El nuevo campo será de tipo texto. INTEGER — El nuevo campo será de tipo entero. FLOAT — El nuevo campo será de tipo flotante. DATE — El nuevo campo será de tipo fecha.	String
expression	Calcula los valores del campo. Las expresiones están escritas en Arcade y pueden incluir operadores y varios campos. Los valores calculados se aplican en las unidades de la referencia espacial de la entrada, a menos que se use un sistema de coordenadas geográficas, en cuyo caso estarán en metros.	Calculator Expression
track_aware (Opcional)	Especifique si la expresión utilizará una expresión que realiza seguimiento. TRACK_AWARE —La expresión utilizará una expresión que realiza seguimiento y se debe especificar un campo de recorrido. NOT_TRACK_AWARE —La expresión no utilizará ninguna expresión que realice seguimiento. Esta es la opción predeterminada.	Boolean
track_fields [track_fields,...]	Uno o varios campos que se utilizarán para identificar recorridos únicos.	Field
time_boundary_split (Opcional)	Un intervalo de tiempo en el que dividir los datos de entrada para el análisis. Un límite de tiempo permite analizar los valores dentro de un intervalo de tiempo definido. Por ejemplo, si utiliza un límite de tiempo de 1 día y establece la referencia de límite de tiempo en el 1 de enero de 1980, los recorridos se dividirán al comienzo de cada día.	Time Unit
time_boundary_reference (Opcional)	El tiempo de referencia utilizado para dividir los datos de entrada para el análisis. Se crearán límites de tiempo para todo el intervalo de los datos y no es necesario que el tiempo de referencia se encuentre en el comienzo. Si no se especifica ningún tiempo de referencia, se utilizará el 1 de enero de 1970.	Date

Muestra de código

Ejemplo de CalculateField (ventana de Python)

El siguiente script de la ventana de Python muestra cómo utilizar la herramienta CalculateField.

#-------------------------------------------------------------------------------
# Name: CalculateField.py
# Description: Calculate the mean of the 3 most recent speed measurements in hurricane tracks
# Import system modules
import arcpy
arcpy.env.workspace = "C:/data/Weather.gdb"
# Set local variables
inFeatures = "Hurricanes"
fieldName = "MeanSpeed3"
out = "HurricaneTracks_Mean"
calcExpression = "Date($feature.DateAsString)"
# Execute Calculate Field
arcpy.gapro.CalculateField(inFeatures, out, "NEW_FIELD", fieldName, "", "Date", 
                           calcExpression)

Entornos

Sistema de coordenadas de salida, Extensión, Espacio de trabajo actual, Factor de procesamiento en paralelo

Información de licenciamiento

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