Calculer les volumes de déblais/remblais (Outils Image Analyst)

Résumé

Calcule les volumes de déblais et remblais entre une surface d’élévation de base et un raster d’élévation. Un raster de déblais et remblais peut également être généré. La surface d’élévation de base peut être indiquée à l’aide de différents types, tels qu’une classe d’entités contenant un ou plusieurs polygones, un ensemble de polygones, une chaîne ou un fichier JSON, ou un raster.

Utilisation

La valeur du paramètre Output Cut Fill Raster (Raster de déblais/remblais en sortie) est un jeu de données raster composé de zones décrivant les endroits où des matériaux ont été retirés (déblai) et ajoutés (remblai). Cliquez sur le jeu de données raster de déblais/remblais en sortie pour afficher les informations de déblais et de remblais dans la fenêtre Image Information (Informations sur les images).
Dans la valeur du paramètre Output Cut Fill Raster (Raster de déblais/remblais en sortie), les valeurs de volume pour les zones de déblai sont positives tandis qu’elles sont négatives pour les zones de remblai. Par exemple, une valeur de pixel de -0,000305 correspond à un remblai en mètres cubes.
Lorsque la valeur du paramètre Base Surface (Surface de base) en entrée est exprimée en polygones, les options du paramètre Base Surface Type (Type de surface de base) activées sont Surface, Minimum, Maximum, Mean (Moyenne), Constant Z (Constante Z) et Geometry Z (Valeur Z des géométries).

La valeur du paramètre Output Volume Info (Informations de volume en sortie) contient les informations de volume de déblais et remblais dans un fichier .txt ou .json. Vous trouverez un exemple de sortie ci-dessous.

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


Les informations du fichier sont organisées comme suit :

- `area`—Surface en mètres carrés

- `cut`—Volume de déblais en mètres cubes

- `fill`—Volume de remblais en mètres cubes

- `cutCellCount`—Nombre de cellules de déblai

- `fillCellCount`—Nombre de cellules de remblai

- `minz`—Valeur d’élévation minimale en mètres

- `maxz`—Valeur d’élévation maximale en mètres

- `meanz`—Valeur d’élévation moyenne en mètres

Etiqueter	Explication	Type de données
MNS en entrée	Raster d’élévation du modèle numérique de surface (MNS). Ce raster MNS en entrée est comparé au raster d’élévation de base.	Raster Dataset; Mosaic Dataset; Mosaic Layer; Raster Layer; Image Service
Surface de base	Surface d’élévation de base qui est utilisée pour calculer les volumes de déblais et remblais. La surface d’élévation de base prend en charge différents types, tels qu’une classe d’entités contenant un ou plusieurs polygones, un ensemble de polygones, une chaîne ou un fichier JSON, ou un raster.	Raster Dataset; Mosaic Dataset; Mosaic Layer; Raster Layer; Image Service; Feature Class; Feature Layer; String; File
Type de surface de base	Indique le type de surface de base qui est utilisé pour la surface de base. Surface—Les valeurs de hauteur du MNS en entrée à l’emplacement du sommet du polygone sont utilisées pour construire la surface de base. Minimum—La valeur de hauteur minimale du MNS en entrée pour le périmètre du polygone de surface de base est utilisée comme surface de base. Maximum—La valeur de hauteur maximale du MNS en entrée pour le périmètre du polygone de surface de base est utilisée comme surface de base. Moyenne—La valeur de hauteur moyenne du MNS en entrée pour le périmètre du polygone de surface de base est utilisée comme surface de base. Constante Z—La valeur z constante est utilisée comme surface de base. Valeur Z des géométries—La valeur z des sommets de géométrie 3D est utilisée pour construire la surface de base. Si cette option est utilisée avec une classe d’entités sans élévation, la valeur de hauteur du paramètre Input DSM (MNS en entrée) est utilisée. MNS—Un MNS est alors utilisé comme surface de base.	String
Constante Z (Facultatif)	Valeur utilisée pour définir l’élévation du plan afin d’effectuer le calcul du volume. Ce paramètre est actif lorsque le paramètre Base Surface Type (Type de surface de base) est défini sur Constant Z (Constante Z).	Linear Unit
Informations de volume en sortie (Facultatif)	Fichier en sortie qui contient les informations de volume de déblais et remblais. Il peut s’agir d’un fichier `.txt` ou `.json`. Les résultats sont exprimés en mètres carrés pour les calculs de superficie et en mètres cubes pour les calculs de volume.	File
Raster de déblais/remblais en sortie (Facultatif)	Raster de volume de déblais et remblais en sortie. Spécifiez une extension de fichier pour indiquer les différents formats pour le jeu de données raster. Le paramètre prend en charge les types de raster couramment utilisés, comme `.tif`, `.crf`, `.img`, GRID et le raster de géodatabase fichier.	Raster Dataset

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

Nom	Explication	Type de données
in_raster	Raster d’élévation du modèle numérique de surface (MNS). Ce raster MNS en entrée est comparé au raster d’élévation de base.	Raster Dataset; Mosaic Dataset; Mosaic Layer; Raster Layer; Image Service
in_base_surface	Surface d’élévation de base qui est utilisée pour calculer les volumes de déblais et remblais. La surface d’élévation de base prend en charge différents types, tels qu’une classe d’entités contenant un ou plusieurs polygones, un ensemble de polygones, une chaîne ou un fichier JSON, ou un raster.	Raster Dataset; Mosaic Dataset; Mosaic Layer; Raster Layer; Image Service; Feature Class; Feature Layer; String; File
base_surface_type	Indique le type de surface de base qui est utilisé pour la surface de base. `SURFACE`—Les valeurs de hauteur du MNS en entrée à l’emplacement du sommet du polygone sont utilisées pour construire la surface de base. `MINIMUM`—La valeur de hauteur minimale du MNS en entrée pour le périmètre du polygone de surface de base est utilisée comme surface de base. `MAXIMUM`—La valeur de hauteur maximale du MNS en entrée pour le périmètre du polygone de surface de base est utilisée comme surface de base. `MEAN`—La valeur de hauteur moyenne du MNS en entrée pour le périmètre du polygone de surface de base est utilisée comme surface de base. `CONSTANTZ`—La valeur z constante est utilisée comme surface de base. `GEOMETRYZ`—La valeur z des sommets de géométrie 3D est utilisée pour construire la surface de base. Si cette option est utilisée avec une classe d’entités sans élévation, la valeur de hauteur du paramètre `in_raster` est utilisée. `DSM`—Un MNS est alors utilisé comme surface de base.	String
constant_z (Facultatif)	Valeur utilisée pour définir l’élévation du plan afin d’effectuer le calcul du volume. Ce paramètre est activé lorsque le paramètre `base_surface_type` est défini sur `CONSTANTZ`.	Linear Unit
out_volume_info (Facultatif)	Fichier en sortie qui contient les informations de volume de déblais et remblais. Il peut s’agir d’un fichier `.txt` ou `.json`. Les résultats sont exprimés en mètres carrés pour les calculs de superficie et en mètres cubes pour les calculs de volume.	File
out_cut_fill_raster (Facultatif)	Raster de volume de déblais et remblais en sortie. Spécifiez une extension de fichier pour indiquer les différents formats pour le jeu de données raster. Le paramètre prend en charge les types de raster couramment utilisés, comme `.tif`, `.crf`, `.img`, GRID et le raster de géodatabase fichier.	Raster Dataset

Exemple de code

Exemple 1 d’utilisation de la fonction CalculateCutfillVolume (fenêtre Python)

Cet exemple calcule les informations de volume en utilisant une chaîne JSON d’ensemble de polygones en tant que surface de base.

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

Exemple 2 d’utilisation de la fonction CalculateCutfillVolume (script autonome)

Cet exemple calcule le volume en utilisant une classe d’entités surfaciques en tant que surface de base.

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

Environnements

Cet outil n’utilise pas d’environnement de géotraitement.

Informations de licence