Volumen-Perzentil-Konturlinien (Spatial Analyst Tools)

Zusammenfassung

Erstellt Konturlinien, die die kleinste Fläche, die die obersten p Prozent der Gesamtmagnitude (Wert * Zellenfläche) umschließt, darstellen, indem die mit Rängen versehenen Zellen zum Volumenschwellenwert akkumuliert werden.

Weitere Informationen zur Funktionsweise von "Volumen-Perzentil-Konturlinien"

Abbildung

Verwendung

Perzentilwerte können beliebige Werte zwischen 0 und 100 sein. Der Wert 0 kann zu einem leeren oder trivialen Ergebnis führen. Der Wert 100 gibt den gesamten gültigen Footprint zurück.
Dieses Werkzeug weist den Zellen nach ihren Werten in absteigender Reihenfolge Ränge zu und akkumuliert zellenweise das Volumen (Volumen * Zellenfläche), bis die kumulative Summe \(p\) Prozent des Gesamtvolumens des Rasters erreicht. Die Fläche wird mit der Methode berechnet, die im Wert des Parameters Methode festgelegt ist: Planar oder Geodätisch. Der Perzentil-Volumenschwellenwert ist der Wert beim Grenzwert. Die Ausgabe wählt die Zellen aus, die diesem Schwellenwert entsprechen oder ihn überschreiten.
Die Fläche im Ausgabe-Konturlinien-Polygon gibt die Fläche an, die durch den Prozentsatz der Gesamtsumme des mit den Perzentilwerten berechneten Volumens umschlossen wird. Die Fläche der Ausgabepolygone gibt den physischen Footprint an. Dies ist nicht das Volumen, sondern die Fläche, in der sich \(p\) Prozent des Volumens befinden.
Wenn beim Volumenschwellenwert wiederholte Werte vorhanden sind, dann berücksichtigt das Werkzeug alle Werte bei diesem Schwellenwert. Deshalb kann das Ausgabe-Volumen nicht unterhalb des angegebenen Perzentils liegen. Eine Folge davon ist, dass benachbarte Perzentile ähnlich sein können.
Wenn mehrere Perzentilwerte angegeben wurden, werden die Ausgabepolygone geschachtelt. Das innerste Polygon entspricht den höchsten Werten, und das äußerste Polygon deckt die kleineren Werte ab.

Die Shape-Fläche des Polygons gibt an, wie viel Boden sich in diesem Extremwerteband befindet.
Die Option Planar im Parameter Methode eignet sich für Analysen in einem lokalen Maßstab mit einer Projektion, bei der die korrekte Entfernung und Fläche genau beibehalten werden.

Die Option Geodätisch sollte verwendet werden, wenn die Analyse in einem regionalen oder großen Maßstab durchgeführt werden soll (z. B. mit Web Mercator oder einem beliebigen anderen geographischen Koordinatensystem). Bei dieser Option wird die Krümmung des Sphäroids berücksichtigt, und die Daten in der Nähe der Pole und der internationalen Datumsgrenze werden richtig verarbeitet.
Wenn der Parameter Negative Werte ignorieren deaktiviert ist, dann berücksichtigt das Werkzeug negative Eingabezellenwerte bei der Analyse. Dies kann die kumulative Summe der Volumenberechnung beeinflussen.
Das Eingabe-Oberflächen-Raster muss ein Einzelband-Raster sein.
Wenn Sie Polygone ausschließlich auf der Grundlage von gewichteten Zellenwerten erstellen möchten, verwenden Sie stattdessen das Werkzeug Wert-Perzentil-Konturen.
Weitere Informationen zu den Geoverarbeitungsumgebungen für dieses Werkzeug finden Sie unter "Analyseumgebungen und Spatial Analyst".

Beschriftung	Erläuterung	Datentyp
Eingabe-Oberflächen-Raster	Das Eingabe-Raster, für das Konturlinien-Polygone berechnet werden sollen. Dies muss ein kontinuierliches Raster sein. Die Eingabe-Raster-Daten können ganzzahlige Werte oder Gleitkommawerte sein.	Raster Layer
Ausgabe-Konturlinien-Polygone	Die Ausgabe-Konturlinien-Polygon-Features. Die Ausgabe enthält Konturlinien-Polygone für alle angegebenen Perzentilwerte.	Feature Class
Perzentilwerte (Optional)	Die Perzentilwerte, für die Konturlinien berechnet werden sollen. Der Standardwert ist 90 und steht für das 90. Perzentil. Zulässige Werte können zwischen 0 und 100 liegen.	Double
Methode (Optional)	Gibt an, ob die Berechnung mit einer planaren (flache Erde) oder geodätischen (Ellipsoid) Methode erfolgen soll. Die planare Methode eignet sich zum Berechnen lokaler Flächen in einer Projektion, bei der die korrekte Entfernung und Fläche beibehalten werden. Damit lassen sich Analysen von Flächen wie Städten, Landkreisen oder flächenmäßig kleineren Bundesstaaten durchführen. Die geodätische Methode liefert ein genaueres Ergebnis, allerdings fällt hierfür evtl. eine längere Verarbeitungszeit an. Planar—Die Berechnung erfolgt auf einer projizierten flachen Ebene mithilfe eines kartesischen 2D-Koordinatensystems. Dies ist die Standardeinstellung. Geodätisch—Die Berechnung erfolgt mithilfe eines kartesischen 3D-Koordinatensystems, wobei die Form der Erde als Ellipsoid berücksichtigt wird.	String
Negative Werte ignorieren (Optional)	Gibt an, ob bei der Volumen-Perzentil-Berechnung negative Werte ignoriert werden sollen. Aktiviert—Bei der Volumen-Perzentil-Berechnung werden negative Werte ignoriert. Deaktiviert—Bei der Volumen-Perzentil-Berechnung werden negative Werte nicht ignoriert, sondern berücksichtigt. Dies ist die Standardeinstellung.	Boolean
Ausgaben glätten (Optional)	Bestimmt, ob die Ausgabe-Polygone in einfachere Shapes überführt werden oder mit den Zellrändern des Eingabe-Rasters übereinstimmen. Aktiviert—Die Polygone werden in einfachere Shapes überführt. Die Glättung wird so durchgeführt, dass die Polygone eine minimale Segmentanzahl enthalten und dabei so nahe wie möglich an den ursprünglichen Raster-Zellenrändern liegen. Dies ist die Standardeinstellung. Deaktiviert—Die Kante der Polygone stimmt exakt mit den Zellrändern des Eingabe-Rasters überein. Durch die Rückkonvertierung der resultierenden Polygon-Feature-Class in ein Raster wird bei dieser Option ein Raster erstellt, das dem ursprünglichen Raster entspricht.	Boolean

VolumePercentileContours(in_surface_raster, out_contour_polygons, {percentile_values}, {method}, {ignore_negative_values}, {smooth_outputs})

Name	Erläuterung	Datentyp
in_surface_raster	Das Eingabe-Raster, für das Konturlinien-Polygone berechnet werden sollen. Dies muss ein kontinuierliches Raster sein. Die Eingabe-Raster-Daten können ganzzahlige Werte oder Gleitkommawerte sein.	Raster Layer
out_contour_polygons	Die Ausgabe-Konturlinien-Polygon-Features. Die Ausgabe enthält Konturlinien-Polygone für alle angegebenen Perzentilwerte.	Feature Class
percentile_values [percentile_values,...] (Optional)	Die Perzentilwerte, für die Konturlinien berechnet werden sollen. Der Standardwert ist 90 und steht für das 90. Perzentil. Zulässige Werte können zwischen 0 und 100 liegen.	Double
method (Optional)	Gibt an, ob die Berechnung mit einer planaren (flache Erde) oder geodätischen (Ellipsoid) Methode erfolgen soll. Die planare Methode eignet sich zum Berechnen lokaler Flächen in einer Projektion, bei der die korrekte Entfernung und Fläche beibehalten werden. Damit lassen sich Analysen von Flächen wie Städten, Landkreisen oder flächenmäßig kleineren Bundesstaaten durchführen. Die geodätische Methode liefert ein genaueres Ergebnis, allerdings fällt hierfür evtl. eine längere Verarbeitungszeit an. `PLANAR`—Die Berechnung erfolgt auf einer projizierten flachen Ebene mithilfe eines kartesischen 2D-Koordinatensystems. Dies ist die Standardeinstellung. `GEODESIC`—Die Berechnung erfolgt mithilfe eines kartesischen 3D-Koordinatensystems, wobei die Form der Erde als Ellipsoid berücksichtigt wird.	String
ignore_negative_values (Optional)	Gibt an, ob bei der Volumen-Perzentil-Berechnung negative Werte ignoriert werden sollen. `IGNORE_NEGATIVE_VALUES`—Bei der Volumen-Perzentil-Berechnung werden negative Werte ignoriert. `USE_ALL_VALUES`—Bei der Volumen-Perzentil-Berechnung werden negative Werte nicht ignoriert, sondern berücksichtigt. Dies ist die Standardeinstellung.	Boolean
smooth_outputs (Optional)	Bestimmt, ob die Ausgabe-Polygone in einfachere Shapes überführt werden oder mit den Zellrändern des Eingabe-Rasters übereinstimmen. `SMOOTH`—Die Polygone werden in einfachere Shapes überführt. Die Glättung wird so durchgeführt, dass die Polygone eine minimale Segmentanzahl enthalten und dabei so nahe wie möglich an den ursprünglichen Raster-Zellenrändern liegen. Dies ist die Standardeinstellung. `NO_SMOOTH`—Die Kante der Polygone stimmt exakt mit den Zellrändern des Eingabe-Rasters überein. Durch die Rückkonvertierung der resultierenden Polygon-Feature-Class in ein Raster wird bei dieser Option ein Raster erstellt, das dem ursprünglichen Raster entspricht.	Boolean

Codebeispiel

VolumePercentileContours Beispiel 1 (Python-Fenster)

Anhand des folgenden Beispiels wird die Verwendung dieses Werkzeugs im Python-Fenster veranschaulicht.

import arcpy
from arcpy import env
from arcpy.sa import *

env.workspace = "C:/sapyexamples/data"
VolumePercentileContours("CrimeEventsDensity.tif", "VolP_CrimeDensity_Out.shp",
                         [50, 75, 90, 95, 99], method = "Planar",
                         ignore_negative_values = "USE_ALL_VALUES",
                         smooth_outputs="SMOOTH")

VolumePercentileContours Beispiel 2 (eigenständiges Skript)

Im folgenden Beispiel wird die Verwendung dieses Werkzeugs in einem eigenständigen Python-Skript veranschaulicht.

## Name: VolumePercentileContours_Ex_standalone.py
## Description: Delineate areas of different magnitudes from density surface
## 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"
# To allow overwriting outputs change overwriteOutput option to True.
env.overwriteOutput = False

## Set local variables
in_surface_raster = "CrimeEventsDensity.tif"
percentile_values = [25, 50, 75, 90, 95, 99]
method = "Planar"
ignore_negative_values = "USE_ALL_VALUES"
smooth_outputs="SMOOTH"
out_volP_contour = "VolumeP_CrimeDensity_Out.shp"

## Run: Create Volume Percentile Contours
VolumP_out_contours = VolumePercentileContours(in_surface_raster,
                                               out_volP_contour,
                                               percentile_values, method,
                                               ignore_negative_values, smooth_outputs)

Umgebungen

Auto-Commit, Aktueller Workspace, Standard-Ausgabe-Z-Werte, Ausdehnung, Geographische Transformationen, M-Auflösung, M-Toleranz, Faktor für parallele Verarbeitung, Ausgabe-CONFIG-Schlüsselwort, Ausgabe-Koordinatensystem, Ausgabe hat M-Werte, Ausgabe hat Z-Werte, Ausgabe-M-Domäne, Ausgabe-XY-Domäne, Ausgabe-Z-Domäne, Scratch-Workspace, XY-Auflösung, XY-Toleranz, Z-Auflösung, Z-Toleranz

Lizenzierungsinformationen

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