Speicherkapazität (Spatial Analyst)

Mit der Spatial Analyst-Lizenz verfügbar.

Zusammenfassung

Erstellt eine Tabelle und ein Diagramm mit Höhenangaben und entsprechenden Speicherkapazitäten für ein Eingabe-Oberflächen-Raster. Mit dem Werkzeug werden die Oberfläche und das Gesamtvolumen der zugrunde liegenden Region bei einer Reihe von Höheninkrementen berechnet.

Verwendung

  • Mit dem Werkzeug wird eine Tabelle der Oberfläche und des Gesamtvolumens bei einer Reihe von Höheninkrementen erstellt. Die Tabelle enthält einen Datensatz für jedes Höheninkrement für jede Zone.

    Die Ausgabetabelle weist das folgende Schema auf:

    • Die Felder lauten ELEVATION, AREA und VOLUME.
    • Die Felder für Fläche und Volumen enthalten die Berechnungen der Speicherkapazität bei jedem Höheninkrement.
    • Die Felder für Höhe und Volumen werden in Z-Einheiten berechnet. Das Flächenfeld wird in XY-Einheiten des Eingabe-Oberflächen-Rasters berechnet.
    • Wenn keine Zonen angegeben werden, wird das Feld ZONE_CODE mit einem Wert von 1 für alle Datensätze hinzugefügt, die die Analyseausdehnung als einzige Zone enthalten.
    • Wenn Zonen angegeben werden, wird ein Feld basierend auf dem Parameterwert Zonenfeld (zone_field in Python) hinzugefügt. Für ein Zonenfeld mit ganzen Zahlen wird ein Feld mit demselben Namen in der Ausgabetabelle hinzugefügt. Für ein Zonenfeld mit Zeichenfolgen wird ein Feld mit demselben Namen in der Ausgabetabelle und das zusätzliche Feld ZONE_CODE hinzugefügt.
  • Es werden optional zwei Diagramme erstellt, um Höhenflächen- und Höhenvolumenkurven darzustellen. Die Diagramme werden zusammen mit der Ausgabetabelle zum Bereich Inhalt hinzugefügt. Die Namenskonvention, die für den Diagrammnamen verwendet wird, lautet <out_chart>-Höhenflächenkurve und <out_chart>-Höhenvolumenkurve, wobei <out_chart> mit dem Namen ersetzt wird, der im Parameter Ausgabe-Diagrammname (out_chart in Python) angegeben wird. Wenn ein Diagramm mit mehreren Zonen erstellt wird, repräsentiert jede Linie im Diagramm eine Zone. Verwenden Sie die Legende, um die Linien im Diagramm ein- oder auszuschalten. Weitere Informationen zu Details bei der Arbeit mit Diagrammen in ArcGIS Pro finden Sie unter Kurzer Überblick über Diagramme. Die Diagramme können nur in ArcGIS Pro erstellt werden; sie werden nicht von einem eigenständigen Skript unterstützt.

  • Verwenden Sie den Parameter Analysetyp (analysis_type in Python), um die Oberfläche, die Volumenberechnung oder beides auszuwählen. Auf diese Weise wird das Schema für Tabellen und Diagramme festgelegt. Wenn beispielsweise die Option Fläche (AREA in Python) ausgewählt wird, wird nur ein Flächenfeld in der Ausgabetabelle erstellt und das Volumenfeld wird ausgelassen. Ebenso wird nur ein Diagramm für die Höhenflächenkurve erstellt.

  • Wenn keine Zonen angegeben werden, wird die Speicherkapazität berechnet, indem die Analyseausdehnung als einzige Zone verwendet wird. Geben Sie einen optionalen Parameterwert für Eingabe-Raster- oder -Feature-Zonen-Daten (in_zone_data in Python) an, der die Zonen repräsentiert, in denen Speicherkapazitäten berechnet werden müssen. Eine Zone kann beispielsweise ein Reservoir oder ein Rückhaltebecken sein. Das Werkzeug unterstützt Berechnungen in mehreren Zonen, und Speicherkapazitäten werden unabhängig in jeder Zone basierend auf einem Zonenfeld berechnet.

  • Die Höheninkremente, für die die Speicherkapazitäten berechnet werden, basieren auf den Parameterwerten Mindesthöhe (min_elevation in Python), Maximale Höhe (max_elevation in Python), Inkrementtyp (increment_type in Python) und Inkrement (increment in Python).

  • Die standardmäßigen Parameterwerte Mindesthöhe und Maximale Höhe werden wie folgt bestimmt:

    • Das Werkzeug verwendet die minimalen und maximalen Zonenwerte aus dem Eingabe-Oberflächen-Raster als Standardwerte. Diese Werte können von Zone zu Zone variieren – je nach den minimalen und maximalen Zonenwerten aus dem Eingabe-Oberflächen-Raster in diesen Zonen.
    • Wenn Sie einen Parameterwert für Mindesthöhe oder Maximale Höhe angeben, verwendet das Werkzeug denselben Wert für minimale und maximale Inkremente in allen Zonen. In diesem Fall werden, wenn ein Subset an Höheninkrementen kleiner als das Zonenminimum ist, die Fläche und das Volumen als null berechnet. Wenn sie größer sind als das Zonenmaximum, werden Flächen und Volumen für diese Inkremente nicht berechnet und werden entsprechend dem Tabellenformat als NULL oder 0 angezeigt.
  • Geben Sie den Parameter Z-Einheit (z_unit in Python) an, um die vertikalen Einheiten des Eingabe-Oberflächen-Rasters anzuzeigen. Wenn für das Eingabe-Oberflächen-Raster ein vertikales Koordinatensystem angegeben wurde, werden diese Einheiten als standardmäßige Z-Einheit verwendet. Wenn keine Z-Einheit angegeben wird und das Eingabe-Oberflächen-Raster kein vertikales Koordinatensystem aufweist, ist "Meter" die standardmäßige Z-Einheit. Wenn sich die XY-Einheiten von der Z-Einheit unterscheiden, werden die XY-Einheiten so konvertiert, dass sie der Z-Einheit entsprechen, wenn Volumen berechnet werden.

  • Dieses Werkzeug verwendet standardmäßig Mehrkernprozessoren, wenn diese verfügbar sind. Es können maximal vier Kerne verwendet werden.

    Wenn Sie weniger Kerne verwenden möchten, verwenden Sie die Umgebungseinstellung Faktor für parallele Verarbeitung.

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Oberflächen-Raster

Das Eingabe-Raster, das eine kontinuierliche Oberfläche darstellt.

Raster Layer
Ausgabetabelle

Die Ausgabetabelle, die für jede Zone die Oberfläche und das Gesamtvolumen für jedes Inkrement in der Höhe enthält.

Table
Eingabe-Raster- oder -Feature-Zonen-Daten

Das Dataset, das die Zonen definiert.

Die Zonen können durch ein Integer-Raster oder einen Feature-Layer festgelegt werden.

Raster Layer; Feature Layer
Zonenfeld
(optional)

Das Feld, das die Werte enthält, die die einzelnen Zonen definieren.

Es kann sich dabei um ein Ganzzahl- oder ein Zeichenfolgefeld des Zonen-Datasets handeln.

Field
Analysetyp
(optional)

Gibt den Analysetyp an.

  • Fläche und VolumenOberflächen und Gesamtvolumen werden für jedes Höheninkrement berechnet. Dies ist die Standardeinstellung.
  • FlächeDie Oberfläche wird für jedes Höheninkrement berechnet.
  • VolumenDas Gesamtvolumen wird für jedes Höheninkrement berechnet.
String
Minimale Höhe
(optional)

Die Mindesthöhe, für die Speicherkapazitäten beurteilt werden.

Standardmäßig verwendet das Werkzeug den minimalen Oberflächen-Rasterwert in jeder Zone als Mindesthöhe für diese Zone. Wird ein Wert angegeben, wird er als Mindesthöhe in allen Zonen verwendet.

Double
Maximale Höhe
(optional)

Die maximale Höhe, für die Speicherkapazitäten beurteilt werden.

Standardmäßig verwendet das Werkzeug den maximalen Oberflächen-Rasterwert in jeder Zone als maximale Höhe für diese Zone. Wird ein Wert angegeben, wird er als maximale Höhe in allen Zonen verwendet.

Double
Inkrementtyp
(optional)

Gibt den zu verwendenden Inkrementtyp an, wenn Höheninkremente zwischen Mindesthöhen und maximalen Höhen berechnet werden.

  • Anzahl von InkrementenDie Anzahl der Inkremente zwischen Mindesthöhe und maximaler Höhe wird verwendet. Dies ist die Standardeinstellung.
  • InkrementwertDie Höhendifferenz zwischen den einzelnen Inkrementen wird verwendet.
String
Inkrement
(optional)

Ein Inkrementwert, der die Anzahl der Inkremente oder die Differenz in der Höhe zwischen Inkrementen darstellt. Der Wert wird basierend auf dem Inkrementtyp-Parameterwert festgelegt.

Double
Z-Einheit
(optional)

Gibt die lineare Einheit an, die für vertikale Z-Werte verwendet werden soll.

  • ZollDie lineare Einheit ist Zoll.
  • FußDie lineare Einheit ist Fuß.
  • YardDie lineare Einheit ist Yard.
  • Meilen (US)Die lineare Einheit ist Meilen.
  • SeemeileDie lineare Einheit ist Seemeilen.
  • MillimeterDie lineare Einheit ist Millimeter.
  • ZentimeterDie lineare Einheit ist Zentimeter.
  • MeterDie lineare Einheit ist Meter.
  • KilometerDie lineare Einheit ist Kilometer.
  • DezimeterDie lineare Einheit ist Dezimeter.
String
Ausgabe-Diagrammname
(optional)

Der Name des anzuzeigenden Ausgabediagramms.

Das Diagramm wird im Bereich Inhalt unter Standalone-Tabellen aufgeführt.

Chart

StorageCapacity(in_surface_raster, out_table, in_zone_data, {zone_field}, {analysis_type}, {min_elevation}, {max_elevation}, {increment_type}, {increment}, {z_unit}, {out_chart})
NameErläuterungDatentyp
in_surface_raster

Das Eingabe-Raster, das eine kontinuierliche Oberfläche darstellt.

Raster Layer
out_table

Die Ausgabetabelle, die für jede Zone die Oberfläche und das Gesamtvolumen für jedes Inkrement in der Höhe enthält.

Table
in_zone_data

Das Dataset, das die Zonen definiert.

Die Zonen können durch ein Integer-Raster oder einen Feature-Layer festgelegt werden.

Raster Layer; Feature Layer
zone_field
(optional)

Das Feld, das die Werte enthält, die die einzelnen Zonen definieren.

Es kann sich dabei um ein Ganzzahl- oder ein Zeichenfolgefeld des Zonen-Datasets handeln.

Field
analysis_type
(optional)

Gibt den Analysetyp an.

  • AREA_VOLUMEOberflächen und Gesamtvolumen werden für jedes Höheninkrement berechnet. Dies ist die Standardeinstellung.
  • AREADie Oberfläche wird für jedes Höheninkrement berechnet.
  • VOLUMEDas Gesamtvolumen wird für jedes Höheninkrement berechnet.
String
min_elevation
(optional)

Die Mindesthöhe, für die Speicherkapazitäten beurteilt werden.

Standardmäßig verwendet das Werkzeug den minimalen Oberflächen-Rasterwert in jeder Zone als Mindesthöhe für diese Zone. Wird ein Wert angegeben, wird er als Mindesthöhe in allen Zonen verwendet.

Double
max_elevation
(optional)

Die maximale Höhe, für die Speicherkapazitäten beurteilt werden.

Standardmäßig verwendet das Werkzeug den maximalen Oberflächen-Rasterwert in jeder Zone als maximale Höhe für diese Zone. Wird ein Wert angegeben, wird er als maximale Höhe in allen Zonen verwendet.

Double
increment_type
(optional)

Gibt den zu verwendenden Inkrementtyp an, wenn Höheninkremente zwischen Mindesthöhen und maximalen Höhen berechnet werden.

  • NUMBER_OF_INCREMENTSDie Anzahl der Inkremente zwischen Mindesthöhe und maximaler Höhe wird verwendet. Dies ist die Standardeinstellung.
  • VALUE_OF_INCREMENTDie Höhendifferenz zwischen den einzelnen Inkrementen wird verwendet.
String
increment
(optional)

Ein Inkrementwert, der die Anzahl der Inkremente oder die Differenz in der Höhe zwischen Inkrementen darstellt. Der Wert wird basierend auf dem Inkrementtyp-Parameterwert festgelegt.

Double
z_unit
(optional)

Gibt die lineare Einheit an, die für vertikale Z-Werte verwendet werden soll.

  • INCHDie lineare Einheit ist Zoll.
  • FOOTDie lineare Einheit ist Fuß.
  • YARDDie lineare Einheit ist Yard.
  • MILE_USDie lineare Einheit ist Meilen.
  • NAUTICAL_MILEDie lineare Einheit ist Seemeilen.
  • MILLIMETERDie lineare Einheit ist Millimeter.
  • CENTIMETERDie lineare Einheit ist Zentimeter.
  • METERDie lineare Einheit ist Meter.
  • KILOMETERDie lineare Einheit ist Kilometer.
  • DECIMETERDie lineare Einheit ist Dezimeter.
String
out_chart
(optional)

Der Name des anzuzeigenden Ausgabediagramms.

Chart

Codebeispiel

StorageCapacity – Beispiel 1 (Python-Fenster)

Verwenden Sie das Werkzeug StorageCapacity, um für jede Zone in einem Zonen-Feature eine Tabelle mit Oberflächen und Gesamtvolumen auf zehn Höheninkrementen in einem Eingabe-Oberflächen-Raster zu erstellen.

import arcpy
from arcpy.sa import *
arcpy.env.workspace = "C:/sapyexamples/data"
arcpy.sa.StorageCapacity("in_surface.tif", "out_table", "in_zones", "zone_id")
StorageCapacity – Beispiel 2 (eigenständiges Skript)

Verwenden Sie das Werkzeug StorageCapacity, um für jede Zone in einem Zonen-Feature eine Tabelle mit Oberflächen und Gesamtvolumen auf zehn Höheninkrementen in einem Eingabe-Oberflächen-Raster zu erstellen.

# Name: StorageCapacity_Standalone.py
# Description: 
# Requirements: Spatial Analyst Extension

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

# Set the analysis environments
arcpy.CheckOutExtension("Spatial")
arcpy.env.workspace = "C:/arcpyExamples/data"

# Set local variables
in_surface_raster = "in_surface.tif"
out_table = "fgdb.gdb\out_table"
in_zones = "fgdb.gdb\in_zones"
zone_field = "zone_id"

# Execute StorageCapacity tool
arcpy.sa.StorageCapacity(in_surface_raster, out_table, in_zones, zone_field)

Lizenzinformationen

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

Verwandte Themen