Abtrag/Auftrag-Volumen berechnen (Image Analyst Tools)

Zusammenfassung

Berechnet das Abtrag/Auftrag-Volumen zwischen einer Basishöhenoberfläche und einem Höhen-Raster. Außerdem kann ein Abtrag/Auftrag-Raster generiert werden. Die Basishöhenoberfläche kann mit verschiedenen Typen angegeben werden, beispielsweise mit einer Feature-Class, die ein oder mehrere Polygone enthält, einem Polygon-Array, einer JSON-Zeichenfolge oder -Datei oder einem Raster.

Verwendung

Der Parameterwert Ausgabe-Abtrag/Auftrag-Raster ist ein Raster-Dataset, das aus Flächen besteht, die Flächen darstellen, in denen Material entfernt wurde (Abtrag), und Flächen, in denen Material hinzugefügt wurde (Auftrag). Klicken Sie auf das Dataset für das Ausgabe-Abtrag/Auftrag-Raster, um die Abtrag/Auftrag-Informationen im Bereich Informationen zum Bild anzuzeigen.
Die Volumenwerte im Parameterwert Ausgabe-Abtrag/Auftrag-Raster sind für Flächen mit Abtrag positiv und für Flächen mit Auftrag negativ. Der Pixelwert -0,000305 zum Beispiel gibt einen Auftrag in Kubikmetern an.
Wenn als Eingabe für den Parameterwert Basisoberfläche Polygone verwendet werden, sind für den Parameter Basisoberflächentyp die Optionen Oberfläche, Minimum, Maximum, Mittelwert, Z-Konstante und Z-Geometrie aktiviert.

Der Parameterwert Ausgabe-Volumeninformationen enthält die Abtrag/Auftrag-Volumeninformationen in einer .txt- oder .json-Datei. Nachfolgend finden Sie eine Beispielausgabe:

<!--```json [ { "area" : 19009.705386691581, "cut" : 19216.883079243154, "fill" : -31352.230228323864, "cutCellCount" : 668750, "fillCellCount": 936135, "minz" : 24.048617219013618, "maxz" : 239.59296198262672, "meanz" : 127.5100044561793 } ]


Die Informationen in der Datei sind wie folgt organisiert:

- `area`—Die Fläche in Quadratmetern

- `cut`—Das Abtragvolumen in Kubikmetern

- `fill`—Das Auftragvolumen in Kubikmetern

- `cutCellCount`—Die Anzahl der Abtragzellen

- `fillCellCount`—Die Anzahl der Auftragzellen

- `minz`—Der Minimalwert der Höhe in Metern

- `maxz`—Der Maximalwert der Höhe in Metern

- `meanz`—Der Mittelwert der Höhe in Metern

Beschriftung	Erläuterung	Datentyp
Eingabe-DSM	Das Eingabe-DSM-Höhen-Raster (Digital Surface Model, Digitales Oberflächenmodell) Dieses Eingabe-DSM-Höhen-Raster wird mit dem Basishöhen-Raster verglichen.	Raster Dataset; Mosaic Dataset; Mosaic Layer; Raster Layer; Image Service
Basisoberfläche	Die Basishöhenoberfläche, die zum Berechnen von Abtrag/Auftrag-Volumen verwendet wird. Für die Basishöhenoberfläche werden verschiedene Typen unterstützt, beispielsweise eine Feature-Class, die ein oder mehrere Polygone enthält, ein Polygon-Array, eine JSON-Zeichenfolge oder -Datei oder ein Raster.	Raster Dataset; Mosaic Dataset; Mosaic Layer; Raster Layer; Image Service; Feature Class; Feature Layer; String; File
Basisoberflächentyp	Gibt den Basisoberflächentyp an, der für die Basisoberfläche verwendet wird. Oberfläche—Die Höhenwerte des Eingabe-DSM an der Position des Stützpunkts des Polygons werden zum Erstellen der Basisoberfläche verwendet. Minimum—Der Minimalwert für die Höhe aus dem Eingabe-DSM für den Umfang des Basisoberflächenpolygons wird als Basisoberfläche verwendet. Maximum—Der Maximalwert für die Höhe aus dem Eingabe-DSM für den Umfang des Basisoberflächenpolygons wird als Basisoberfläche verwendet. Mittelwert—Der Durchschnittswert für die Höhe aus dem Eingabe-DSM für den Umfang des Basisoberflächenpolygons wird als Basisoberfläche verwendet. Z-Konstante—Der konstante Z-Wert wird als Basisoberfläche verwendet. Geometrie-Z-Wert—Der Z-Wert der 3D-Geometriestützpunkte wird zum Erstellen der Basisoberfläche verwendet. Wenn die Option mit einer Feature-Class ohne Höhe verwendet wird, wird der Höhenwert aus dem Parameterwert Eingabe-DSM verwendet. DSM—Ein DSM wird als Basisoberfläche verwendet.	String
Z-Konstante (Optional)	Der Wert, der zum Definieren der Höhenebene für die Durchführung der Volumenberechnung verwendet wird. Dieser Parameter ist aktiv, wenn der Parameter Oberflächentyp auf Z-Konstante festgelegt ist.	Linear Unit
Ausgabe-Volumeninformationen (Optional)	Die Ausgabedatei mit Abtrag-Auftrag-Volumeninformationen Die Datei kann eine `.txt`- oder `.json`-Datei sein. Die Ergebnisse werden für Flächenberechnungen in Quadratmetern und für Volumenberechnungen in Kubikmetern angegeben.	File
Ausgabe-Abtrag/Auftrag-Raster (Optional)	Das Ausgabe-Abtrag/Auftrag-Volumen-Raster. Geben Sie eine Dateierweiterung für verschiedene Formate für das Raster-Dataset an. Der Parameter unterstützt allgemein verwendete Raster-Typen wie beispielsweise `.tif`-, `.crf`-, `.img`-, GRID- und File-Geodatabase-Raster.	Raster Dataset

CalculateCutFillVolume(in_raster, in_base_surface, base_surface_type, {constant_z}, {out_volume_info}, {out_cut_fill_raster})

Name	Erläuterung	Datentyp
in_raster	Das Eingabe-DSM-Höhen-Raster (Digital Surface Model, Digitales Oberflächenmodell) Dieses Eingabe-DSM-Höhen-Raster wird mit dem Basishöhen-Raster verglichen.	Raster Dataset; Mosaic Dataset; Mosaic Layer; Raster Layer; Image Service
in_base_surface	Die Basishöhenoberfläche, die zum Berechnen von Abtrag/Auftrag-Volumen verwendet wird. Für die Basishöhenoberfläche werden verschiedene Typen unterstützt, beispielsweise eine Feature-Class, die ein oder mehrere Polygone enthält, ein Polygon-Array, eine JSON-Zeichenfolge oder -Datei oder ein Raster.	Raster Dataset; Mosaic Dataset; Mosaic Layer; Raster Layer; Image Service; Feature Class; Feature Layer; String; File
base_surface_type	Gibt den Basisoberflächentyp an, der für die Basisoberfläche verwendet wird. `SURFACE`—Die Höhenwerte des Eingabe-DSM an der Position des Stützpunkts des Polygons werden zum Erstellen der Basisoberfläche verwendet. `MINIMUM`—Der Minimalwert für die Höhe aus dem Eingabe-DSM für den Umfang des Basisoberflächenpolygons wird als Basisoberfläche verwendet. `MAXIMUM`—Der Maximalwert für die Höhe aus dem Eingabe-DSM für den Umfang des Basisoberflächenpolygons wird als Basisoberfläche verwendet. `MEAN`—Der Durchschnittswert für die Höhe aus dem Eingabe-DSM für den Umfang des Basisoberflächenpolygons wird als Basisoberfläche verwendet. `CONSTANTZ`—Der konstante Z-Wert wird als Basisoberfläche verwendet. `GEOMETRYZ`—Der Z-Wert der 3D-Geometriestützpunkte wird zum Erstellen der Basisoberfläche verwendet. Wenn die Option mit einer Feature-Class ohne Höhe verwendet wird, wird der Höhenwert aus dem Parameterwert `in_raster` verwendet. `DSM`—Ein DSM wird als Basisoberfläche verwendet.	String
constant_z (Optional)	Der Wert, der zum Definieren der Höhenebene für die Durchführung der Volumenberechnung verwendet wird. Dieser Parameter wird aktiviert, wenn der Parameter `base_surface_type` auf `CONSTANTZ` gesetzt ist.	Linear Unit
out_volume_info (Optional)	Die Ausgabedatei mit Abtrag-Auftrag-Volumeninformationen Die Datei kann eine `.txt`- oder `.json`-Datei sein. Die Ergebnisse werden für Flächenberechnungen in Quadratmetern und für Volumenberechnungen in Kubikmetern angegeben.	File
out_cut_fill_raster (Optional)	Das Ausgabe-Abtrag/Auftrag-Volumen-Raster. Geben Sie eine Dateierweiterung für verschiedene Formate für das Raster-Dataset an. Der Parameter unterstützt allgemein verwendete Raster-Typen wie beispielsweise `.tif`-, `.crf`-, `.img`-, GRID- und File-Geodatabase-Raster.	Raster Dataset

Codebeispiel

CalculateCutfillVolume: Beispiel 1 (Python-Fenster)

In diesem Beispiel werden Volumeninformationen mit einer JSON-Zeichenfolge mit einem Polygon-Array als Basisoberfläche berechnet.

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

arcpy.ia.CalculateCutfillVolume(in_raster=r"C:\Data\YVWD_dsm.crf", in_base_surface='{"objectIdFieldName":"OBJECTID","fields":[{"name":"OBJECTID","type":"esriFieldTypeOID","alias":"OBJECTID","domain":null},{"name":"Shape","type":"esriFieldTypeGeometry","alias":"Shape","domain":null},{"name":"id","type":"esriFieldTypeInteger","alias":"ID","domain":null},{"name":"name","type":"esriFieldTypeString","alias":"NAME","domain":null},{"name":"baseType","type":"esriFieldTypeInteger","alias":"BASE SURFACE TYPE","domain":{"type":"codedValue","name":"VolumeBaseSurfaceType","description":"Base surface types for volume calculation.","codedValues":[{"name":"Costant Z","code":0},{"name":"Best Fit","code":1},{"name":"Minimum Z","code":2},{"name":"Maximum Z","code":3},{"name":"Average Z","code":4}],"mergePolicy":"esriMPTDefaultValue","splitPolicy":"esriSPTDefaultValue"}},{"name":"constantZ","type":"esriFieldTypeDouble","alias":"CONSTANT Z","domain":null},{"name":"area","type":"esriFieldTypeDouble","alias":"AREA","domain":null},{"name":"minz","type":"esriFieldTypeDouble","alias":"MINIMUM Z","domain":null},{"name":"maxz","type":"esriFieldTypeDouble","alias":"MAXIMUM Z","domain":null},{"name":"meanz","type":"esriFieldTypeDouble","alias":"MEAN Z","domain":null},{"name":"cut","type":"esriFieldTypeDouble","alias":"CUT","domain":null},{"name":"fill","type":"esriFieldTypeDouble","alias":"FILL","domain":null}],"geometryType":"esriGeometryPolygon","spatialReference":{"wkid":102100,"latestWkid":3857},"features":[{"geometry":{"rings":[[[-13034818.299460374,4029761.0475366744],[-13034772.914974842,4029762.241865241],[-13034776.497960543,4029728.5020832345],[-13034835.915806731,4029729.3978296597],[-13034818.299460374,4029761.0475366744]]],"spatialReference":{"wkid":102100,"latestWkid":3857}},"attributes":{"id":1,"name":"AOI 1","baseType":0,"constantZ":90,"area":1172.3330906432095,"minz":626.8749025576568,"maxz":629.5470508029413,"meanz":627.6681208213765,"cut":631398.5623827629,"fill":0}}]}', base_surface_type="MINIMUM",
constant_z=300,
out_volume_info=r"C:\cutfill\volume.json",
out_cut_fill_raster=r"C:\cutfill\CutFillRaster.crf")

CalculateCutfillVolume: Beispiel 2 (eigenständiges Skript)

In diesem Beispiel wird das Volumen mit einer Polygon-Feature-Class als Basisoberfläche berechnet.

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

# Define parameters.
in_raster = r"C:\Data\YVWD_dsm.crf"
in_base_surface = r"C:\Data\YVWD.gdb\AOI_2D"
base_surface_type = "SURFACE"
constant_z = "None"
out_volume_info = r"C:\Output\volume.json"
out_cut_fill_raster = r"C:\Data\YVWD.gdb\CutFillRaster"

# Run CalculateVolume
arcpy.ia.CalculateCutfillVolume(in_raster, in_base_surface, base_surface_type, constant_z, out_volume_info, out_cut_fill_raster)

Umgebungen

Dieses Werkzeug verwendet keine Geoverarbeitungsumgebungen.

Lizenzierungsinformationen