Calculer une valeur (ModelBuilder)

Résumé

Renvoie une valeur en fonction d’une expression Python spécifiée.

Utilisation

• Cet outil est prévu pour une utilisation dans ModelBuilder, et non dans des scripts Python.

• Le paramètre Type de données est utilisé dans ModelBuilder pour faciliter l'enchaînement de la sortie de l'outil Calculer une valeur avec d'autres outils. Par exemple, si vous utilisez l'outil Calculer une valeur pour calculer une distance à utiliser en entrée dans le paramètre Distance de la zone tampon de l'outil Zone tampon, définissez le paramètre Type de données sur Unité linéaire.

• Les variables créées dans ModelBuilder peuvent être utilisées par cet outil, mais les variables qui doivent être utilisées dans le paramètre d'expression ne peuvent pas être associées à l'outil Calculer une valeur. Pour les utiliser dans l'expression, placez le nom de la variable entre des signes de pourcentage (%). Si vous souhaitez par exemple diviser une variable nommée 'Entrée' par 100, votre expression sera la suivante : %Entrée%/100.

  Remarque : dans l'expression précédente, si Entrée = 123, l'expression renvoie 1. Pour obtenir des décimales, ajoutez des décimales aux valeurs dans l'expression. Par exemple : %Entrée%/100,00 renverra 1,23. L'illustration ci-dessous présente un autre exemple d'utilisation des variables dans l'expression.

  

  Attention :

  Une variable en ligne de type chaîne doit être entourée de guillemets ("%variable chaîne%") dans une expression. Les variables en ligne numériques (double, long) n'ont pas besoin de guillemets (%double%).

• Les expressions peuvent uniquement être créées dans un format Python standard. Les autres langages de script ne sont pas pris en charge.

• L'outil Calculer une valeur peut résoudre des expressions mathématiques simples. Par exemple :

  • 3+5
  • 9*8
  • 4+(9/3)

• L'outil Calculer une valeur permet d'utiliser le module mathématique Python pour effectuer des opérations mathématiques plus complexes. Pour accéder au module mathématique, faites précéder la fonction souhaitée de math. Par exemple :

  • math.sqrt(25)
  • math.cos(0.5)

• Les constantes sont également prises en charge dans tout le module mathématique. Par exemple :

  • math.pi

• Le module random est pris en charge pour la génération de nombres aléatoires. Vous trouverez ci-dessous quelques exemples d'utilisation du module random :

  • Calculez un entier aléatoire compris entre 0 et 10 : random.randint(0, 10)
  • Calculez une valeur aléatoire dérivée d'une distribution normale avec une moyenne de 10 et un écart type de 3 : random.normalvariate(10, 3)

  Héritage :

  arcgis.rand() n’est plus pris en charge dans la version ArcGIS Pro 2.0. Des fonctions comparables à l'aide du random module Python doivent être utilisées en lieu et place. Pour utiliser le random module avec succès, importez-le dans le paramètre Bloc de code.

• En règle générale, les expressions sont entrées dans le paramètre Expression. Les expressions plus complexes, telles que les calculs d'expressions multilignes ou les opérations logiques (if, then), impliquent l'utilisation du paramètre Bloc de code. Le paramètre Bloc de code ne peut pas être utilisé seul. Il doit être utilisé avec le paramètre Expression.

• Les variables définies dans le paramètre Bloc de code peuvent être référencées à partir de l'expression.

  

• Les fonctions peuvent être définies dans le paramètre Bloc de code et appelées à partir de l'expression. Dans l'exemple ci-dessous, la fonction renvoie une chaîne de direction du vent en fonction d'une valeur en entrée aléatoire. Dans Python, les fonctions sont définies à l'aide du mot-clé def, suivi du nom de la fonction et des paramètres en entrée de la fonction. Dans notre exemple, la fonction est getWind et le paramètre associé est wind. Les valeurs sont renvoyées à partir d'une fonction à l'aide du mot-clé return.

  

• Vous pouvez transmettre une variable via le paramètre Expression et utiliser la logique if-else avec des variables en ligne dans le bloc de code, comme illustré ci-dessous. Le bloc de code regarde si la variable InputCellSize est vide, puis renvoie une valeur qui repose sur la condition.

  

• Vous pouvez utiliser les méthodes Python directement dans le paramètre Expression de l'outil. Par exemple, si vous souhaitez utiliser une valeur en entrée dotée d'une virgule (valeur de champ de la table en entrée dans ce cas) dans le nom en sortie d'un autre outil via la substitution de variables en ligne, la virgule peut être remplacée avec la méthode Python replace dans l'expression de l'outil Calculer une valeur.

  

• Les modules Python peuvent être appelés et les méthodes, telles que "replace", peuvent être combinées ou empilées dans le paramètre Bloc de code. Dans l'exemple ci-dessous, le module time est importé dans le bloc de code qui renvoie la date et l'heure actuelles, par exemple Ven Mar 19 2010 09:42:39. Cette valeur renvoyée est utilisée comme nom dans l'outil Créer un dossier afin de nommer le dossier. Comme le nom du dossier ne peut pas comporter d'espaces ou de symboles de ponctuation, la méthode replace dans Python est utilisée en empilant la méthode pour chaque élément devant être remplacé. Le nom de dossier ainsi obtenu dans cet exemple est VenMar192010094239.

  

• Si vous calculez une valeur dans le modèle et souhaitez utiliser la valeur calculée avec des outils, tels que Zone tampon, qui nécessite une valeur de distance de la zone tampon ainsi qu'une unité linéaire, vous devez :

  • renvoyer l'unité linéaire du bloc de code avec la valeur de distance ;
  • modifier le type de données des valeurs renvoyées, comme indiqué ci-dessous ;
  • définir le paramètre Type de données sur Unité linéaire afin que le résultat de l'expression soit converti en valeur d'unité linéaire.

  

• Vous pouvez utiliser la sortie de l’outil Calculer une valeur directement dans tous les outils Spatial Analyst qui acceptent un raster ou une valeur constante, notamment Plus, Supérieur à et Inférieur à (ces outils se trouvent dans la boîte d’outils Spatial Analyst/le jeu d’outils Mathématiques). Pour utiliser la sortie de l'outil Calculer une valeur, modifiez le type de données en sortie en Raster (formule). Ce format de type de données en sortie est une surface raster dont les valeurs de cellule sont représentées par une formule ou une constante.

  

• Dans Python, une partie de la syntaxe est une indentation appropriée. Le niveau d'indentation (deux ou quatre espaces) importe peu tant qu'il est homogène dans tout le bloc de code.

• Vous ne pouvez pas accéder aux variables de modèle dans le bloc de code. Ces variables doit être transmises au bloc de code à partir de l'expression. Pour ce faire, créez une définition dans le paramètre Bloc de code et référencez la définition dans la zone Expression.

Remarque :

Lorsque vous écrivez des scripts Python, utilisez les instructions Python standard au lieu de l'outil Calculer une valeur.

Syntaxe

arcpy.mb.CalculateValue(expression, {code_block}, {data_type})

Paramètre	Explication	Type de données
expression	Expression Python à résoudre.	SQL Expression
code_block (Facultatif)	Bloc de code Python. Le code du bloc peut être référencé dans le paramètre Expression.	String
data_type (Facultatif)	Spécifie le type de données de la sortie renvoyée à partir de l’expression Python. Ce paramètre doit être utilisé dans ModelBuilder pour faciliter l'enchaînement de l'outil Calculer une valeur avec d'autres outils. Address Locator —Localisateur d’adresses Address Locator Style —Style de localisateur d'adresses Analysis Cell Size —Taille de cellule d'analyse Annotation Layer —Couche d’annotations Any Value —Toute valeur ArcMap Document —Document ArcMap Areal Unit —Unité surfacique BIM File Workspace —Espace de travail de fichier BIM Boolean —Booléen Building Discipline Layer —Création de la couche de discipline Building Discipline Scene Layer —Création de la couche de scène de discipline Building Layer —Création de la couche Building Scene Layer —Création de la couche de scène CAD Drawing Dataset —Jeu de données de dessin DAO Calculator Expression —Expression de la calculatrice Catalog Root —Racine du catalogue Cell Size —Taille de cellule Cell Size XY —Taille de cellule XY Composite Layer —Couche composite Compression —Compression Coordinate System —Système de coordonnées Coordinate Systems Folder —Dossier des systèmes de coordonnées Coverage —Couverture Coverage Feature Class —Classe d'entités de couverture Data Element —Elément de données Data File —Fichier de données Database Connections —Connexions aux bases de données Dataset —Jeu de données Date —Date dBASE Table —Table dBASE Decimate —Eliminer Diagram Layer —Couche de diagramme Dimension Layer —Couche de dimensions Disk Connection —Connexion de disque Double —Double Elevation Surface Layer —Couche de surface d’altitude Encrypted String —Chaîne chiffrée Envelope —Enveloppe Evaluation Scale —Echelle d'évaluation Extent —Etendue Extract Values —Extraire des valeurs Feature Class —Classe d'entités Feature Dataset —Jeu de classes d’entités Feature Layer —Couche d’entités Feature Set —Jeu d’entités Field —Terrain Field Info —Informations de champ Field Mappings —Appariements de champs File —Fichier Folder —Dossier Formulated Raster —Raster (formule) Fuzzy function —Fonction de recherche approximative GeoDataServer —Serveur de géodonnées Geodataset —Jeu de données géographiques Geometric Network —Réseau géométrique Geostatistical Layer —Couche géostatistique Geostatistical Search Neighborhood —Voisinage de recherche géostatistique Geostatistical Value Table —Table de valeurs géostatistiques GlobeServer —Serveur de globe GPServer —Serveur de géotraitement Graph —Diagramme Graph Data Table —Table de données de diagramme Group Layer —Groupe de couches Horizontal Factor —Facteur horizontal Image Service —Service d’imagerie Index —ajusté pour les sols INFO Expression —Expression INFO INFO Item —Elément INFO INFO Table —Table INFO Internet Tiled Layer —Couche Internet tuilée KML Layer —Couche KML LAS Dataset —Jeu de données LAS LAS Dataset Layer —Couche du jeu de données LAS Layer —Couche Layer File —Fichier de couches Layout —Mise en page Line —Ligne Linear Unit —Unité linéaire Long —Long M Domain —Domaine M Map —Carte, Map Server Layer —Couche du serveur de carte MapServer —MapServer Mosaic Dataset —Jeu de données mosaïque Mosaic Layer —Couche de mosaïque Neighborhood —Quartier Network Analyst Class FieldMap —Appariement des champs de classe Network Analyst Network Analyst Hierarchy Settings —Paramètres de hiérarchie Network Analyst Network Analyst Layer —Couche Network Analyst Network Data Source —Source de données réseau Network Dataset —Jeu de données réseau Network Dataset Layer —Couche du jeu de données réseau Network Travel Mode —Mode de déplacement réseau Parcel Fabric —Atelier parcellaire Parcel Fabric for ArcMap —Atelier parcellaire pour ArcMap Parcel Fabric Layer for ArcMap —Couche d'atelier parcellaire pour ArcMap Parcel Layer —Couche de parcelle Point —Point Polygon —Surface Projection File —Fichier de projection Pyramid —Pyramide Radius —Rayon Random Number Generator —Générateur de nombres aléatoires Raster Band —Bande raster Raster Calculator Expression —Expression de la calculatrice raster Raster Catalog —Catalogue d’images Raster Catalog Layer —Couche du catalogue d'images Raster Data Layer —Couche de données raster Raster Dataset —Jeu de données raster Raster Layer —Couche raster Raster Statistics —Statistiques raster Raster Type —Type de raster Record Set —Jeu d'enregistrements Relationship Class —Classe de relations Remap —Classification Report —Rapport Route Measure Event Properties —Propriétés des événements de mesures d'itinéraires Scene Layer —Couche de scène Semivariogram —Semi-variogramme ServerConnection —ServerConnection Shapefile —Shapefile Spatial Reference —Référence spatiale SQL Expression —Expression SQL String —Chaîne String Hidden —Chaîne masquée Table —Tableau Table View —Vue tabulaire Terrain Layer —Couche de MNT Text File —Fichier texte Tile Size —Taille de tuile Time configuration —Configuration de temps Time Unit —Unités de temps TIN —TIN TIN Layer —Couche du TIN Tool —Outil Toolbox —Boîte d’outils Topo Features —Entités topologiques Topology —Topologie Topology Layer —Couche topologique Trace Network —Réseau de traces Trace Network Layer —Couche de réseau de traces Transformation function —Fonction de transformation Utility Network —Utility Network Utility Network Layer —Couche de réseau de distribution Variant —Variante Vector Tile Layer —Couche de tuiles vectorielles Vertical Factor —Facteur vertical Voxel Layer —Couche de voxel VPF Coverage —Couverture VPF VPF Table —Tableau VPF WCS Coverage —Couverture WCS Weighted Overlay Table —Table de superposition pondérée Weighted Sum —Somme pondérée WMS Map —Carte WMS Workspace —Espace de travail XY Domain —Domaine XY Z Domain —Domaine Z	String

Sortie dérivée

Nom	Explication	Type de données
value	Valeur calculée.	Élément de données ; couche ; vue tabulaire

Environnements

Cet outil n'utilise pas d’environnement de géotraitement.

Informations de licence

• Basic: Oui
• Standard: Oui
• Advanced: Oui