Zufälliges Raster erstellen (Spatial Analyst)

Mit der Spatial Analyst-Lizenz verfügbar.

Zusammenfassung

Erstellt innerhalb der Ausdehnung und Zellengröße des Analysefensters ein Raster mit zufälligen Gleitkommawerten zwischen 0,0 und 1,0.

Das Werkzeug Zufälliges Raster erstellen in der Toolbox "Data Management" bietet eine verbesserte Funktionalität bzw. Performance.

Abbildung

Abbildung von "Zufälliges Raster erstellen"
OutRas = CreateRandomRaster()
Hinweis: Diese Ausgabe ist repräsentativ. Die tatsächlichen Werte sind bei jeder Ausführung des Werkzeugs unterschiedlich.

Verwendung

  • Das Werkzeug Zufälliges Raster erstellen generiert Werte für jede Zelle im Ausgabe-Raster.

  • Das Ausgabe-Raster dieses Werkzeugs ist immer ein Gleitkomma-Raster.

  • Die Zellenwerte haben eine Genauigkeit von bis zu 7 Dezimalstellen nach dem Dezimaltrennzeichen.

  • Durch eine wiederholte Anwendung identischer Start- oder Standardwerte werden keine identischen Raster erstellt.

  • Sie können den Startwert mit einem Parameter ändern, um sicherzustellen, dass für den Zufallszahlengenerator unterschiedliche Startpunkte verwendet werden.

  • Zum Generieren der Werte wird für den Zufallszahlengenerator der ACM-Algorithmus 599 verwendet.

  • Der Parameter Ausgabezellengröße kann über einen numerischen Wert definiert oder aus einem vorhandenen Raster-Dataset abgerufen werden. Wird die Zellengröße nicht explizit über den Parameterwert angegeben, wird sie aus der Umgebung Zellengröße abgeleitet, falls diese angegeben wurde. Wenn der Parameter und die Umgebung für die Zellengröße nicht angegeben wurden, aber die Umgebung Fang-Raster festgelegt wurde, wird die Zellengröße des Fang-Rasters verwendet. Falls keine Angaben gemacht werden, entspricht die Zellengröße dem Wert 1.

  • Wenn die Zellengröße mit einem numerischen Wert angegeben ist, wird dieser direkt für das Ausgabe-Raster verwendet.

    Wenn die Zellengröße mit einem Raster-Dataset angegeben ist, wird für den Parameter anstelle des Wertes für die Zellengröße der Pfad des Raster-Datasets angezeigt. Die Zellengröße dieses Raster-Datasets wird direkt in der Analyse verwendet, sofern der Raumbezug des Datasets mit dem des Ausgabe-Raumbezugs übereinstimmt. Wenn der Raumbezug des Datasets nicht mit dem Ausgabe-Raumbezug übereinstimmt, wird er basierend auf dem für Projektionsmethode für Zellengröße angegebenen Wert projiziert.

  • Da dem Werkzeug keine Eingabe zur Verfügung steht, wird der Ausgabe-Raumbezug aus anderen Einstellungen abgeleitet. Dabei wird eine bestimmte Reihenfolge beachtet: Falls angegeben wird zunächst die Umgebung Ausgabe-Koordinatensystem verwendet. Anschließend wird das Koordinatensystem der Kartenansicht herangezogen. Wird keine dieser Bedingungen erfüllt, wird für den Ausgabe-Raumbezug "Unbekannt" festgelegt.

  • Auf Grundlage der Zellengröße wird die standardmäßige Ausgabeausdehnung berechnet, um ein Raster mit 250 Zeilen und 250 Spalten zu erstellen. Für die Standard-Zellengröße von 1 beträgt die Ausgabeausdehnung somit (0, 0, 250, 250). Der Ausdehnungswert wird basierend auf den Umgebungen Zellengröße, Fang-Raster und Ausgabekoordinatensystem angepasst, falls diese angegeben sind.

  • Die Toolbox "Data Management" enthält das Werkzeug Zufälliges Raster erstellen, das einige weitere Optionen für die Verteilung der Werte bereitstellt.

  • Weitere Informationen zu den Geoverarbeitungsumgebungen für dieses Werkzeug finden Sie unter Analyseumgebungen und Spatial Analyst.

Parameter

BeschriftungErläuterungDatentyp
Startwert
(optional)

Ein Wert, der zum erneuten Festlegen des Startwertes für den Zufallszahlengenerator verwendet werden soll.

Dies kann eine Ganz- oder eine Gleitkommazahl sein. Raster sind keine gültige Eingabe.

Der Zufallszahlengenerator erhält automatisch den aktuellen Wert der Systemuhr (Sekunden seit dem 1. Januar 1970) als Startwert. Der Bereich zulässiger Werte für den Startwert reicht von -231 +1 bis 231 (oder -2.147.483.647 bis 2.147.483.648).

Double
Ausgabe-Zellengröße
(optional)

Die Zellengröße des zu erstellenden Ausgabe-Rasters.

Dieser Parameter kann über einen numerischen Wert definiert oder aus einem vorhandenen Raster-Dataset abgerufen werden. Wenn die Zellengröße nicht explizit über den Parameterwert angegeben wurde, wird der Wert für die Zellengröße aus der Umgebung verwendet, sofern diese angegeben wurde. Andernfalls wird die Zellengröße mithilfe zusätzlicher Regeln aus den anderen Eingaben berechnet. Weitere Details finden Sie im Abschnitt mit den Verwendungshinweisen.

Analysis Cell Size
Ausgabeausdehnung
(optional)

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

Für die Ausdehnung wird der Wert in der Umgebung verwendet, wenn dieser explizit festgelegt wurde. Wurde er nicht explizit angegeben, wird die Standardeinstellung 0m 0, 250, 250 verwendet.

Envelope; Extent

Rückgabewert

BeschriftungErläuterungDatentyp
Ausgabe-Raster

Das Ausgabe-Raster von zufällig verteilten Werten mit einem Bereich von 0,0 bis 1,0.

Raster

CreateRandomRaster({seed_value}, {cell_size}, {extent})
NameErläuterungDatentyp
seed_value
(optional)

Ein Wert, der zum erneuten Festlegen des Startwertes für den Zufallszahlengenerator verwendet werden soll.

Dies kann eine Ganz- oder eine Gleitkommazahl sein. Raster sind keine gültige Eingabe.

Der Zufallszahlengenerator erhält automatisch den aktuellen Wert der Systemuhr (Sekunden seit dem 1. Januar 1970) als Startwert. Der Bereich zulässiger Werte für den Startwert reicht von -231 +1 bis 231 (oder -2.147.483.647 bis 2.147.483.648).

Double
cell_size
(optional)

Die Zellengröße des zu erstellenden Ausgabe-Rasters.

Dieser Parameter kann über einen numerischen Wert definiert oder aus einem vorhandenen Raster-Dataset abgerufen werden. Wenn die Zellengröße nicht explizit über den Parameterwert angegeben wurde, wird der Wert für die Zellengröße aus der Umgebung verwendet, sofern diese angegeben wurde. Andernfalls wird die Zellengröße mithilfe zusätzlicher Regeln aus den anderen Eingaben berechnet. Weitere Details finden Sie im Abschnitt mit den Verwendungshinweisen.

Analysis Cell Size
extent
(optional)

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

Extent ist eine Python-Klasse.

In diesem Werkzeug wird sie in folgendem Format angegeben: Extent(XMin, YMin, XMax, YMax).

  • Dabei definieren XMin und YMin die linke untere Koordinate der Ausdehnung und XMax und YMax die rechte obere Koordinate.

Die Koordinaten werden in denselben Karteneinheiten wie die Umgebungseinstellung Ausgabe-Koordinatensystem angegeben.

Für die Ausdehnung wird der Wert in der Umgebung verwendet, wenn dieser explizit festgelegt wurde. Wurde er nicht explizit angegeben, wird die Standardeinstellung 0m 0, 250, 250 verwendet.

Envelope; Extent

Rückgabewert

NameErläuterungDatentyp
out_raster

Das Ausgabe-Raster von zufällig verteilten Werten mit einem Bereich von 0,0 bis 1,0.

Raster

Codebeispiel

CreateRandomRaster – Beispiel 1 (Python-Fenster)

In diesem Beispiel wird ein Ausgabe-Raster von zufällig verteilten Werten mit der definierten Zellengröße und Ausdehnung erstellt.

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

In diesem Beispiel wird ein Ausgabe-Raster von zufällig verteilten Werten mit der definierten Zellengröße und Ausdehnung erstellt.

# 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)

# Execute CreateRandomRaster
outRandomRaster = CreateRandomRaster(seedValue, cellSize, extent) 

# Save the output 
outRandomRaster.save("C:/sapyexamples/output/outrand")

Verwandte Themen