Mit der Advanced-Lizenz verfügbar.
Zusammenfassung
Erstellt ein Raster-Dataset mit Zufallswerten und einer Verteilung, die Sie definieren.
Verwendung
Sie können die Ausgabe in Esri Grid, CRF, IMG, TIFF oder einem beliebigen Geodatabase-Raster-Dataset speichern.
Die jeder Zelle in den Ausgabe-Rastern zugewiesenen Werte werden aus dem Zufallszahlengenerator und dem ausgewählten Verteilungstyp abgeleitet. Es gibt mehrere Zufallszahlengeneratoren. In der Umgebung Zufallszahlengenerator finden Sie heraus, welchen Sie verwenden sollen. Der Zufallszahlengenerator startet eine Reihe von Zufallszahlen, die auf dem Generatortyp und einem Startwert basiert. Diese Zahlen werden nach dem Zufallsprinzip bestimmt, die Werte liegen zwischen 0 und 1. Jeder Wert ist von den anderen Werten unabhängig.
Mehrere Verteilungstypen stehen für die Zufallszahlengeneratoren beim Zuweisen (oder Transformieren) der Werte im Ausgabe-Raster zur Verfügung. Die Verteilungen führen im Allgemeinen zu unterschiedlichen Ergebnissen und die auszuwählende Verteilung wird durch die endgültige Verwendung des Rasters bestimmt. Wenn das zufällige Raster ein natürliches Phänomen modellieren soll, muss die ausgewählte Verteilung den Prozess des Phänomens bestmöglich beschreiben.
Eine Beschreibung der Verteilungen und ihrer typischen Verwendung finden Sie unter Verteilungen zum Zuweisen von Zufallswerten.
Die Verarbeitungszeiten für die Gleich-, Ganzzahl-, Normal- und Exponentialverteilungen sind von ihren Argumenten unabhängig, während die Verarbeitungszeiten für die Poisson-, Gamma-, Binomial- und Pascal-Verteilung sowie der geometrischen Verteilung bei unterschiedlichen Argumenten erheblich differieren können.
Für den Zellengrößenparameter wird ein Standardwert berechnet, wenn kein Wert angegeben wird. Dieser Wert basiert auf der Größe der Ausdehnung.
Im Werkzeugdialogfeld befinden sich die Werte aus dem Parameter Ausgabeausdehnung im Koordinatensystem der Karte. Während der Werkzeugausführung wird die Ausdehnung auf das Ausgabekoordinatensystem projiziert, wenn es in den Umgebungseinstellungen angegeben ist.
Syntax
arcpy.management.CreateRandomRaster(out_path, out_name, {distribution}, {raster_extent}, {cellsize}, {build_rat})| Parameter | Erklärung | Datentyp |
out_path | Der Ordner oder die Geodatabase, in dem bzw. in der das Ausgabe-Raster-Dataset gespeichert werden soll. | Workspace |
out_name | Der Name und das Format des Raster-Datasets, das Sie erstellen. Wenn Sie die Ausgabe als Raster-Dataset in einer Geodatabase speichern möchten, fügen Sie keine Dateierweiterung zum Namen des Raster-Datasets hinzu. Geben Sie bei dateibasierten Rastern das zu erstellende Format folgendermaßen mit der entsprechenden Erweiterung an:
| String |
distribution (optional) | Legen die Methode zur Verteilung von Zufallswerten fest. Bei jeder Methode können Sie die Verteilung mit einer oder zwei Einstellungen steuern.
| String |
raster_extent (optional) | Die Ausdehnung für das Ausgabe-Raster-Dataset.
| Extent |
cellsize (optional) | Die räumliche Auflösung des Ausgabe-Raster-Datasets. | Double |
build_rat (optional) | Gibt an, ob das Werkzeug uneingeschränkt eine Raster-Attributtabelle für das Ausgabe-Raster erstellt, in dem die ausgewählte Verteilung zu einem ganzzahligen Ausgabe-Raster führt. Dieser Parameter hat keine Auswirkungen, wenn das Ausgabe-Raster das Gleitkommaformat aufweist.
| Boolean |
Abgeleitete Ausgabe
| Name | Erklärung | Datentyp |
| out_raster_dataset | Das Ausgabe-Raster-Dataset. | Raster-Dataset |
Codebeispiel
In diesem Beispiel wird ein Ausgabe-Raster aus Zufallswerten mit Normalverteilung mit der definierten Ausdehnung und Zellengröße erstellt.
import arcpy
arcpy.CreateRandomRaster_management("c:/output", "randrast",
"NORMAL 3.0", "0 0 500 500", 50)In diesem Beispiel wird ein Ausgabe-Raster aus Zufallswerten mit Poisson-Verteilung mit der definierten Ausdehnung und Zellengröße erstellt.
# 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)Umgebungen
Lizenzinformationen
- Basic: Erfordert 3D Analyst oder Spatial Analyst
- Standard: Erfordert 3D Analyst oder Spatial Analyst
- Advanced: Ja