Calculer un champ (Outils de serveur GeoAnalytics)

Résumé

Crée une couche avec les valeurs de champ calculées.

Héritage :

L’extension ArcGIS GeoAnalytics Server sera bientôt obsolète dans ArcGIS Enterprise. La version finale de GeoAnalytics‏ Server a été incluse dans ArcGIS Enterprise 11.3. Cet outil de géotraitement est accessible via ArcGIS Enterprise 11.3 et versions antérieures.

Utilisation

Cet outil de géotraitement est disponible avec ArcGIS Enterprise 10.6 ou versions ultérieures.
L’outil Calculate Field (Calculer un champ) est exécuté sur les tables, ou sur les entités ponctuelles, linéaires ou surfaciques.
L’outil Calculate Field (Calculer un champ) crée toujours une couche. Il ne modifie pas l’entrée. Vous ne pouvez calculer les valeurs que pour un champ à la fois.
Vous pouvez calculer les valeurs d’un champ qui existe déjà ou d’un nouveau champ que vous ajoutez en créant un nom de champ unique.
Les expressions sont créées à l’aide des expressions Arcade.

En savoir plus sur les expressions GeoAnalytics Server Arcade avec Calculate Field (Calculer un champ)
Les expressions Arcade peuvent prendre en charge la gestion des traces. Pour les expressions de suivi de gestion, les données doivent être temporelles de type instant, et un champ de suivi doit être spécifié. Pour en savoir plus sur la création d’expressions prenant en charge les pistes, reportez-vous à la rubrique Exemples d’expressions prenant en charge les pistes.
Pour inclure un calcul de suivi de gestion, vous devez procéder comme suit :
- Utilisez une couche temporelle de type instant.
- Cochez la case Track Aware (Gestion des traces).
- Sélectionner les champs utilisés pour identifier les pistes.
Les pistes sont représentées par un ou plusieurs champs de piste. Si, par exemple, les champs flightID et Destination sont utilisés comme identifiants de trace, les entités ID007, Solden et ID007, Tokyo se trouvent dans deux traces distinctes puisqu’elles ont des valeurs différentes pour le champ Destination.
Appliquer des segments limites d'intervalle temporel permet d’effectuer un suivi à un intervalle défini. Si, par exemple, vous définissez la limite d’intervalle temporel sur une journée, à partir de 9 heures du matin le 1er janvier 1990 à 9 h 00, chaque piste sera tronquée à 9 heures chaque jour et analysée au sein de ce segment. Ce fractionnement accélère le calcul en générant de plus petites traces à analyser. Si le fractionnement selon une limite d’intervalle temporel récurrente est pertinent pour l’analyse, il est recommandé pour le traitement de Big Data. L’analyse doit permettre de gérer les traces pour définir une limite temporelle.
Outre le champ calculé, la sortie peut inclure les nouveaux types de champs suivants :
- ID d’objet
- GlobalID—Si les résultats sont stockés dans le répertoire de données spatio-temporel.
- datetime—Si les résultats sont activés temporellement. Les nouveaux champs sont instant_datetime pour le type chronologique instant, et start_datetime et end_datetime pour le type chronologique intervalle.
Vous pouvez améliorer les performances de l’outil Calculate Field (Calculer un champ) en effectuant une ou plusieurs des opérations suivantes :
- Définissez l’environnement de l’étendue de manière à analyser uniquement des données d’intérêt.
- Si vous utilisez des traces, fractionnez-les à l’aide du paramètre Time Boundary Split (Fraction de limite temporelle).
- Sélectionnez l’option Track Aware (Gestion des traces) uniquement si l’expression inclut une expression de trace.
- Utilisez les données locales de l’environnement d’exécution de l’analyse.
Cet outil de géotraitement est optimisé par ArcGIS GeoAnalytics Server. L’analyse est réalisée dans GeoAnalytics Server et les résultats sont stockés dans votre contenu dans ArcGIS Enterprise.
Lorsque vous exécutez des outils GeoAnalytics Server, l’analyse est effectuée dans GeoAnalytics Server. Pour des performances optimales, GeoAnalytics Server doit pouvoir accéder aux données via les couches d’entités hébergées sur votre portail ArcGIS Enterprise ou les partages de fichiers Big Data. Les données qui ne se trouvent pas localement dans GeoAnalytics Server sont transférées dans GeoAnalytics Server avant l’analyse. Autrement dit, l’exécution d’un outil prendra plus de temps et, dans certains cas, le transfert des données depuis ArcGIS Pro vers GeoAnalytics Server peut échouer. Le seuil d’échec dépend aussi bien des débits du réseau que de la taille et de la complexité des données. Il est recommandé de toujours partager les données ou de créer un partage de fichiers Big Data.

En savoir plus sur le partage de données sur votre portail

En savoir pus sur la création d’un partage de fichiers Big Data via ArcGIS Server Manager
Vous pouvez effectuer une analyse semblable en utilisant :
- L’outil Calculate Field (Calculer un champ) de la boîte à outils Data Management (Gestion des données)

Etiqueter	Explication	Type de données
Couche en entrée	Entités en entrée dont un champ sera calculé.	Record Set
Nom en sortie	Nom du service d'entités en sortie.	String
Nom de champ	Nom du champ dont les valeurs seront calculées. Il peut s’agir d’un champ nouveau ou existant.	String
Type de champ	Spécifie le type du champ calculé. Chaîne—Toute chaîne de caractères. Entier—Nombres entiers Double—Nombres fractionnels Date—Date	String
Expression	Calcule les valeurs dans le champ. Les expressions sont codées en langage Arcade et peuvent inclure les opérateurs [+ - * / ] ainsi que plusieurs champs. Les valeurs calculées sont appliquées dans les unités de la référence spatiale de l’entrée à moins que vous utilisiez un système de coordonnées géographiques, auquel cas elles sont exprimées en mètres. Si la couche est ajoutée à la carte, vous pouvez utiliser les filtres Fields (Champs) et Helpers (Assistants) pour créer une expression.	Calculator Expression
Gestion des traces (Facultatif)	Indique si l’expression utilise une expression permettant de gérer les traces. Activé—L’expression utilise une expression permettant de gérer les traces et un champ de trace doit être spécifié. Décoché—L’expression n’utilise aucune expression permettant de gérer les traces. Il s’agit de l’option par défaut.	Boolean
Champs de piste	Un ou plusieurs champs utilisés pour identifier des traces uniques.	Field
Stockage des données (Facultatif)	Spécifie l’instance ArcGIS Data Store dans laquelle la sortie sera stockée. Tous les résultats stockés dans un répertoire de données Big Data spatio-temporelles seront stockés en WGS84. Les résultats stockés dans un répertoire de données relationnelles conservent leur système de coordonnées. Stockage de Big Data spatio-temporelles—La sortie est stockée dans un spatiotemporal Big Data store. Il s’agit de l’option par défaut. Relational data store—La sortie sera stockée dans un data store relationnel.	String
Fractionnement de limite temporelle (Facultatif)	Période dans laquelle fractionner les données en entrée pour analyse. Une limite temporelle vous permet d’analyser des valeurs dans une période temporelle définie. Par exemple, si vous utilisez une limite temporelle de 1 jour, à partir du 1er janvier 1980, les traces seront fractionnées au début de chaque jour. Ce paramètre est disponible uniquement avec ArcGIS Enterprise 10.7 et versions ultérieures.	Time Unit
Référence de limite temporelle (Facultatif)	Référence temporelle utilisée pour fractionner les données en entrée pour l’analyse. Les limites temporelles seront créées pour toute la plage des données et il n’est pas nécessaire que la référence temporelle se situe au début. Si aucune référence temporelle n’est indiquée, le 1er janvier 1970 est utilisé. Ce paramètre est disponible uniquement avec ArcGIS Enterprise 10.7 et versions ultérieures.	Date

Sortie dérivée

Etiqueter	Explication	Type de données
Table en sortie	Nouvelle sortie dont les valeurs sont calculées.	Record Set

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

Nom	Explication	Type de données
input_layer	Entités en entrée dont un champ sera calculé.	Record Set
output_name	Nom du service d'entités en sortie.	String
field_name	Nom du champ dont les valeurs seront calculées. Il peut s’agir d’un champ nouveau ou existant.	String
field_type	Spécifie le type du champ calculé. `STRING`—Le nouveau champ sera de type texte. `INTEGER`—Le nouveau champ sera de type entier. `FLOAT`—Le nouveau champ sera de type flottant. `DATE`—Le nouveau champ sera de type date.	String
expression	Calcule les valeurs dans le champ. Les expressions sont codées en langage Arcade et peuvent inclure des opérateurs ainsi que plusieurs champs. Les valeurs calculées sont appliquées dans les unités de la référence spatiale de l’entrée à moins que vous utilisiez un système de coordonnées géographiques, auquel cas elles sont exprimées en mètres.	Calculator Expression
track_aware (Facultatif)	Indique si l’expression utilise une expression permettant de gérer les traces. `TRACK_AWARE`—L’expression utilise une expression permettant de gérer les traces et un champ de trace doit être spécifié. `NOT_TRACK_AWARE`—L’expression n’utilise aucune expression permettant de gérer les traces. Il s’agit de l’option par défaut.	Boolean
track_fields [track_fields,...]	Un ou plusieurs champs utilisés pour identifier des traces uniques.	Field
data_store (Facultatif)	Spécifie l’instance ArcGIS Data Store dans laquelle la sortie sera stockée. Tous les résultats stockés dans un répertoire de données Big Data spatio-temporelles seront stockés en WGS84. Les résultats stockés dans un répertoire de données relationnelles conservent leur système de coordonnées. `SPATIOTEMPORAL_DATA_STORE`—La sortie est stockée dans un spatiotemporal Big Data store. Il s’agit de l’option par défaut. `RELATIONAL_DATA_STORE`—La sortie sera stockée dans un data store relationnel.	String
time_boundary_split (Facultatif)	Période dans laquelle fractionner les données en entrée pour analyse. Une limite temporelle vous permet d’analyser des valeurs dans une période temporelle définie. Par exemple, si vous utilisez une limite temporelle de 1 jour, à partir du 1er janvier 1980, les traces seront fractionnées au début de chaque jour. Ce paramètre est disponible uniquement avec ArcGIS Enterprise 10.7 et versions ultérieures.	Time Unit
time_boundary_reference (Facultatif)	Référence temporelle utilisée pour fractionner les données en entrée pour l’analyse. Les limites temporelles seront créées pour toute la plage des données et il n’est pas nécessaire que la référence temporelle se situe au début. Si aucune référence temporelle n’est indiquée, le 1er janvier 1970 est utilisé. Ce paramètre est disponible uniquement avec ArcGIS Enterprise 10.7 et versions ultérieures.	Date

Sortie dérivée

Nom	Explication	Type de données
output_table	Nouvelle sortie dont les valeurs sont calculées.	Record Set

Exemple de code

Exemple d’utilisation de l’outil CalculateField (script autonome)

Le script Python ci-dessous illustre l’utilisation de la fonction 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 Calculate Field
arcpy.geoanalytics.CalculateField(inFeatures, outFS, newField, "Double",
                                  calcExpression, True, trackIdentifier)

Environnements

Système de coordonnées en sortie, Etendue, Espace de travail courant

Cas particuliers

Système de coordonnées en sortie: The coordinate system that will be used for analysis. Analysis will be completed in the input coordinate system unless specified by this parameter. For GeoAnalytics Tools, final results will be stored in the spatiotemporal data store in WGS84.

Informations de licence

Basic: Requiert ArcGIS GeoAnalytics Server
Disponible avec ArcGIS Enterprise 10.6
Standard: Requiert ArcGIS GeoAnalytics Server
Disponible avec ArcGIS Enterprise 10.6
Advanced: Requiert ArcGIS GeoAnalytics Server
Disponible avec ArcGIS Enterprise 10.6

Calculer un champ (Outils de serveur GeoAnalytics)

Résumé

Héritage :

Utilisation

Paramètres

Sortie dérivée

Environnements

Cas particuliers

Informations de licence

Rubriques connexes