| Étiquette | Explication | Type de données |
Couche en entrée | Entités en entrée dont un champ sera calculé. | Table View |
Jeu de données en sortie | Nouveau jeu de données avec les champs calculés. | Feature Class;Table |
Champ à calculer | Indique si les valeurs sont calculées pour un champ nouvellement créé ou un champ existant.
| String |
Nom du nouveau champ (Facultatif) | Nouveau champ dont les valeurs sont calculées. | String |
Champ existant (Facultatif) | Champ existant dont les valeurs sont calculées. | Field |
Type de champ (Facultatif) | Spécifie le type du champ calculé.
| 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.
| Boolean |
Champs de trace | Un ou plusieurs champs utilisés pour identifier des pistes uniques. | Field |
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 et que vous définissez la référence de limite temporelle au 1er janvier 1980, les traces seront fractionnées au début de chaque jour. | Time Unit |
Référence de la 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é. | Date |
Synthèse
Crée une couche avec les valeurs de champ calculées.
Utilisation
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. Pour plus d’informations, reportez-vous à Expressions Arcade dans les outils GeoAnalytics Desktop.
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.
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
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
- datetime : si les résultats sont activés temporellement. Les nouveaux champs sontinstant_date pour le type chronologique instant, et start_date et end_date 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 Spark. L'analyse est effectuée sur votre ordinateur de bureau à l'aide de plusieurs cœurs en parallèle. Pour en savoir plus sur l'exécution d'une analyse, reportez-vous à la rubrique Remarques sur les outils de GeoAnalytics Desktop.
Lors de l’exécution d’outils de GeoAnalytics Desktop, l’analyse est effectuée sur votre ordinateur de bureau. Pour des performances optimales, les données doivent être disponibles sur votre bureau : Si vous utilisez une couche d’entités hébergée, il est recommandé d'utiliser ArcGIS GeoAnalytics Server. Si vos données ne sont pas locales, l'exécution d'un outil est plus longue. Pour utiliser votre ArcGIS GeoAnalytics Server en vue d'une analyse, reportez-vous à la rubrique GeoAnalytics Tools.
Paramètres
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})| Nom | Explication | Type de données |
input_layer | Entités en entrée dont un champ sera calculé. | Table View |
output | Nouveau jeu de données avec les champs calculés. | Feature Class;Table |
field_to_calculate | Indique si les valeurs sont calculées pour un champ nouvellement créé ou un champ existant.
| String |
field_name (Facultatif) | Nouveau champ dont les valeurs sont calculées. | String |
existing_field (Facultatif) | Champ existant dont les valeurs sont calculées. | Field |
field_type (Facultatif) | Spécifie le type du champ calculé.
| 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.
| Boolean |
track_fields [track_fields,...] | Un ou plusieurs champs utilisés pour identifier des pistes uniques. | Field |
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 et que vous définissez la référence de limite temporelle au 1er janvier 1980, les traces seront fractionnées au début de chaque jour. | 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é. | Date |
Exemple de code
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
# 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)Environnements
Informations de licence
- Basic: Non
- Standard: Non
- Advanced: Oui
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?