Créer un raster constant (ArcGIS Spatial Analyst)

Disponible avec une licence Spatial Analyst.

Synthèse

Crée un raster d'une valeur constante dans l'étendue et la taille de cellule de la fenêtre d'analyse.

Illustration

OutRas = CreateConstantRaster(2)

Utilisation

• L’outil Créer un raster constant attribue la valeur spécifiée à chaque cellule du raster en sortie.

• La valeur constante doit être une valeur numérique. La notation scientifique est admise (par exemple, 3.048e-4 pour 0,003048).

• Le paramètre Output cell size (Taille de cellule en sortie) peut être défini par une valeur numérique ou obtenu à partir d’un jeu de données raster existant. Si la taille de cellule n’a pas été spécifiée de manière explicite comme étant la valeur du paramètre, elle est dérivée de l’environnement Cell Size (Taille de cellule) si celui-ci a été spécifié. Si la taille de cellule du paramètre ou la taille de cellule de l’environnement n’a pas été spécifiée, mais que l’environnement Snap Raster (Raster de capture) a été défini, c’est la taille de cellule du raster de capture qui est utilisée. Si rien n’est spécifié, la taille de cellule prend la valeur 1.

• Si la taille de cellule est spécifiée à l’aide d’une valeur numérique, l’outil l’utilise directement pour le raster en sortie.

  Si la taille de cellule est spécifiée à l’aide d’un jeu de données raster, le paramètre affiche le chemin du jeu de données raster au lieu de la valeur de la taille de cellule. La taille de cellule de ce jeu de données raster sera utilisée directement dans l’analyse, à condition que la référence spatiale du jeu de données soit identique à la référence spatiale en sortie. Si la référence spatiale du jeu de données diffère de la référence spatiale en sortie, elle sera projetée d’après la valeur sélectionnée du champ Méthode de projection de la taille de cellule.

• Puisque l’outil ne nécessite aucune entrée, la référence spatiale en sortie est dérivée des autres paramètres selon un ordre défini. C’est tout d’abord, l’environnement Output Coordinate System (Système de coordonnées en sortie) qui est utilisé, si celui-ci est spécifié, suivi du système de coordonnées de la vue cartographique. Si aucune de ces conditions n’est remplie, la référence spatiale en sortie sera définie sur Inconnue.

• L’étendue en sortie par défaut est calculée d’après la taille de cellule pour créer un raster de 250 lignes et 250 colonnes. Ainsi, pour une taille de cellule par défaut de 1, Output extent (Étendue en sortie) a pour valeurs (0, 0, 250, 250). La valeur d’étendue est ajustée en fonction des environnements Cell Size (Taille de cellule), Snap Raster (Raster de capture), et Output Coordinate System (Système de coordonnées en sortie), si ceux-ci sont spécifiés.

• Pour plus d’informations sur les environnements de géotraitement qui s’appliquent à cet outil, reportez-vous à la rubrique Environnements d’analyse et Spatial Analyst.

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Valeur constante	Valeur constante avec laquelle renseigner toutes les cellules du raster en sortie.	Double
Type de données en sortie (Facultatif)	Type de données du jeu de données raster en sortie. Si le type de données à virgule flottante est spécifié, les valeurs des cellules du raster en sortie ne seront précises qu’à la valeur constante de 7 décimales, quel que soit le format en sortie. Entier—Un raster de type entier est créé. Flottant—Un raster de type flottant est créé.	String
Taille de cellule en sortie (Facultatif)	La taille de cellule du jeu de données raster en sortie sera créée. Ce paramètre peut être défini par une valeur numérique ou obtenu à partir d’un jeu de données raster. Si la taille de cellule n’est pas explicitement spécifiée en tant que valeur de paramètre, la valeur de la taille de cellule de l’environnement sera utilisée dans la mesure où elle est définie. Dans le cas contraire, le calcul fera appel à des règles supplémentaires pour la déterminer à partir d’autres données en entrée. Pour en savoir plus, consultez la section relative à l’utilisation.	Analysis Cell Size
Étendue en sortie (Facultatif)	Etendue du jeu de données raster en sortie. L'étendue est la valeur définie spécifiquement dans l'environnement, le cas échéant. Si elle n'est pas définie spécifiquement, la valeur par défaut est 0, 0, 250, 250.	Envelope; Extent

Valeur renvoyée

Étiquette	Explication	Type de données
Raster en sortie	Raster en sortie pour lequel chaque cellule reçoit la valeur constante spécifiée.	Raster

Python

CreateConstantRaster(constant_value, {data_type}, {cell_size}, {extent})

Nom	Explication	Type de données
constant_value	Valeur constante avec laquelle renseigner toutes les cellules du raster en sortie.	Double
data_type (Facultatif)	Type de données du jeu de données raster en sortie. INTEGER—Un raster de type entier est créé. FLOAT—Un raster de type flottant est créé. Si le type de données à virgule flottante est spécifié, les valeurs des cellules du raster en sortie ne seront précises qu’à la valeur constante de 7 décimales, quel que soit le format en sortie.	String
cell_size (Facultatif)	La taille de cellule du jeu de données raster en sortie sera créée. Ce paramètre peut être défini par une valeur numérique ou obtenu à partir d’un jeu de données raster. Si la taille de cellule n’est pas explicitement spécifiée en tant que valeur de paramètre, la valeur de la taille de cellule de l’environnement sera utilisée dans la mesure où elle est définie. Dans le cas contraire, le calcul fera appel à des règles supplémentaires pour la déterminer à partir d’autres données en entrée. Pour en savoir plus, consultez la section relative à l’utilisation.	Analysis Cell Size
extent (Facultatif)	Etendue du jeu de données raster en sortie. Le Extent est une classe Python. Dans cet outil, l’étendue prend la forme Extent(XMin, YMin, XMax, YMax) où XMin et YMin désignent les coordonnées inférieures gauches de l’étendue, et XMax et YMax ses coordonnées supérieures droites. Les coordonnées sont spécifiées dans les mêmes unités de carte que le paramètre d'environnement Système de coordonnées en sortie. L'étendue est la valeur définie spécifiquement dans l'environnement, le cas échéant. Si elle n'est pas définie spécifiquement, la valeur par défaut est 0, 0, 250, 250.	Envelope; Extent

Valeur renvoyée

Nom	Explication	Type de données
out_raster	Raster en sortie pour lequel chaque cellule reçoit la valeur constante spécifiée.	Raster

Exemple de code

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

Cet exemple crée un raster de type flottant d’une valeur spécifique, à la taille de cellule et à l’étendue définies.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outConstRaster = CreateConstantRaster(12.7, "FLOAT", 2, Extent(0, 0, 250, 250))
outConstRaster.save("C:/sapyexamples/output/outconst2")

Exemple 2 d’utilisation de la fonction CreateConstantRaster (script autonome)

Cet exemple crée un raster de type entier d’une valeur spécifique, à la taille de cellule et à l’étendue définies.

# Name: CreateConstantRaster_Ex_02.py
# Description: Creates a raster from a constant value
# Requirements: Spatial Analyst Extension

# Import system modules
import arcpy
from arcpy.sa import *

# Set local variables
constantValue = 12
cellSize = 2
outExtent = Extent(0, 0, 250, 250)

# Execute CreateConstantRaster
outConstRaster = CreateConstantRaster(constantValue, "FLOAT", cellSize,
                                      outExtent)

# Save the output 
outConstRaster.save("C:/sapyexamples/output/outconst")

Environnements

Validation automatique, Taille de cellule, Méthode de projection de la taille de cellule, Compression, Espace de travail courant, Étendue, Transformations géographiques, Masque, Mot-clé CONFIG en sortie, Système de coordonnées en sortie, Espace de travail temporaire, Raster de capture, Taille de tuile