Calculer des champs (multiple) (Gestion des données)

Synthèse

Calcule les valeurs de plusieurs champs pour une classe d’entités, une couche d’entités ou un raster.

Utilisation

Attention :

Cet outil modifie les données en entrée. Pour plus d’informations et connaître les stratégies permettant d’empêcher les modifications de données indésirables, reportez-vous à la rubrique Outils qui modifient ou mettent à jour les données en entrée.

• Pour en savoir plus sur les expressions Python, consultez les exemples d’utilisation de l’outil Python Calculer un champ.

  Pour en savoir plus sur les expressions Arcade, reportez-vous à la documentation ArcGIS Arcade dans l’aide pour les développeurs.

  Pour en savoir plus sur les expressions SQL, reportez-vous aux rubriques Syntaxe d’une expression SQL et Calculer des valeurs de champ.

  Pour en savoir plus sur les expressions VBScript, reportez-vous à la rubrique Exemples VBScript d’utilisation de l’outil Calculer un champ.

• Les expressions Arcade de cet outil utilisent le profil Arcade Calcul de champ. Un profil Arcade est le contexte dans lequel une expression Arcade est évaluée et interprétée. Lorsqu’une expression Arcade est évaluée, la valeur de retour est convertie dans le type de champ de la valeur en sortie.

• Lorsqu’il est utilisé avec un jeu sélectionné d’entités, telles que celles créées à partir d’une requête dans l’outil Générer une couche ou l’outil Sélectionner une couche par attributs, cet outil ne met à jour que les enregistrements sélectionnés.

• Les valeurs de champs existantes seront écrasées. Pour conserver les valeurs d’origine, faites une copie de la table en entrée en sauvegarde ou utilisez l’option Activer l’annulation dans la fenêtre Géotraitement.

• Dans le cas des calculs Python, les noms de champs doivent être délimités par des points d’exclamation (!fieldname!, par exemple).

  Pour les calculs Arcade, les noms de champs doit avoir comme préfixe $feature. ($feature.fieldname, par exemple).

Remarque :

Pour transférer des valeurs temporelles entre des types de champ (Date, Date uniquement, Heure uniquement, Décalage de l’horodatage et Texte), utilisez l’outil Convertir un champ temporel à la place.

• Pour calculer des chaînes sur des champs de type texte ou caractère, dans le cas d’une boîte de dialogue, les chaînes doivent être placées entre guillemets doubles (par exemple, "chaîne"). S’il s’agit de scripts, les chaînes entre guillemets doubles doivent, à leur tour, être incluses dans des guillemets simples (par exemple, '"string"').

• Pour calculer un champ de sorte qu’il s’agisse d’une valeur numérique, fournissez la valeur numérique dans le paramètre Expression sans guillemets.

• Vous pouvez créer des expressions complexes à l’aide du paramètre Code Block (Bloc de code). Fournissez le bloc de code directement dans la boîte de dialogue ou sous la forme d’une chaîne dans des scripts. L’expression et le code de bloc sont connectés. Le code de bloc doit relier l’expression ; le résultat du code de bloc doit être transmis à l’expression.

  Le paramètre Code Block (Bloc de code) est uniquement pris en charge pour les expressions Python.

• Vous pouvez utiliser la mise en forme et le module Python math dans le paramètre Code Block (Bloc de code). Vous pouvez importer des modules supplémentaires. Le module math fournit des fonctions de représentation des nombres et d’arithmétique formelle, des fonctions logarithmiques et de puissance, des fonctions trigonométriques, des fonctions de conversion angulaire, des fonctions hyperboliques et des constantes mathématiques. Pour en savoir plus sur le module math, consultez l’aide de Python.

• Pour calculer les informations de géométrie dans Python, utilisez des propriétés d’objet Geometry. Par exemple, utilisez une expression de !shape.pointCount! pour calculer le nombre de sommets d’une entité.

  Remarque :

  L’outil Calculer des attributs géométriques prend en charge des calculs similaires.

  Pour calculer la surface et la longueur dans Python, utilisez les méthodes getArea et getLength avec un type de méthode et d’unité.

  • Pour calculer la surface géodésique de polygones en kilomètres carrés, utilisez l’expression suivante :
    !shape.getArea('GEODESIC', 'SQUAREKILOMETERS')!

  • Pour calculer la longueur plane de polylignes (ou de polygones) en yards, utilisez l’expression suivante :
    !shape.getLength('PLANAR', 'YARDS')

  Pour plus d’informations, reportez-vous aux objets ArcPy Polygon et Polyline.

  En savoir plus sur les outils de géotraitement et les unités linéaires et surfaciques

• Si vous utilisez des données jointes, vous ne pouvez modifier que les champs de la table d’origine. Vous ne pouvez pas modifier les champs de la table jointe. Pour effectuer un calcul sur la table jointe, effectuez-le directement sur cette table.

• Les expressions Python qui tentent de concaténer des champs de type chaîne comprenant une valeur nulle ou de division par zéro renvoient une valeur nulle pour cette valeur de champ.

• Les expressions SQL effectuent des calculs plus rapides pour les services d’entités. Au lieu de réaliser les calculs entité par entité ou ligne par ligne, une requête unique est envoyée au serveur, ce qui entraîne des calculs plus rapides.

  Seuls les services d’entités non versionnés prennent en charge les expressions SQL. Pour les autres formats, utilisez des expressions Python ou Arcade.

  L’utilisation de l’option SQL du paramètre Expression Type (Type d’expression) a les limitations suivantes pour les géodatabases d’entreprise :

  • Le calcul des valeurs de champ sur les tables jointes n’est pas pris en charge.
  • L’annulation des opérations de géotraitement n’est pas prise en charge.

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Table en entrée	Table contenant les champs qui sont mis à jour avec les nouveaux calculs.	Table View; Raster Layer; Mosaic Layer
Type d’expression	Précise le type d’expression qui est utilisé. Si l’entrée est un service d’entités, le type d’expression par défaut est SQL. Pour les autres types d’entrée, le type d’expression par défaut est Python. Pour en savoir plus sur les expressions Python, consultez les exemples d’utilisation de l’outil Python Calculer un champ. Pour en savoir plus sur les expressions Arcade, reportez-vous à la documentation ArcGIS Arcade dans l’aide pour les développeurs. Pour en savoir plus sur les expressions SQL, reportez-vous aux rubriques Syntaxe d’une expression SQL et Calculer des valeurs de champ. Pour en savoir plus sur les expressions VBScript, reportez-vous à la rubrique Exemples VBScript d’utilisation de l’outil Calculer un champ. Python—Le type d’expression Python est utilisé. Arcade—Le type d’expression Arcade est utilisé. SQL—Le type d’expression SQL est utilisé. VBScript—Le type d’expression VBScript sera utilisé.	String
Champs	Champs à calculer, expressions à calculer et clauses where et types de champ facultatifs. L’expression SQL facultative permet de sélectionner un sous-ensemble d’enregistrements. Seuls les enregistrements correspondant à cette clause where sont calculés. Si la clause where reste vide, tous les enregistrements sont calculés. Pour plus d’informations sur la syntaxe SQL reportez-vous à la rubrique Référence SQL pour les expressions de requête utilisées dans ArcGIS. S’il n’existe pas de champ portant le nom spécifié dans la table en entrée, il est ajouté. Le type du champ est défini à l’aide de la valeur de type de champ. Si le type de champ n’est pas indiqué, le champ sera ajouté en tant que champ de texte. Les types de champs disponibles sont les suivants : Court (Entier 16 bits) : le champ sera de type court. Les champs de type court prennent en charge les nombres entiers compris entre -32 768 et 32 767. Long (Entier 32 bits) : le champ sera de type long. Les champs de type long prennent en charge les nombres entiers compris entre 2 147 483 648 et 2 147 483 647. Entier très grand (entier de 64 bits) : le champ sera de type entier très grand. Les champs de type entier très grand prennent en charge les nombres entiers compris entre -(2^53) et 2^53. Flottant (Virgule flottante 32 bits) : le champ sera de type flottant. Les champs de type réel simple prennent en charge les nombres fractionnaires compris entre -3,4E38 et 1,2E38. Double (Virgule flottante 64 bits) : le champ sera de type double. Les champs de type réel double prennent en charge les nombres fractionnaires compris entre -2,2E308 et 1,8E308. Texte : le champ sera de type texte. Les champs de type texte prennent en charge une chaîne de caractères. Date : le champ sera de type date. Les champs de date prennent en charge les valeurs de date et d'heure. Date (haute précision) : le type de champ est Date en haute précision. Les champs de date en haute précision prennent en charge les valeurs de date et d’heure en millisecondes. Date uniquement : le champ sera de type date uniquement. Les champs Date uniquement prennent en charge des valeurs de date sans valeurs d’heure. Heure uniquement : le champ sera de type heure uniquement. Les champs de type heure uniquement prennent en charge des valeurs d’heure sans valeurs de date. Décalage de l’horodatage : le champ sera de type décalage de l’horodatage. Les champs de type décalage de l’horodatage prennent en charge des valeurs de date, d’heure et un décalage par rapport à une valeur UTC (temps universel coordonné). Blob (données binaires) : le champ sera de type BLOB. Les champs de type BLOB prennent en charge les données stockées en tant que longue séquence de nombres binaires. Vous avez besoin d'une visionneuse ou d’un chargeur personnalisé, ou d’une application tierce pour charger des attributs dans un champ BLOB ou afficher le contenu d’un champ BLOB. GUID (identifiant unique global) : le champ sera de type GUID. Les champs GUID contiennent des chaînes de registre constituées de 36 caractères placés entre des accolades. Imagerie raster : le champ sera de type raster. Les champs raster peuvent stocker les données raster dans ou avec la géodatabase. Tous les formats de jeu de données raster pris en charge par ArcGIS peuvent être stockés, mais il est recommandé de n’utiliser que des images de petite taille.	Value Table
Bloc de code (Facultatif)	Bloc de code à utiliser pour des expressions complexes. Une fonction ne permet pas de renvoyer plusieurs valeurs.	String
Appliquer des domaines (Facultatif)	Indique si les règles de domaine de champs sont appliquées. Activée : les règles de domaine de champ sont appliquées. Si un champ ne peut pas être mis à jour, sa valeur reste inchangée et les messages de l’outil incluent un message d’avertissement. Désactivée : les règles de domaine de champ ne sont pas appliquées. Il s’agit du paramètre par défaut.	Boolean

Sortie obtenue

Étiquette	Explication	Type de données
Table en sortie	Table mise à jour.	Table View; Raster Layer; Mosaic Layer

Python

arcpy.management.CalculateFields(in_table, expression_type, fields, {code_block}, {enforce_domains})

Nom	Explication	Type de données
in_table	Table contenant les champs qui sont mis à jour avec les nouveaux calculs.	Table View; Raster Layer; Mosaic Layer
expression_type	Précise le type d’expression qui est utilisé. PYTHON3—Le type d’expression Python est utilisé. ARCADE—Le type d’expression Arcade est utilisé. SQL—Le type d’expression SQL est utilisé. VB—Le type d’expression VBScript sera utilisé. Si l’entrée est un service d’entités, le type d’expression par défaut est SQL. Pour les autres types d’entrée, le type d’expression par défaut est PYTHON3. Pour en savoir plus sur les expressions Python, consultez les exemples d’utilisation de l’outil Python Calculer un champ. Pour en savoir plus sur les expressions Arcade, reportez-vous à la documentation ArcGIS Arcade dans l’aide pour les développeurs. Pour en savoir plus sur les expressions SQL, reportez-vous aux rubriques Syntaxe d’une expression SQL et Calculer des valeurs de champ. Pour en savoir plus sur les expressions VBScript, reportez-vous à la rubrique Exemples VBScript d’utilisation de l’outil Calculer un champ.	String
fields [[Field Name, Expression, {Where Clause}, {Field Type}],...]	Champs à calculer, expressions à calculer et clauses where et types de champ facultatifs. L’expression SQL facultative permet de sélectionner un sous-ensemble d’enregistrements. Seuls les enregistrements correspondant à cette clause where sont calculés. Si la clause where reste vide, tous les enregistrements sont calculés. Pour plus d’informations sur la syntaxe SQL reportez-vous à la rubrique Référence SQL pour les expressions de requête utilisées dans ArcGIS. S’il n’existe pas de champ portant le nom spécifié dans la table en entrée, il est ajouté. Le type du champ est défini à l’aide de la valeur de type de champ. Si le type de champ n’est pas indiqué, le champ sera ajouté en tant que champ de texte. Les types de champs disponibles sont les suivants : SHORT : le champ sera de type court. Les champs de type court prennent en charge les nombres entiers compris entre -32 768 et 32 767. LONG : le champ sera de type long. Les champs de type long prennent en charge les nombres entiers compris entre 2 147 483 648 et 2 147 483 647. BIGINTEGER : le champ sera de type entier très grand. Les champs de type entier très grand prennent en charge les nombres entiers compris entre -(2^53) et 2^53. FLOAT : le champ sera de type flottant. Les champs de type réel simple prennent en charge les nombres fractionnaires compris entre -3,4E38 et 1,2E38. DOUBLE : le champ sera de type double. Les champs de type réel double prennent en charge les nombres fractionnaires compris entre -2,2E308 et 1,8E308. TEXT : le champ sera de type texte. Les champs de type texte prennent en charge une chaîne de caractères. DATE : le champ sera de type date. Les champs de date prennent en charge les valeurs de date et d'heure. DATEHIGHPRECISION : le type de champ est Date en haute précision. Les champs de date en haute précision prennent en charge les valeurs de date et d’heure en millisecondes. DATEONLY : le champ sera de type date uniquement. Les champs Date uniquement prennent en charge des valeurs de date sans valeurs d’heure. TIMEONLY : le champ sera de type heure uniquement. Les champs de type heure uniquement prennent en charge des valeurs d’heure sans valeurs de date. TIMESTAMPOFFSET : le champ sera de type décalage de l’horodatage. Les champs de type décalage de l’horodatage prennent en charge des valeurs de date, d’heure et un décalage par rapport à une valeur UTC (temps universel coordonné). BLOB : le champ sera de type BLOB. Les champs de type BLOB prennent en charge les données stockées en tant que longue séquence de nombres binaires. Vous avez besoin d'une visionneuse ou d’un chargeur personnalisé, ou d’une application tierce pour charger des attributs dans un champ BLOB ou afficher le contenu d’un champ BLOB. GUID : le champ sera de type GUID. Les champs GUID contiennent des chaînes de registre constituées de 36 caractères placés entre des accolades. RASTER : le champ sera de type raster. Les champs raster peuvent stocker les données raster dans ou avec la géodatabase. Tous les formats de jeu de données raster pris en charge par ArcGIS peuvent être stockés, mais il est recommandé de n’utiliser que des images de petite taille.	Value Table
code_block (Facultatif)	Bloc de code à utiliser pour des expressions complexes. Une fonction ne permet pas de renvoyer plusieurs valeurs.	String
enforce_domains (Facultatif)	Indique si les règles de domaine de champs sont appliquées. ENFORCE_DOMAINS—Les règles de domaine de champ sont appliquées. NO_ENFORCE_DOMAINS—Les règles de domaine de champ ne sont pas appliquées. Il s’agit de l’option par défaut.	Boolean

Sortie obtenue

Nom	Explication	Type de données
out_table	Table mise à jour.	Table View; Raster Layer; Mosaic Layer

Exemple de code

Exemple 1 d’utilisation de la fonction CalculateFields (fenêtre Python)

Le script ci-dessous pour la fenêtre Python illustre l’utilisation de la fonction CalculateFields en mode immédiat avec le type d’expression Python.

import arcpy
arcpy.env.workspace = "C:/data/airport.gdb"
arcpy.management.CalculateFields("parcels", "PYTHON3", 
                                 [["xCentroid", "!SHAPE.CENTROID.X!"], 
                                  ["yCentroid", "!SHAPE.CENTROID.Y!"]])

Exemple 2 d’utilisation de la fonction CalculateFields (fenêtre Python)

Le script ci-dessous pour la fenêtre Python illustre l’utilisation de la fonction CalculateFields en mode immédiat avec le type d’expression SQL.

import arcpy
arcpy.management.CalculateFields("<a feature service url>", "SQL", 
                                 [["ceiling_field", "CEILING(field1)"], 
                                  ["floor_field", "FLOOR(field1)"]])

Exemple 3 d’utilisation de la fonction CalculateFields (fenêtre Python)

Le script ci-dessous pour la fenêtre Python illustre l’utilisation de la fonction CalculateFields en mode immédiat avec le type d’expression Arcade.

import arcpy
arcpy.env.workspace = "C:/data/airport.gdb"
arcpy.management.CalculateFields(
    "parcels", "ARCADE", 
    [["max_value", "Max($feature.field1, $feature.field2)"], 
     ["min_value", "Min($feature.field1, $feature.field2)"]])

Exemple 4 d’utilisation de la fonction CalculateFields (fenêtre Python)

Le script de fenêtre Python ci-dessous illustre l’utilisation de la fonction CalculateFields avec des expressions SQL.

import arcpy
arcpy.env.workspace = "C:/data/airport.gdb"

# Calculate the Field1 field to -1 if the value is null.
# Calculate the Title field to remove any leading spaces if the first character
# is a space.
arcpy.management.CalculateFields(
    "parcels", "PYTHON3", 
    [['Field1', -1, "Field1 IS NULL"],
     ['Title', '!Address!.lstrip()', "Title LIKE ' %'"]])

Environnements

Conserver les ID globaux