Créer un raster aléatoire (Gestion des données)

Disponible avec une licence Advanced.

Résumé

Créez un jeu de données raster de valeurs aléatoires avec une distribution que vous définissez.

Utilisation

• Vous pouvez enregistrer votre sortie en Esri Grid, CRF, IMG, TIFF ou tout autre jeu de données raster de géodatabase.

• Les valeurs attribuées à chaque cellule du raster en sortie proviennent du générateur de nombres aléatoires et du type de répartition sélectionné. Plusieurs générateurs de nombres aléatoires sont disponibles, et celui que vous souhaitez utiliser est identifié dans le paramètre d'environnement, dans Nombres aléatoires. Le générateur de nombres aléatoires démarre un flux de nombres aléatoires selon le type de générateur et la valeur de configuration. Ces nombres sont déterminés aléatoirement et les valeurs sont comprises entre 0 et 1. Chaque valeur est indépendante des autres valeurs.

  Plusieurs types de répartitions sont disponibles pour les générateurs de nombres aléatoires lors de l'attribution (ou de la transformation) des valeurs du raster en sortie. Les répartitions produisent généralement des résultats différents, et la répartition à sélectionner est déterminée par l'utilisation finale du raster. Si le raster aléatoire est utilisé pour modéliser certains phénomènes naturels, la répartition sélectionnée doit afficher la meilleure représentation du processus du phénomène.

  Consultez la rubrique Répartitions pour l'attribution de valeurs aléatoires pour une description des répartitions et de la manière dont elles sont généralement utilisées.

• Les temps de traitement des répartitions Uniforme, Entier, Normal et Exponentiel sont indépendants de leurs arguments, alors que les temps de traitement des répartitions Poisson, Gamma, Binomiale, Géométrique et Pascal peuvent varier considérablement selon les arguments.

• Une valeur par défaut est calculée pour le paramètre de taille de cellule si aucune valeur n'est fournie. Cette valeur est basée sur la taille de l'étendue.

• Dans la boîte de dialogue de l'outil, les valeurs présentées dans le paramètre Output extent (Étendue en sortie) utilisent le système de coordonnées de la carte. Lors de l’exécution de l’outil, l’étendue est projetée dans le système de coordonnées en sortie, si ce dernier est spécifié dans les paramètres d'environnement.

Syntaxe

CreateRandomRaster(out_path, out_name, {distribution}, {raster_extent}, {cellsize})

Paramètre	Explication	Type de données
out_path	Sélectionnez un dossier ou une géodatabase où stocker le jeu de données raster.	Workspace
out_name	Spécifiez un nom et, si nécessaire, une extension pour le jeu de données raster en sortie. Pour enregistrer un jeu de données raster dans une géodatabase, n'ajoutez pas d'extension de fichier au nom du jeu de données raster. Pour stocker la sortie en tant que raster Grid Esri ou jeu de données raster dans une géodatabase, vous ne devez ajouter aucune extension de fichier au nom du jeu de données raster. Pour stocker le jeu de données raster dans l’un des formats raster de fichier disponibles, spécifiez une extension tif pour générer un raster TIFF ou une extension .img pour un raster ERDAS IMAGINE. Lorsque vous stockez votre jeu de données raster dans un fichier TIFF ou un raster de géodatabase, vous pouvez spécifier un type de compression et une qualité de compression.	String
distribution (Facultatif)	Indiquez la méthode de distribution de valeurs aléatoires à utiliser. UNIFORM {Minimum}, {Maximum} : distribution uniforme avec la plage définie. Les valeurs par défaut sont 0,0 pour {Minimum} et 1,0 pour {Maximum}. Les deux valeurs sont de type double. INTEGER {Minimum}, {Maximum} : distribution d'entiers avec la plage définie. Les valeurs par défaut sont 1 pour {Minimum} et 10 pour {Maximum}. Les deux valeurs sont de type long. NORMAL {Mean}, {Standard Deviation} - Répartition normale avec définition de {Mean} et de {Standard Deviation}. Les valeurs par défaut sont 0,0 pour {Mean} et 1,0 pour {Standard Deviation}. Les deux valeurs sont de type double. EXPONENTIAL {Mean} - Répartition exponentielle avec définition de {Mean}. La valeur par défaut est 1,0. La valeur est de type double. POISSON {Mean} — Répartition Poisson avec définition de {Mean}. La valeur par défaut est 1,0. La valeur est de type double. GAMMA {Alpha}, {Beta} - Répartition gamma avec définition de {Alpha} et de {Beta}. Les valeurs par défaut sont 1,0 pour {Alpha} et 1,0 pour {Beta}. Les deux valeurs sont de type double. BINOMIAL {N}, {Probability} - Répartition binomiale avec définition de {N} et de {Probability}. {N} est de type long avec une valeur par défaut de 10. {Probabilité} est de type double avec une valeur par défaut de 0,5. GEOMETRIC {Probability} — Répartition géométrique avec définition de {Probability}. La valeur par défaut est 0,5. La valeur est de type double. NEGATIVE BINOMIAL {r}, {Probabilité} - Répartition Pascal avec définition des valeurs {r} et {Probabilité}. {r} est de type double avec une valeur par défaut de 10,0. {Probabilité} est de type double avec une valeur par défaut de 0,5.	String
raster_extent (Facultatif)	Définissez l'étendue du jeu de données raster en sortie.	Extent
cellsize (Facultatif)	Définissez la résolution spatiale du jeu de données raster en sortie.	Double

Sortie dérivée

Nom	Explication	Type de données
out_raster_dataset	Jeu de données raster en sortie.	Jeu de données 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 avec une distribution normale, conformément à l'étendue et à la taille de cellule définies.

import arcpy
arcpy.CreateRandomRaster_management("c:/output", "randrast", 
                                    "NORMAL 3.0", "0 0 500 500", 50)

Exemple 2 d'utilisation de l'outil CreateRandomRaster (script autonome)

Cet exemple indique comment créer un raster en sortie de valeurs aléatoires avec une distribution Poisson, conformément à l'étendue et à la taille de cellule définies.

# Name: CreateRandomRaster_Ex_02.py
# Description: Creates a random raster dataset based on a 
#              user-specified distribution and extent.
# Requirements: None

# Import system modules
import arcpy

# Set local variables
outPath = "c:/output"
outFile = "randrast02"
distribution = "POISSON 6.4"
outExtent = "250 250 750 750"
cellSize = 25

# Execute CreateRandomRaster
arcpy.CreateRandomRaster_management(outPath, outFile, distribution, 
                                    outExtent, cellSize)

Environnements

Etendue, Système de coordonnées en sortie, Pyramide

Informations de licence

• Basic: Requiert 3D Analyst ou Spatial Analyst
• Standard: Requiert 3D Analyst ou Spatial Analyst
• Advanced: Oui