Calculatrice raster (Spatial Analyst)
Récapitulatif
Crée et exécute une expression d'algèbre spatiale unique fondée sur la syntaxe Python dans une interface de type calculateur.
En savoir plus sur le fonctionnement de l'outil Calculatrice raster
Illustration
 |
Exemple de boîte de dialogue de l'outil Calculatrice raster |
Utilisation
L'outil Calculatrice raster permet de créer et d'exécuter une expression d'algèbre spatiale qui génère un raster en sortie.
Utilisez la liste Couches et variables pour sélectionner les jeux de données et les variables à utiliser dans l'expression. Des valeurs numériques et des opérateurs mathématiques peuvent être ajoutés à l'expression en cliquant sur les boutons correspondant dans la boîte de dialogue de l'outil. Une liste d'outils conditionnels et mathématiques courants est fournie, qu'il est facile d'ajouter à l'expression.
Des chemins complets aux données ou des données existant dans les paramètres de l'environnement de l'espace de travail courant spécifié peuvent être saisies entre guillemets (""). Des nombres et des scalaires peuvent être introduits directement dans une expression.
La boîte de dialogue de l'outil Calculatrice raster contient les outils suivants :
Nombre d'outils de géotraitement et d'opérations peuvent être associés dans une expression d'algèbre spatial à l'aide de la syntaxe Python standard.
Attention :Lorsque vous saisissez des noms d'outils, veillez à vérifier la syntaxe du nom de l'outil. Si la casse est incorrecte, l'expression ne sera pas valide et ne pourra pas s'exécuter, car Python est sensible à la casse.
Exemple de format général d'une expression d'algèbre spatial utilisant des outils de géotraitement :
Con(IsNull("streams"), 0, "streams")
L'outil prend en charge la syntaxe d'algèbre spatiale standard utilisée dans les scripts Python. Les seules différences sont les suivantes :
- vous n'avez pas besoin d’indiquer le nom du raster en sortie ou le signe = dans l'expression, puisque le nom en sortie est spécifié dans le paramètre Raster en sortie,
- il est inutile de convertir des données en objet raster lorsque vous utilisez des opérateurs.
Vous pouvez facilement découper un jeu de données raster en définissant l'environnement de l'étendue et en spécifiant le nom du raster en entrée dans l'expression. Lorsque l'outil est exécuté, le raster en sortie est découpé selon l'étendue spécifiée.
Pour créer un raster avec des cellules de valeur constante, spécifiez l'étendue appropriée et les paramètres d'environnement de taille de cellule et entrez la valeur numérique dans l'expression.
Lorsque plusieurs opérateurs sont utilisés dans une expression, ils ne sont pas nécessairement exécutés de gauche à droite. L'opérateur doté de la valeur de précédence la plus élevée est exécuté en premier. Pour plus d'informations sur la précédence des opérateurs, consultez la rubrique Table de précédence des opérateurs. Vous pouvez utiliser des parenthèses pour contrôler l'ordre d'exécution.
Les opérateurs booléens (~, &, ^, |) ont un niveau de précédence supérieur à celui des opérateurs relationnels (<, <=, >, >=, ==, !=). Par conséquent, lorsque des opérateurs booléens sont utilisés dans la même expression que des opérateurs relationnels, les opérateurs booléens sont exécutés en premier. Pour modifier l'ordre d'exécution, utilisez des parenthèses.
Lorsque plusieurs opérateurs relationnels et/ou booléens sont utilisés consécutivement dans une expression individuelle, dans certains cas, elle peut ne pas s'exécuter. Pour éviter ce problème éventuel, utilisez des parenthèses appropriées dans l'expression afin de définir explicitement l'ordre d'exécution des opérateurs. Pour plus d'informations, reportez-vous à la rubrique Règles des instructions complexes.
La performance d'une opération peut être améliorée par les fonctionnalités d'évaluation différée de l'algèbre spatiale. L'évaluation différée est une technique d'optimisation où les composants individuels d'une expression sont traités intelligemment, afin de réduire le nombre de jeux de données intermédiaires créés sur le disque.
Seuls les opérateurs et les outils qui se fondent sur une méthode d'exécution par cellule prennent en charge cette fonctionnalité. Les opérateurs et outils qui prennent en charge l'évaluation différée sont inclus dans l'outil Calculatrice raster sous forme de boutons ou dans la liste des outils fournis.
L'outil Calculatrice raster peut être utilisé dans ModelBuilder, mais gardez à l'esprit les points suivants :
- La syntaxe de l'expression détermine comment les variables doivent être spécifiées. Si vous sélectionnez une variable dans la liste des variables, elle est ajoutée automatiquement à l'expression, à l'emplacement courant du curseur. Au moment de la validation du modèle :
- Les noms de couche sont mis entre guillemets (" ").
Exemple : "inlayer"
- Les variables de type Long, doubles ou booléennes sont mises entre des symboles de pourcentage (%%). Elles n'ont pas besoin d'être entre guillemets.
Exemple : % scale_factor%
- Les variables qui représentent des noms du jeu de données ou des chaînes doivent être mises entre guillemets et symboles de pourcentage ("%%").
Par exemple, inraster, s'il est sélectionné dans la liste des variables, deviendra "%inraster%" dans l'expression.
- Les noms de couche sont mis entre guillemets (" ").
- Dans ModelBuilder, les types de variable suivants constituent des entrées valides pour une expression :
- chaîne,
- booléen,
- numérique (Double et Long),
- données (jeu de données raster, couche raster, canal raster, fichier de couches .lyr).
- L'outil Calculatrice raster adopte généralement le comportement de connectivité standard des modèles dans ModelBuilder, à quelques exceptions près, qui résultent de la nécessité de formuler une expression d'algèbre spatiale valide. Il s'agit notamment des interrogations suivantes :
- Les variables sont connectées à l'outil Calculatrice raster lorsqu'elles sont sélectionnées dans la liste des variables. Toutes les variables sont répertoriées automatiquement dans la liste Variable, à l'intérieur de l'outil.
- Lorsqu'un jeu de données ou une variable est utilisée dans une expression, un lien entre la variable et l'outil est créé. Si vous supprimez la variable de l'expression, le lien associé entre la variable et l'outil est également supprimé.
- Si vous supprimez la connexion à une variable, la variable n'est pas supprimée de l'expression.
- Vous ne devez pas renommer une variable connectée à l'outil, car la variable ne sera pas renommée dans l'expression. Si vous renommez une variable connectée à l'outil, l'expression n'est plus valide.
- La syntaxe de l'expression détermine comment les variables doivent être spécifiées. Si vous sélectionnez une variable dans la liste des variables, elle est ajoutée automatiquement à l'expression, à l'emplacement courant du curseur. Au moment de la validation du modèle :
Remarque :L'outil Calculatrice raster est uniquement destiné à l'application ArcGIS Desktop et peut être utilisé dans une boîte de dialogue d'outil de géotraitement ou dans ModelBuilder, par exemple. Il n'est pas conçu pour être utiliser dans les scripts et n'est pas disponible dans le module ArcPy Spatial Analyst.
Syntaxe
| Paramètre | Explication | Type de données |
expression | Remarque : Dans Python, les expressions d'algèbre spatial doivent être créées et exécutées à l'aide du module Spatial Analyst, qui est une extension du site-package Python d'ArcPy. Voir Algèbre spatial dans Spatial Analyst pour en savoir plus sur la façon d'effectuer votre analyse dans Python. | String |
output_raster | Remarque : Voir Création d'une sortie d'algèbre spatial pour plus d'informations sur la génération d'une sortie à partir d'expressions d'algèbre spatial dans Python. | Raster Dataset |