Ausschneiden (Spatial Analyst)

Mit der Spatial Analyst-Lizenz verfügbar.

Mit der 3D Analyst-Lizenz verfügbar.

Zusammenfassung

Schneidet den Wertebereich der Eingabezellen in Zonen (Klassen) und reklassifiziert sie dadurch. Die verfügbaren Datenklassifizierungsmethoden sind "Gleiches Intervall", "Gleiche Fläche" (Quantil), "Natürliche Unterbrechungen", "Standardabweichung (mittelwertzentriert)", "Standardabweichung (Mittelwert als Unterbrechung)", "Definiertes Intervall" und "Geometrisches Intervall".

Verwendung

  • Für den Parameter Ausschneidemethode sind die folgenden Optionen verfügbar. mit denen Ausgabezonen mit verschiedenen Merkmalen generiert werden können.

    • Gleiche Fläche: Das Ausgabe-Raster enthält die angegebene Anzahl von Zonen mit einer ähnlichen Anzahl der Zellen in jeder Zone.
    • Gleiches Intervall: Das Ausgabe-Raster enthält die angegebene Anzahl von Zonen, wobei alle Zonen identische Wertebereiche enthalten.
    • Natürliche Unterbrechungen und Geometrisches Intervall: Das Ausgabe-Raster enthält die angegebene Anzahl von Zonen, wobei die Anzahl der Zellen in den einzelnen Zonen durch die Klassengrenzen bestimmt wird.
    • Standardabweichung (mittelwertzentriert), Standardabweichung (Mittelwert als Grenze) und Definiertes Intervall: Die Anzahl der Zonen im Ausgabe-Raster wird durch den Wert des Parameters Intervallgröße bestimmt, wobei die Anzahl der Zellen in jeder Zone durch die Klassengrenzen festgelegt wird.

  • Je nach festgelegter Ausschneidemethode muss entweder ein Parameterwert für Anzahl an Ausgabe-Zonen oder für Intervallgröße angegeben werden.

    • Der Parameter Anzahl an Ausgabe-Zonen ist erforderlich, wenn die Ausschneidemethode Gleiche Fläche, Gleiches Intervall, Natürliche Unterbrechungen oder Geometrisches Intervall verwendet wird.
    • Der Parameter Intervallgröße ist bei Verwendung der Ausschneidemethode Definiertes Intervall, Standardabweichung (mittelwertzentriert) oder Standardabweichung (Mittelwert als Grenze) erforderlich.

  • Sie können den Parameter NoData in der Ausgabe in Wert ändern verwenden, um NoData-Werte durch einen ganzzahligen Wert in der Ausgabe zu ersetzen. Wenn Sie verhindern möchten, dass NoData-Zellen mit Ausgabezonen kombiniert werden, können Sie einen ganzzahligen Wert angeben, der außerhalb des erwarteten Bereichs für Ausgabezonen liegt. Wenn die Ausgabezonen beispielsweise im Bereich von 1 bis 5 liegen, können Sie einen Wert kleiner 1 oder größer 5 angeben. Kandidatenwerte umfassen die Werte 0, 100 und -99. Um NoData-Werte mit einer vorhandenen Zone zusammenzuführen, verwenden Sie den ganzzahligen Wert der entsprechenden Zone. Wenn dieser Parameter nicht festgelegt wird, werden Eingabe-NoData-Zellen als NoData-Zellen im Ausgabe-Raster beibehalten.

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Raster

Das zu reklassifizierende Eingabe-Raster.

Raster Layer
Anzahl an Ausgabe-Zonen
(optional)

Die Anzahl der Zonen, in die das Eingabe-Raster reklassifiziert wird.

Dieser Parameter ist erforderlich, wenn für den Parameter Ausschneidemethode der Wert Gleiche Fläche, Gleiches Intervall, Natürliche Unterbrechungen oder Geometrisches Intervall ausgewählt wurde.

Wenn der Wert des Parameters Ausschneidemethode Definiertes Intervall, Standardabweichung (mittelwertzentriert) oder Standardabweichung (Mittelwert als Grenze) lautet, ist der Parameter Anzahl an Ausgabe-Zonen inaktiv. Die Anzahl der Ausgabezonen bestimmt sich aus dem Wert des Parameters Intervallgröße.

Long
Ausschneidemethode
(optional)

Gibt an, wie das Eingabe-Raster in Zonen reklassifiziert wird.

  • Gleiches IntervallDer Bereich der Eingabewerte wird gleichmäßig in die angegebene Anzahl von Ausgabezonen unterteilt, woraus sich die Klassengrenzen bestimmen. Dies ist die Standardeinstellung.
  • Gleiche FlächeDie Eingabezellen werden gleichmäßig in die angegebene Anzahl von Ausgabezonen unterteilt, woraus sich die Klassengrenzen bestimmen. Jede Zone enthält in etwa dieselbe Anzahl an Zellen, was eine ähnliche Flächengröße bedeutet.
  • Natürliche UnterbrechungenDie Klassengrenzen werden so bestimmt, dass die Varianz innerhalb einer Klasse minimiert wird, die Varianz zwischen den Klassen hingegen maximiert. Die Grenzen werden in der Regel bei relativ großen Veränderungen in den Datenwerten festgelegt.
  • Standardabweichung (mittelwertzentriert)Die Klassengrenzen werden anhand der angegebenen Intervallgröße (z. B. 2, 1 oder 0,5) in der Einheit der Standardabweichung ober- und unterhalb des Mittelwertes platziert, bis die Minimal- und Maximalwerte des Eingabe-Rasters erreicht sind. Der Mittelwert wird nicht als Grenze verwendet, sondern befindet sich zentriert zwischen zwei Klassengrenzen. Eine Grenze wird oberhalb des Mittelwertes auf die halbe angegebene Intervallgröße festgelegt, während die andere Grenze unterhalb des Mittelwertes auf die halbe angegebene Intervallgröße festgelegt wird. Die Standardabweichung wird anhand des Nenners n-1 berechnet, wobei n der Anzahl von Pixeln mit einem Wert entspricht.
  • Standardabweichung (Mittelwert als Grenze)Der Mittelwert wird als Klassengrenze verwendet. Die weiteren Klassengrenzen werden anhand der angegebenen Intervallgröße (z. B. 2, 1 oder 0,5) in der Einheit der Standardabweichung ober- und unterhalb des Mittelwertes platziert, bis die Minimal- und Maximalwerte des Eingabe-Rasters erreicht sind. Die Standardabweichung wird anhand des Nenners n-1 berechnet, wobei n der Anzahl von Pixeln mit einem Wert entspricht.
  • Definiertes IntervallDie Klassengrenzen werden auf 0 und auf ein Mehrfaches der angegebenen Intervallgröße relativ zu 0 festgelegt. Für die erste und letzte Klasse werden sie anschließend auf die Minimal- und Maximalwerte der Eingabedaten zugeschnitten. Bei einem Wertebereich, der 0 umfasst, dient 0 stets als Teilungspunkt.
  • Geometrisches IntervallDie Klassengrenzen werden auf Grundlage von Klassenintervallen, die eine geometrische Reihe darstellen, erstellt. Bei diesem Muster entspricht der aktuelle Wert dem vorherigen Wert geteilt durch einen geometrischen Koeffizienten. Der geometrische Koeffizient in dieser Klassifizierung kann einmalig geändert werden (in seinen Kehrwert), um die Klassenbereiche zu optimieren. Der Algorithmus erstellt diese geometrischen Intervalle durch Minimieren der Quadratsumme der Elementzahl pro Klasse. Dadurch wird sichergestellt, dass in jede Klasse ungefähr dieselbe Anzahl von Werten fällt und dass die Änderungen zwischen den einzelnen Intervallen einheitlich sind.
String
Anfangswert für Ausgabe
(optional)

Der Anfangswert, der für Zonen (Klassen) im Ausgabe-Raster-Dataset verwendet wird.

Den Klassen werden ganzzahlige Werte zugewiesen, die ausgehend vom Anfangswert jeweils um 1 erhöht werden.

Der standardmäßige Anfangswert ist 1.

Long
NoData in der Ausgabe in Wert ändern
(optional)

Ein NoData-Wert wird in der Ausgabe durch einen Wert ersetzt.

Wenn dieser Parameter nicht festgelegt wird, werden NoData-Zellen als NoData-Werte im Ausgabe-Raster beibehalten.

Long
Intervallgröße
(optional)

Die Größe des Intervalls zwischen Klassen.

Dieser Parameter ist erforderlich, wenn der Parameter Ausschneidemethode auf Definiertes Intervall, Standardabweichung (mittelwertzentriert) oder Standardabweichung (Mittelwert als Grenze) eingestellt ist.

Wird Definiertes Intervall verwendet, entspricht die Intervallgröße dem tatsächlichen Wertebereich einer Klasse für die Berechnung der Klassengrenzen.

Bei Verwendung von Standardabweichung (mittelwertzentriert) oder Standardabweichung (Mittelwert als Grenze) gibt die Intervallgröße die Anzahl der Standardabweichungen an, die für die Berechnung der Klassengrenzen verwendet wird.

Double

Rückgabewert

BeschriftungErläuterungDatentyp
Ausgabe-Raster

Das reklassifizierte Ausgabe-Raster.

Das Ausgabe-Raster ist stets ein ganzzahliges Raster.

Die Attributtabelle des Ausgabe-Rasters verfügt neben den Standardfeldern ObjectID, Value und Count über zwei neue Felder. Das Feld Value gibt den Klassenwert an. In den Feldern ZoneMin und ZoneMax wird der Minimal- bzw. Maximalwert für die Klassenerstellung aufgezeichnet.

Raster

Slice(in_raster, {number_zones}, {slice_type}, {base_output_zone}, {nodata_to_value}, {class_interval_size})
NameErläuterungDatentyp
in_raster

Das zu reklassifizierende Eingabe-Raster.

Raster Layer
number_zones
(optional)

Die Anzahl der Zonen, in die das Eingabe-Raster reklassifiziert wird.

Dieser Parameter ist erforderlich, wenn für den Parameter slice_type der Wert EQUAL_AREA, EQUAL_INTERVAL, NATURAL_BREAKS oder GEOMETRIC_INTERVAL angegeben ist.

Wenn für den Parameter slice_type der Wert STANDARD_DEVIATION_MEAN_CENTERED, STANDARD_DEVIATION_MEAN_BREAK oder DEFINED_INTERVAL ausgewählt ist, wird der Parameter number_zones nicht unterstützt. Die Anzahl der Ausgabezonen bestimmt sich aus dem Wert des Parameters class_interval_size.

Long
slice_type
(optional)

Gibt an, wie das Eingabe-Raster in Zonen reklassifiziert wird.

  • EQUAL_INTERVALDer Bereich der Eingabewerte wird gleichmäßig in die angegebene Anzahl von Ausgabezonen unterteilt, woraus sich die Klassengrenzen bestimmen. Dies ist die Standardeinstellung.
  • EQUAL_AREADie Eingabezellen werden gleichmäßig in die angegebene Anzahl von Ausgabezonen unterteilt, woraus sich die Klassengrenzen bestimmen. Jede Zone enthält in etwa dieselbe Anzahl an Zellen, was eine ähnliche Flächengröße bedeutet.
  • NATURAL_BREAKSDie Klassengrenzen werden so bestimmt, dass die Varianz innerhalb einer Klasse minimiert wird, die Varianz zwischen den Klassen hingegen maximiert. Die Grenzen werden in der Regel bei relativ großen Veränderungen in den Datenwerten festgelegt.
  • STANDARD_DEVIATION_MEAN_CENTEREDDie Klassengrenzen werden anhand der angegebenen Intervallgröße (z. B. 2, 1 oder 0,5) in der Einheit der Standardabweichung ober- und unterhalb des Mittelwertes platziert, bis die Minimal- und Maximalwerte des Eingabe-Rasters erreicht sind. Der Mittelwert wird nicht als Grenze verwendet, sondern befindet sich zentriert zwischen zwei Klassengrenzen. Eine Grenze wird oberhalb des Mittelwertes auf die halbe angegebene Intervallgröße festgelegt, während die andere Grenze unterhalb des Mittelwertes auf die halbe angegebene Intervallgröße festgelegt wird. Die Standardabweichung wird anhand des Nenners n-1 berechnet, wobei n der Anzahl von Pixeln mit einem Wert entspricht.
  • STANDARD_DEVIATION_MEAN_BREAKDer Mittelwert wird als Klassengrenze verwendet. Die weiteren Klassengrenzen werden anhand der angegebenen Intervallgröße (z. B. 2, 1 oder 0,5) in der Einheit der Standardabweichung ober- und unterhalb des Mittelwertes platziert, bis die Minimal- und Maximalwerte des Eingabe-Rasters erreicht sind. Die Standardabweichung wird anhand des Nenners n-1 berechnet, wobei n der Anzahl von Pixeln mit einem Wert entspricht.
  • DEFINED_INTERVALDie Klassengrenzen werden auf 0 und auf ein Mehrfaches der angegebenen Intervallgröße relativ zu 0 festgelegt. Für die erste und letzte Klasse werden sie anschließend auf die Minimal- und Maximalwerte der Eingabedaten zugeschnitten. Bei einem Wertebereich, der 0 umfasst, dient 0 stets als Teilungspunkt.
  • GEOMETRIC_INTERVALDie Klassengrenzen werden auf Grundlage von Klassenintervallen, die eine geometrische Reihe darstellen, erstellt. Bei diesem Muster entspricht der aktuelle Wert dem vorherigen Wert geteilt durch einen geometrischen Koeffizienten. Der geometrische Koeffizient in dieser Klassifizierung kann einmalig geändert werden (in seinen Kehrwert), um die Klassenbereiche zu optimieren. Der Algorithmus erstellt diese geometrischen Intervalle durch Minimieren der Quadratsumme der Elementzahl pro Klasse. Dadurch wird sichergestellt, dass in jede Klasse ungefähr dieselbe Anzahl von Werten fällt und dass die Änderungen zwischen den einzelnen Intervallen einheitlich sind.
String
base_output_zone
(optional)

Der Anfangswert, der für Zonen (Klassen) im Ausgabe-Raster-Dataset verwendet wird.

Den Klassen werden ganzzahlige Werte zugewiesen, die ausgehend vom Anfangswert jeweils um 1 erhöht werden.

Der standardmäßige Anfangswert ist 1.

Long
nodata_to_value
(optional)

Ein NoData-Wert wird in der Ausgabe durch einen Wert ersetzt.

Wenn dieser Parameter nicht festgelegt wird, werden NoData-Zellen als NoData-Werte im Ausgabe-Raster beibehalten.

Long
class_interval_size
(optional)

Die Größe des Intervalls zwischen Klassen.

Dieser Parameter ist erforderlich, wenn der Parameter slice_type auf DEFINED_INTERVAL, STANDARD_DEVIATION_MEAN_CENTERED oder STANDARD_DEVIATION_MEAN_BREAK festgelegt wurde.

Wird DEFINED_INTERVAL verwendet, entspricht die Intervallgröße dem tatsächlichen Wertebereich einer Klasse für die Berechnung der Klassengrenzen.

Bei Verwendung von STANDARD_DEVIATION_MEAN_CENTERED oder STANDARD_DEVIATION_MEAN_BREAK gibt die Intervallgröße die Anzahl der Standardabweichungen an, die für die Berechnung der Klassengrenzen verwendet wird.

Double

Rückgabewert

NameErläuterungDatentyp
out_raster

Das reklassifizierte Ausgabe-Raster.

Das Ausgabe-Raster ist stets ein ganzzahliges Raster.

Die Attributtabelle des Ausgabe-Rasters verfügt neben den Standardfeldern ObjectID, Value und Count über zwei neue Felder. Das Feld Value gibt den Klassenwert an. In den Feldern ZoneMin und ZoneMax wird der Minimal- bzw. Maximalwert für die Klassenerstellung aufgezeichnet.

Raster

Codebeispiel

Slice: Beispiel 1 (Python-Fenster)

Reklassifiziert das Eingabe-Raster in fünf Klassen, die auf natürlichen Gruppierungen in den Daten basieren.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"

outslice = Slice("elevation", 5, "NATURAL_BREAKS")
outslice.save("C:/sapyexamples/output/elev_slice.tif")
Slice: Beispiel 2 (Python-Fenster)

Das Eingabe-Raster wird mit einem definierten Intervall von 10 reklassifiziert.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"

outslice = Slice("elevation", "", "DEFINED_INTERVAL", "", "", 10)
outslice.save("C:/sapyexamples/output/elev_slice_02.tif")
Slice: Beispiel 3 (eigenständiges Skript)

Reklassifiziert das Eingabe-Raster in 10 Klassen, die auf natürlichen Gruppierungen in den Daten basieren. Der Anfangswert für Ausgabeklassen beträgt dabei -5.

# Name: Slice_Ex_03.py
# Description: Slices the input raster into 10 zones(classes) based on natural groupings inherent in the data.
#              Specify the starting value for output classes to be -5.
# Requirements: Spatial Analyst Extension

# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Set environment settings
env.workspace = "C:/sapyexamples/data"

# Set local variables
inRaster = "elevation"
numberZones = 10
baseOutputZone = -5

# Execute Slice
outSlice = Slice(inRaster, numberZones, "NATURAL_BREAKS", baseOutputZone)

# Save the output
outSlice.save("C:/sapyexamples/output/elev_slice_03.tif")
Slice: Beispiel 4 (eigenständiges Skript)

Das Eingabe-Raster wird in 10 Klassen mit gleicher Fläche reklassifiziert. NoData-Zellen wird in der Ausgabe der Wert -99 zugewiesen.

# Name: Slice_Ex_04.py
# Description: Slices the input raster into 10 zones(classes) based on equal area.
#              Assign NoData cells to have a value of -99 in the output.
# Requirements: Spatial Analyst Extension

# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Set environment settings
env.workspace = "C:/sapyexamples/data"

# Set local variables
inRaster = "elevation"
numberZones = 10
baseOutputZone = 5
nodataToValue = -99
classIntervalSize = "" # or None

# Execute Slice
outSlice = Slice(inRaster, numberZones, "EQUAL_AREA", baseOutputZone, nodataToValue, classIntervalSize)

# Save the output
outSlice.save("C:/sapyexamples/output/elev_slice_04.tif")