Calcular campo (Geoanálisis)

Resumen

Crea una capa con los valores de campo calculados.

Heredado:

La extensión de ArcGIS GeoAnalytics Server quedará obsoleta en ArcGIS Enterprise. La versión final de GeoAnalytics Server se incluyó con ArcGIS Enterprise 11.3. Esta herramienta de geoprocesamiento está disponible a través de ArcGIS Enterprise 11.3 y versiones anteriores.

Uso

• Esta herramienta de geoprocesamiento está disponible con ArcGIS Enterprise 10.6 o posterior.

• 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.

  Más información sobre las expresiones de GeoAnalytics Server Arcade en Calcular campo

• 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.

• 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
  • GlobalID: si los resultados se almacenan en el data store espaciotemporal.
  • Datetime: si los resultados tienen seguimiento de tiempo. Los campos nuevos son instant_datetime, para el instante de tipo tiempo, y start_datetime y end_datetime para intervalo de tipo tiempo.

• 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 ArcGIS GeoAnalytics Server. El análisis se completa en GeoAnalytics Server y los resultados se almacenan en su contenido en ArcGIS Enterprise.

• Al ejecutar herramientas de GeoAnalytics Server, el análisis se completa en GeoAnalytics Server. Para obtener un rendimiento óptimo, haga que los datos estén disponibles para GeoAnalytics Server mediante capas de entidades alojadas en su portal de ArcGIS Enterprise o mediante recursos compartidos de archivos de big data. Los datos que no son locales para GeoAnalytics Server se moverán a GeoAnalytics Server antes de que comience el análisis. Significa que ejecutar una herramienta tardará más tiempo y, en algunos casos, mover los datos de ArcGIS Pro a GeoAnalytics Server podría fallar. El umbral de error depende de la velocidad de su red, así como del tamaño y complejidad de los datos. Se recomienda que siempre comparta sus datos o que cree un recurso compartido de archivos de big data.

  Más información acerca del uso compartido de datos en el portal

  Más información sobre cómo crear un archivo compartido de Big Data mediante Server Manager

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

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

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Capa de entrada	Las entidades de entrada para las que se calculará un campo.	Record Set
Nombre de salida	El nombre del servicio de entidades de salida.	String
Nombre de campo	El nombre del campo que tendrá valores calculados. Puede tratarse del nombre de un campo existente o de un campo nuevo.	String
Tipo de campo	Especifica el tipo de campo para el campo calculado. Cadena de caracteres—Cualquier cadena de caracteres Entero—Números enteros Doble—Números fraccionarios Fecha—Fecha	String
Expresión	Calcula los valores del campo. Las expresiones están escritas en Arcade y pueden incluir los 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. Si se agrega la capa al mapa, es posible usar los filtros Campos y Auxiliares para construir una expresión.	Calculator Expression
Tiempo habilitado (Opcional)	Especifique si la expresión utilizará una expresión que realiza seguimiento. Activado: la expresión utilizará una expresión que realiza seguimiento y se debe especificar un campo de recorrido. Desactivado: la expresión no utilizará ninguna expresión que realice seguimiento. Esta es la opción predeterminada.	Boolean
Campos de recorrido	Uno o varios campos que se utilizarán para identificar recorridos únicos.	Field
Data store (Opcional)	Especifica el ArcGIS Data Store donde se almacenará la salida. Todos los resultados almacenados en un big data store espaciotemporal se almacenarán en WGS84. Los resultados almacenados en un data store relacional mantendrán su sistema de coordenadas. Big data store espaciotemporal—La salida se almacenará en un big data store espaciotemporal. Esta es la opción predeterminada. Data store relacional—La salida se almacenará en un data store relacional.	String
División de límite de tiempo (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, desde el 1 de enero de 1980, los recorridos se dividirán al comienzo de cada día. Este parámetro solo está disponible con ArcGIS Enterprise 10.7 y posteriores.	Time Unit
Referencia de límite de tiempo (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. Este parámetro solo está disponible con ArcGIS Enterprise 10.7 y posteriores.	Date

Salida derivada

Etiqueta	Explicación	Tipo de datos
Tabla de Salida	La nueva salida con valores calculados.	Record Set

Python

arcpy.geoanalytics.CalculateField(input_layer, output_name, field_name, field_type, expression, {track_aware}, track_fields, {data_store}, {time_boundary_split}, {time_boundary_reference})

Nombre	Explicación	Tipo de datos
input_layer	Las entidades de entrada para las que se calculará un campo.	Record Set
output_name	El nombre del servicio de entidades de salida.	String
field_name	El nombre del campo que tendrá valores calculados. Puede tratarse del nombre de un campo existente o de un campo nuevo.	String
field_type	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
data_store (Opcional)	Especifica el ArcGIS Data Store donde se almacenará la salida. Todos los resultados almacenados en un big data store espaciotemporal se almacenarán en WGS84. Los resultados almacenados en un data store relacional mantendrán su sistema de coordenadas. SPATIOTEMPORAL_DATA_STORE—La salida se almacenará en un big data store espaciotemporal. Esta es la opción predeterminada. RELATIONAL_DATA_STORE—La salida se almacenará en un data store relacional.	String
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, desde el 1 de enero de 1980, los recorridos se dividirán al comienzo de cada día. Este parámetro solo está disponible con ArcGIS Enterprise 10.7 y posteriores.	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. Este parámetro solo está disponible con ArcGIS Enterprise 10.7 y posteriores.	Date

Salida derivada

Nombre	Explicación	Tipo de datos
output_table	La nueva salida con valores calculados.	Record Set

Muestra de código

Ejemplo 1 de Calculate Field (ventana de Python)

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

# Name: CalculateField.py
# Description: Calculate the mean of the 3 most recent speed measurements in hurricane tracks

# Requirements: ArcGIS GeoAnalytics Server

# Import system modules
import arcpy

# Set local variables
inFeatures = "https://example.arcgis.com/arcgis/rest/services/Hurricanes/FeatureServer/0"
newField = "MeanSpeed3"
outFS = "HurricaneTracks_Mean"
trackIdentifier = "Name"
calcExpression = "Average($track.field['WINDSPEED'].history(-3))"

# Run Reconstruct Tracks
arcpy.geoanalytics.CalculateField(inFeatures, outFS, newField, "Double", 
                                  calcExpression, True, trackIdentifier)

Entornos

Sistema de coordenadas de salida, Extensión, Espacio de trabajo actual

Casos especiales

Sistema de coordenadas de salida

El sistema de coordenadas que se usará para el análisis. El análisis se completará en el sistema de coordenadas de entrada salvo que este parámetro especifique otra opción. En GeoAnalytics Tools, los resultados finales se almacenarán en el data store espaciotemporal en WGS84.

Información de licenciamiento

• Basic: Requiere ArcGIS GeoAnalytics Server
• Standard: Requiere ArcGIS GeoAnalytics Server
• Advanced: Requiere ArcGIS GeoAnalytics Server