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

Disponible avec une licence Advanced.

Synthèse

Crée 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. Examinez l’environnement Générateur de nombres aléatoires pour déterminer le générateur à utiliser. 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 à utiliser est déterminée par l’utilisation finale du raster. Si le raster aléatoire est utilisé pour modéliser un phénomène naturel, 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 du 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 (Output Coordinate System), si ce dernier est spécifié dans les paramètres d’environnement.

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Emplacement en sortie	Dossier ou géodatabase où se trouvera le jeu de données raster en sortie.	Workspace
Nom du jeu de données raster avec l'extension	Nom et format du jeu de données raster que vous créez. Pour stocker la sortie en tant que 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 les rasters basés sur des fichiers, utilisez l’extension appropriée pour spécifier le format à créer comme suit : .tif : raster TIFF .img : raster ERDAS IMAGINE .crf : raster CRF Aucune extension – Esri Grid	String
Distribution (Facultatif)	Indique la méthode de distribution de valeurs aléatoires à utiliser. Chaque type comporte un ou deux paramètres pour contrôler la distribution. Uniform (Uniforme) : distribution uniforme avec définition de la plage entre les valeurs Minimum et Maximum. Les valeurs par défaut sont 0,0 pour Minimum et 1,0 pour Maximum. Il s’agit de l’option par défaut. Integer (Entier) : distribution d’entiers avec définition de la plage entre les valeurs Minimum et Maximum. Les valeurs par défaut sont 1 pour Minimum et 10 pour Maximum. Normal : distribution normale avec définition des valeurs Mean (Moyenne) et Standard Deviation (Écart type). Les valeurs par défaut sont 0,0 pour Moyenne et 1,0 pour Ecart type. Exponential (Exponentiel) : distribution exponentielle avec définition de la valeur Mean (Moyenne). La valeur par défaut est 1,0. Poisson : distribution Poisson avec définition de la valeur Mean (Moyenne). La valeur par défaut est 1,0. Gamma : distribution gamma avec définition des valeurs Alpha et Beta (Bêta). Les valeurs par défaut sont 1,0 pour Alpha et 1,0 pour Beta. Binomial : distribution binomiale avec définition des valeurs N et Probability (Probabilité). Les valeurs par défaut sont 10 pour N et 0,5 pour Probabilité. Geometric (Géométrique) : distribution géométrique avec définition d’une valeur Probability (Probabilité). La valeur par défaut est 0,5. Negative Binomial (Binomial négatif) : distribution Pascal avec définition des valeurs r et Probability (Probabilité). Les valeurs par défaut sont 10,0 pour r et 0,5 pour Probabilité. Pour modifier la valeur par défaut, cliquez sur la valeur dans la table et entrez la nouvelle valeur.	String
Etendue en sortie (Facultatif)	Etendue du jeu de données raster en sortie. Current Display Extent (Étendue actuellement affichée)  : l’étendue repose sur la carte ou la scène active. Cette option est uniquement disponible lorsqu’une carte est active. Dessiner l’étendue  : l’étendue est basée sur un rectangle dessiné sur la carte ou dans la scène. Cette option crée une classe d’entités dans la géodatabase du projet et ajoute une couche à la carte. La classe d’entités possède le même système de coordonnées que la carte. Remarque : Cette option n’est pas disponible dans la boîte de dialogue Environnements. Elle est disponible uniquement dans un paramètre de l’outil correspondant à un type de données d’étendue ou dans l’onglet Environnements de la boîte de dialogue de l’outil. Remarque : Lorsque l’option de mise à jour Activer et désactiver la mise à jour de l’onglet Mettre à jour est activée, vous devez activer la mise à jour dans l’onglet du ruban Mettre à jour pour dessiner l’étendue. Extent of a Layer (Étendue d’une couche)  : l’étendue repose sur une couche de carte active. Utilisez la liste déroulante pour choisir une couche disponible ou utilisez l’option Extent of data in all layers (Étendue des données dans toutes les couches) pour obtenir l’étendue combinée de toutes les couches de carte actives, y compris le fond de carte. Cette option est uniquement disponible lorsqu’une carte avec des couches est active. Chaque couche de carte comporte les options suivantes : Toutes les entités  : étendue de toutes les entités dans la couche. Entités sélectionnées : étendue de toutes les entités sélectionnées dans la couche. Entités visibles  : étendue des entités visibles dans la couche. Remarque : Les étendues des options Entités sélectionnées  et Entités visibles  sont disponibles uniquement pour les couches d’entités. Browse (Parcourir)  : l’étendue repose sur un jeu de données existant. Presse-papiers  : l’étendue peut être copiée vers et collée depuis le Presse-papiers. Copier l’étendue  : copie les coordonnées et le système de coordonnées de l’étendue dans le Presse-papiers. Coller l’étendue  : colle les coordonnées et, éventuellement, le système de coordonnées de l’étendue depuis le Presse-papiers. Si les valeurs du Presse-papiers n’incluent pas de système de coordonnées, l’étendue utilise celui de la carte. Remarque : Les coordonnées de l’étendue sont copiées vers et collées depuis le Presse-Papiers avec la même mise en forme et le même ordre que ceux de l’objet ArcPy Extent : X min, Y min, X max, Y max et la référence spatiale. Reset Extent (Réinitialiser l’étendue)  : la valeur par défaut de l’étendue est rétablie. Manually entered coordinates (Coordonnées saisies manuellement) : les coordonnées doivent être des valeurs numériques incluses dans le système de coordonnées de la carte active. Attention : La carte peut utiliser des unités d’affichage différentes de celles des coordonnées saisies. L’utilisation d’une direction cardinale (N, S, E, O) n’est pas prise en charge. Utilisez le signe moins pour les coordonnées sud et ouest.	Extent
Taille de cellule (Facultatif)	Résolution spatiale du jeu de données raster en sortie.	Double
Build raster attribute table (Créer la table attributaire d’un raster) (Facultatif)	Indique si l’outil construira de manière inconditionnelle ou non une table attributaire de raster pour le raster en sortie dans lequel la distribution sélectionnée résulte en un raster en sortie d’entier. Ce paramètre est sans effet si le raster en sortie est à virgule flottante. Activé : une table attributaire de raster sera créée de manière inconditionnelle pour les rasters en sortie d’entier. Il s’agit de l’option par défaut. Désactivé : une table attributaire de raster ne sera pas créée pour les rasters en sortie d’entier si le nombre de valeurs uniques est supérieur ou égal à 65 535. Si le nombre de valeurs uniques est inférieur à 65 535, une table attributaire de raster est créée.	Boolean

Sortie obtenue

Étiquette	Explication	Type de données
Jeu de données raster en sortie	Jeu de données raster en sortie.	Jeu de données raster

Python

arcpy.management.CreateRandomRaster(out_path, out_name, {distribution}, {raster_extent}, {cellsize}, {build_rat})

Nom	Explication	Type de données
out_path	Dossier ou géodatabase où se trouvera le jeu de données raster en sortie.	Workspace
out_name	Nom et format du jeu de données raster que vous créez. Pour stocker la sortie en tant que 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 les rasters basés sur des fichiers, utilisez l’extension appropriée pour spécifier le format à créer comme suit : .tif : raster TIFF .img : raster ERDAS IMAGINE .crf : raster CRF Aucune extension – Esri Grid	String
distribution (Facultatif)	Indique la méthode de distribution de valeurs aléatoires à utiliser. Chaque type comporte un ou deux paramètres pour contrôler la distribution. 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} : distribution normale avec définition de valeurs {Mean} et {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} : distribution exponentielle avec définition d’une valeur {Mean}. La valeur par défaut est 1,0. La valeur est de type double. POISSON {Mean} : distribution de Poisson avec définition d’une valeur {Mean}. La valeur par défaut est 1,0. La valeur est de type double. GAMMA {Alpha}, {Beta} : distribution gamma avec définition de valeurs {Alpha} et {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} : distribution binomiale avec définition de valeurs {N} et {Probability}. La valeur {N} est de type long avec une valeur par défaut de 10. La valeur {Probability} est de type double avec une valeur par défaut de 0,5. GEOMETRIC {Probability} : distribution géométrique avec définition d’une valeur {Probability}. La valeur par défaut est 0,5. La valeur est de type double. NEGATIVE BINOMIAL {r}, {Probability} : distribution de Pascal avec définition de valeurs {r} et {Probability}. La valeur {r} est de type double avec une valeur par défaut de 10,0. La valeur {Probability} est de type double avec une valeur par défaut de 0,5.	String
raster_extent (Facultatif)	Etendue du jeu de données raster en sortie. MAXOF : l’étendue maximale de toutes les entrées est utilisée. MINOF : l’étendue minimale commune à toutes les entrées est utilisée. DISPLAY : l’étendue est égale à l’affichage visible. Nom de la couche : l’étendue de la couche spécifiée est utilisée. Objet Extent : l’étendue de l’objet spécifié est utilisée. Chaîne délimitée par des espaces de coordonnées géographiques : l’étendue de la chaîne spécifiée est utilisée. Les coordonnées sont exprimées dans l’ordre x-min, y-min, x-max, y-max.	Extent
cellsize (Facultatif)	Résolution spatiale du jeu de données raster en sortie.	Double
build_rat (Facultatif)	Indique si l’outil construira de manière inconditionnelle ou non une table attributaire de raster pour le raster en sortie dans lequel la distribution sélectionnée résulte en un raster en sortie d’entier. Ce paramètre est sans effet si le raster en sortie est à virgule flottante. BUILD—Une table attributaire de raster sera créée de manière inconditionnelle pour les rasters en sortie d’entier. Il s’agit de l’option par défaut. DO_NOT_BUILD—Une table attributaire de raster ne sera pas créée pour les rasters en sortie d’entier si le nombre de valeurs uniques est supérieur ou égal à 65 535. Si le nombre de valeurs uniques est inférieur à 65 535, une table attributaire de raster est créée.	Boolean

Sortie obtenue

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

Étendue, Système de coordonnées en sortie, Pyramide

Informations de licence

• Basic: Nécessite 3D Analyst ou Spatial Analyst
• Standard: Nécessite 3D Analyst ou Spatial Analyst
• Advanced: Oui