Etiqueta | Explicación | Tipo de datos |
Capa de entrada | Las entidades de entrada para las que se calculará un campo. | Table View |
Dataset de salida | Un dataset nuevo con campos calculados. | Feature Class;Table |
Campo a calcular | Especifica si se calcularán valores para un campo recién creado o para un campo existente.
| String |
Nuevo nombre de campo (Opcional) | El nuevo campo para el que se calcularán valores. | String |
Campo existente (Opcional) | El campo existente para el que se calcularán valores. | Field |
Tipo de campo (Opcional) | Especifica el tipo de campo para el campo calculado.
| 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.
| Boolean |
Campos de recorrido | Uno o varios campos que se utilizarán para identificar recorridos únicos. | Field |
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 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 |
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. | Date |
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 instante de tipo tiempo, y start_date y end_date 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 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 su ArcGIS GeoAnalytics Server para realizar un análisis, consulte GeoAnalytics Tools.
Parámetros
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})
Nombre | 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.
| 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 |
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.
| 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
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
# 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)"
# Run Calculate Field
arcpy.gapro.CalculateField(inFeatures, out, "NEW_FIELD", fieldName, "", "Date",
calcExpression)
Información de licenciamiento
- Basic: No
- Standard: No
- Advanced: Sí