Disponible avec une licence Spatial Analyst.
Résumé
Crée un raster de valeurs aléatoires à virgule flottante comprises entre 0.0 et 1.0, dans l'étendue et la taille de cellule de la fenêtre d'analyse.
Illustration
Utilisation
L'outil Créer un raster aléatoire génère des valeurs pour chaque cellule du raster en sortie.
Le raster en sortie généré par cet outil est toujours à virgule flottante.
Les valeurs de cellule auront jusqu'à 7 chiffres de précision après le séparateur décimal.
L'utilisation répétée de la même valeur germe ou de la valeur par défaut ne produit pas le même raster.
Vous pouvez modifier la valeur germe à l'aide d'un paramètre, pour être certain d'obtenir différents points de démarrage pour le générateur de nombres aléatoires.
Pour générer les valeurs, le générateur de nombres aléatoires de l’algorithme de collecte 599 de l’ACM est utilisé.
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 du champ Cell Size Projection Method (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.
La boîte à outils de gestion des données comporte un outil Créer un raster aléatoire qui offre davantage d'options pour la distribution des valeurs.
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.
Syntaxe
CreateRandomRaster({seed_value}, {cell_size}, {extent})| Paramètre | Explication | Type de données |
seed_value (Facultatif) | Valeur à utiliser comme nouvelle valeur de départ du générateur de nombres aléatoires. Il peut s'agir d'un nombre entier ou à virgule flottante. Les rasters ne sont pas autorisés en tant qu'entrées. Le générateur de nombres aléatoires démarre automatiquement avec la valeur actuelle de l'horloge système (en secondes depuis le 1er janvier 1970). La plage des valeurs autorisées pour la valeur initiale est comprise entre -231+1 et 231 (ou -2 147 483 647 et 2 147 483 648). | Double |
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, reportez-vous à l’utilisation. | Analysis Cell Size |
extent (Facultatif) | Etendue du jeu de données raster en sortie. Extent est une classe Python. Dans cet outil, l'étendue prend la forme Extent(XMin, YMin, XMax, YMax)
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. | Extent |
Valeur renvoyée
| Nom | Explication | Type de données |
| out_raster | Raster en sortie de valeurs distribuées de manière aléatoire avec une plage comprise entre 0.0 et 1.0. | Raster |
Exemple de code
Exemple 1 d'utilisation de l'outil CreateRandomRaster (fenêtre Python)
Cet exemple indique comment créer un raster en sortie de valeurs aléatoires, conformément à la taille de cellule et à l'étendue définies.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outRandRaster = CreateRandomRaster(100, 2, Extent(0, 0, 150, 150))
outRandRaster.save("C:/sapyexamples/output/outrandom")
Exemple 2 d'utilisation de l'outil CreateRandomRaster (script autonome)
Cet exemple indique comment créer un raster en sortie de valeurs aléatoires, conformément à la taille de cellule et à l'étendue définies.
# Name: CreateRandomRaster_Ex_02.py
# Description: Creates a raster of random floating point values
# between 0 and 1
# Requirements: Spatial Analyst Extension
# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *
# Set environment settings
env.workspace = "C:/sapyexamples/data"
# Set local variables
seedValue = 1
cellSize = 2
extent = Extent(0, 0, 150, 150)
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute CreateRandomRaster
outRandomRaster = CreateRandomRaster(seedValue, cellSize, extent)
# Save the output
outRandomRaster.save("C:/sapyexamples/output/outrand")
Environnements
Informations de licence
- Basic: Requiert Spatial Analyst
- Standard: Requiert Spatial Analyst
- Advanced: Requiert Spatial Analyst