Calculer un champ (GeoAnalytics)

Synthèse

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

Utilisation

  • Cet outil de géotraitement est disponible avec ArcGIS Enterprise 10.6 ou version ultérieure.

  • L’outil Calculer un champ est effectué sur les tables, les entités ponctuelles, linéaires ou surfaciques.

  • L’outil 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 Calculer un champ

  • Les expressions Arcade peuvent prendre en charge le suivi. 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 du suivi).
    • Sélectionner les champs utilisés pour identifier les pistes.

  • Les traces sont représentées par un ou plusieurs champs de trace. Si, par exemple, les champs flightID et Destination sont utilisés comme identifiants de pistes, les entités ID007, Solden et ID007, Tokyo figurent dans deux pistes distinctes étant donné que le champ Destination contient des valeurs différentes.

  • 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. Cette fraction réduit le temps de calcul car elle crée des pistes plus petites pour l’analyse. Si le fractionnement selon une limite d’intervalle temporel récurrente est pertinent pour votre analyse, il est recommandé pour le traitement de Big Data. Votre analyse permet de gérer les pistes pour définir une limite temporelle.

  • Outre le champ calculé, la sortie peut inclure les nouveaux types de champs suivants :

    • ObjectID
    • 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 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 pistes, fractionnez-les à l’aide du paramètre Time Boundary Split (Limite de fraction temporelle).
    • Ne sélectionnez Track Aware (Gestion du suivi) si votre expression inclut une expression de suivi.
    • Utilisez les données locales de l’environnement de l’analyse.

  • Cet outil de géotraitement est mis en œuvre par ArcGIS GeoAnalytics Server. L’analyse est réalisée sur GeoAnalytics Server et les résultats sont stockés dans votre contenu dans ArcGIS Enterprise.

  • Lors de l’exécution des outils GeoAnalytics Server, l’analyse est réalisée sur 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 sont pas locales pour GeoAnalytics Server sont transférées sur GeoAnalytics Server avant le début de l’analyse. Autrement dit, l’exécution d’un outil prend 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.

    Pour en savoir plus sur le partage des données dans 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 de géotraitement Calculer un champ dans la boîte à outils  Gestion des données

Paramètres

ÉtiquetteExplicationType 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 un nom de champ existant ou nouveau.

String
Type de champ

Spécifie le type du champ calculé.

  • ChaîneToute chaîne de caractères.
  • EntierNombres entiers
  • DoubleNombres fractionnels
  • DateDate
String
Expression

Calcule les valeurs dans le champ. Les expressions sont écrites dans le langage Arcade et peuvent inclure les opérateurs [+ - * / ] et 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, les filtres Fields (Champs) et Helpers (Assistants) permettent de construire 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 gérant le suivi et un champ de suivi doit être spécifié.
  • Désactivé : l’expression n’utilise aucune expression gérant le suivi. Il s’agit de l’option par défaut.

Boolean
Champs de trace

Un ou plusieurs champs utilisés pour identifier des pistes uniques.

Field
Data store
(Facultatif)

Indique l’instance ArcGIS Data Store dans laquelle la sortie est enregistrée. La valeur par défaut est Stockage de Big Data spatio-temporelles. 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-temporellesLa sortie sera stockée dans un stockage de Big Data spatio-temporelles. Il s’agit de l’option par défaut.
  • Stockage des données relationnellesLa sortie sera stockée dans un data store relationnel.
String
Fraction 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 version ultérieure.

Time Unit
Référence de limite temporelle
(Facultatif)

Référence temporelle dans laquelle fractionner les données en entrée pour 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 version ultérieure.

Date

Sortie obtenue

ÉtiquetteExplicationType 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})
NomExplicationType 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 un nom de champ existant ou nouveau.

String
field_type

Spécifie le type du champ calculé.

  • STRINGLe nouveau champ sera de type texte.
  • INTEGERLe nouveau champ sera de type entier.
  • FLOATLe nouveau champ sera de type flottant.
  • DATELe nouveau champ sera de type date.
String
expression

Calcule les valeurs dans le champ. Les expressions sont écrites dans le langage Arcade et peuvent inclure des opérateurs et 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_AWAREL’expression utilise une expression permettant de gérer les traces et un champ de trace doit être spécifié.
  • NOT_TRACK_AWAREL’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 pistes uniques.

Field
data_store
(Facultatif)

Indique l’instance ArcGIS Data Store dans laquelle la sortie est enregistrée. La valeur par défaut est SPATIOTEMPORAL_DATA_STORE. 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_STORELa sortie sera stockée dans un stockage de Big Data spatio-temporelles. Il s’agit de l’option par défaut.
  • RELATIONAL_DATA_STORELa 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 version ultérieure.

Time Unit
time_boundary_reference
(Facultatif)

Référence temporelle dans laquelle fractionner les données en entrée pour 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 version ultérieure.

Date

Sortie obtenue

NomExplicationType de données
output_table

Nouvelle sortie dont les valeurs sont calculées.

Record Set

Exemple de code

Exemple 1 d'utilisation de l'outil Calculer un champ (fenêtre Python)

Le script suivant pour la fenêtre Python 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 Reconstruct Tracks
arcpy.geoanalytics.CalculateField(inFeatures, outFS, newField, "Double", 
                                  calcExpression, True, trackIdentifier)

Environnements

Cas particuliers

Système de coordonnées en sortie

Système de coordonnées qui sera utilisé pour l'analyse. L’analyse sera réalisée dans le système de coordonnées en entrée, à moins que ce paramètre en spécifie un autre. Pour GeoAnalytics Tools, les résultats finaux sont stockés dans le stockage des données spatio-temporelles dans WGS84.

Informations de licence

  • Basic: Nécessite ArcGIS GeoAnalytics Server
  • Standard: Nécessite ArcGIS GeoAnalytics Server
  • Advanced: Nécessite ArcGIS GeoAnalytics Server

Rubriques connexes