Normales Raster erstellen (Spatial Analyst)

Mit der Spatial Analyst-Lizenz verfügbar.

Zusammenfassung

Erstellt innerhalb der Ausdehnung und Zellengröße des Analysefensters ein Raster von Zufallswerten mit einer Normalverteilung (Gaußkurve).

Abbildung

Abbildung: Normales Raster erstellen
OutRas = CreateNormalRaster(1, 0 0 4 4)
Hinweis: Diese Ausgabe ist repräsentativ. Die tatsächlichen Werte sind bei jeder Ausführung des Werkzeugs unterschiedlich.

Verwendung

  • Das Werkzeug Normales 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.

  • Die Ausgabewerte haben einen Mittelwert von 0,0 und eine Standardabweichung von 1,0. Wenn eine andere Standardabweichung gewünscht wird, multiplizieren Sie das Ausgabe-Raster mit diesem Wert. Wenn ein anderer Mittelwert gewünscht wird, fügen Sie dem Raster den betreffenden Wert hinzu. Um beispielsweise ein Raster zu erstellen, bei dem die Werte durch einen Mittelwert von 39 und eine Standardabweichung von 2,5 charakterisiert werden, multiplizieren Sie die Ergebnisse von Normales Raster erstellen mit 2,5, und fügen Sie dann 39 hinzu.

    • In Map Algebra können Sie beispielsweise folgende Aktionen ausführen:

      import arcpy
      from arcpy import env
      from arcpy.sa import *
      env.workspace = "C:/data"
      outNorm = CreateNormalRaster(1, Extent(0, 0, 100, 100)) * 2.5 + 39
      outNorm.save("C:/output/norm2")

  • Der Zufallszahlengenerator erhält automatisch den aktuellen Wert der Systemuhr (Sekunden seit dem 1. Januar 1970) als Startwert. Durch Festlegen eines neuen Startwertes für das Werkzeug Zufälliges Raster erstellen erhält auch Normales Raster erstellen einen neuen Startwert.

  • 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 wird, wird dieser vom Werkzeug direkt für das Ausgabe-Raster verwendet.

    Wenn die Zellengröße mit einem Raster-Dataset angegeben wird, zeigt der Parameter anstelle des Zellengrößenwerts den Pfad des Raster-Datasets an. Die Zellengröße dieses Raster-Datasets wird direkt in der Analyse verwendet, vorausgesetzt der Raumbezug stimmt mit dem Ausgabe-Raumbezug überein. Wenn der Raumbezug des Datasets nicht mit dem Ausgabe-Raumbezug übereinstimmt, wird er basierend auf der ausgewählten Projektionsmethode für Zellengröße 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.

  • Weitere Informationen zur Geoverarbeitung von Umgebungen mit diesem Werkzeug finden Sie unter Analyseumgebungen und Spatial Analyst.

Parameter

BeschriftungErläuterungDatentyp
Ausgabe-Zellengröße
(optional)

Die Zellengröße des Ausgabe-Rasters, das erstellt wird.

Dieser Parameter kann über einen numerischen Wert definiert oder aus einem vorhandenen Raster-Dataset abgerufen werden. Wenn die Zellengröße nicht explizit als Parameterwert angegeben wurde, wird der Zellengrößenwert der Umgebung verwendet, sofern dieser angegeben wurde. Andernfalls werden zusätzliche Regeln verwendet, um ihn aus anderen Eingaben zu berechnen. Weitere Informationen finden Sie im Abschnitt zur Verwendung.

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.

Extent

Rückgabewert

BeschriftungErläuterungDatentyp
Ausgabe-Raster

Das Ausgabe-Raster von normalverteilten Werten mit einem Mittelwert von 0,0 und einer Standardabweichung von 1,0.

Raster

CreateNormalRaster({cell_size}, {extent})
NameErläuterungDatentyp
cell_size
(optional)

Die Zellengröße des Ausgabe-Rasters, das erstellt wird.

Dieser Parameter kann über einen numerischen Wert definiert oder aus einem vorhandenen Raster-Dataset abgerufen werden. Wenn die Zellengröße nicht explizit als Parameterwert angegeben wurde, wird der Zellengrößenwert der Umgebung verwendet, sofern dieser angegeben wurde. Andernfalls werden zusätzliche Regeln verwendet, um ihn aus anderen Eingaben zu berechnen. Weitere Informationen finden Sie im Abschnitt zur Verwendung.

Analysis Cell Size
extent
(optional)

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

Bei Extent handelt es sich um eine Python-Klasse.

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

  • Dabei wird mit XMin und YMin die linke untere Koordinate der Ausdehnung definiert und mit 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.

Extent

Rückgabewert

NameErläuterungDatentyp
out_raster

Das Ausgabe-Raster von normalverteilten Werten mit einem Mittelwert von 0,0 und einer Standardabweichung von 1,0.

Raster

Codebeispiel

CreateNormalRaster – Beispiel 1 (Python-Fenster)

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

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outNormalRaster = CreateNormalRaster(2, Extent(0, 0, 150, 150))
outNormalRaster.save("C:/sapyexamples/output/outnormal")
CreateNormalRaster – Beispiel 2 (eigenständiges Skript)

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

# Name: CreateNormalRaster_Ex_02.py
# Description: Creates a raster of random values from a normal distribution
# 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
cellSize = 2
extent = Extent(0, 0, 150, 150)

# Execute CreateNormalRaster
outNormalRaster = CreateNormalRaster(cellSize, extent) 

# Save the output 
outNormalRaster.save("C:/sapyexamples/output/outnormraster")

Lizenzinformationen

  • Basic: Erfordert Spatial Analyst
  • Standard: Erfordert Spatial Analyst
  • Advanced: Erfordert Spatial Analyst

Verwandte Themen