Zufälliges Raster erstellen (Data Management)

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})
ParameterErklärungDatentyp
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:

  • .tif: TIFF-Raster
  • .img: ERDAS IMAGINE-Raster
  • .crf: CRF-Raster
  • Keine Erweiterung: Esri Grid
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.

  • UNIFORM {Minimum}, {Maximum}: Eine Gleichverteilung mit dem definierten Bereich. Die Standardwerte sind 0,0 für {Minimum} und 1,0 für {Maximum}. Beide Werte sind vom Typ "Double".
  • INTEGER {Minimum}, {Maximum}: Eine ganzzahlige Verteilung mit dem definierten Bereich. Die Standardwerte sind 1 für {Minimum} und 10 für {Maximum}. Beide Werte sind vom Typ "Long".
  • NORMAL {Mean}, {Standard Deviation}: Eine Normalverteilung mit definierten Werten für {Mean} und {Standard Deviation}. Die Standardwerte sind 0,0 für {Mean} und 1,0 für {Standard Deviation}. Beide Werte sind vom Typ "Double".
  • EXPONENTIAL {Mean}: Eine Exponentialverteilung mit einem definierten Wert für {Mean} Der Standardwert ist 1.0. Der Wert ist vom Typ "Double".
  • POISSON {Mean}: Eine Poission-Verteilung mit einem definierten Wert für {Mean}. Der Standardwert ist 1.0. Der Wert ist vom Typ "Double".
  • GAMMA {Alpha}, {Beta}: Eine Gamma-Verteilung mit definierten Werten für {Alpha} und {Beta}. Die Standardwerte sind 1,0 für {Alpha} und 1,0 für {Beta}. Beide Werte sind vom Typ "Double".
  • BINOMIAL {N}, {Probability}: Eine Binomialverteilung mit definierten Werten für {N} und {Probability}. Der Wert {N} ist vom Typ "Long" mit dem Standardwert 10. Der Wert {Probability} ist vom Typ "Double" mit dem Standardwert 0,5.
  • GEOMETRIC {Probability}: Eine geometrische Verteilung mit einem definierten Wert für {Probability}. Der Standardwert ist 0,5. Der Wert ist vom Typ "Double".
  • NEGATIVE BINOMIAL {r}, {Probability}: Eine Pascal-Verteilung mit definierten Werten für {r} und {Probability}. Der Wert {r} ist vom Typ "Double" mit dem Standardwert 10,0. Der Wert {Probability} ist vom Typ "Double" mit dem Standardwert 0,5.
String
raster_extent
(optional)

Die Ausdehnung für das Ausgabe-Raster-Dataset.

  • MAXOF: Die maximale Ausdehnung aller Eingaben wird verwendet.
  • MINOF: Die kleinste gemeinsame Fläche aller Eingaben wird verwendet.
  • DISPLAY: Die Ausdehnung entspricht der sichtbaren Anzeige.
  • Layer-Name: Die Ausdehnung des angegebenen Layers wird verwendet.
  • Extent-Objekt: Die Ausdehnung des angegebenen Objekts wird verwendet.
  • Durch Leerzeichen getrennte Koordinatenzeichenfolge: Die Ausdehnung der angegebenen Zeichenfolge wird verwendet. Die Koordinaten werden in der Reihenfolge X-Min, Y-Min, X-Max, Y-Max ausgedrückt.
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.

  • BUILDFür ganzzahlige Ausgabe-Raster wird uneingeschränkt eine Raster-Attributtabelle erstellt. Dies ist die Standardeinstellung.
  • DO_NOT_BUILDFür ganzzahlige Raster wird keine Raster-Attributtabelle erstellt, wenn die Anzahl der eindeutigen Werte größer oder gleich 65535 ist. Wenn die Anzahl der Einzelwerte unter 65535 liegt, wird eine Raster-Attributtabelle erstellt.
Boolean

Abgeleitete Ausgabe

NameErklärungDatentyp
out_raster_dataset

Das Ausgabe-Raster-Dataset.

Raster-Dataset

Codebeispiel

CreateRandomRaster – Beispiel 1 (Python-Fenster)

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)
CreateRandomRaster – Beispiel 2 (eigenständiges Skript)

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)

Lizenzinformationen

  • Basic: Erfordert 3D Analyst oder Spatial Analyst
  • Standard: Erfordert 3D Analyst oder Spatial Analyst
  • Advanced: Ja

Verwandte Themen