Abtrag/Auftrag-Volumen berechnen (Image Analyst)—ArcGIS Pro

Mit der Image Analyst-Lizenz verfügbar.

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:
```
[
  {
    "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

Parameter

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 *

# Check out the ArcGIS Image Analyst extension license
arcpy.CheckOutExtension("ImageAnalyst")
# Calculate Volume information
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 *

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

# 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"

# Execute 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.

Lizenzinformationen

Basic: Erfordert Image Analyst
Standard: Erfordert Image Analyst
Advanced: Erfordert Image Analyst