Calculer les volumes de déblais/remblais (Image Analyst)—ArcGIS Pro

Disponible avec une licence Image Analyst.

Synthèse

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 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 remblais et déblais dans la fenêtre Informations sur les images.
Dans la valeur du paramètre Raster de déblais/remblais en sortie, les valeurs de volume pour les zones de déblai sont positives tandis que les zones de remblai ont des valeurs négatives. Par exemple, une valeur de pixel de -0,000305 correspond à un remblai en mètres cubes.
Lorsque la valeur du paramètre Surface de base en entrée est exprimée en polygones, les options de paramètre Type de surface de base activées sont Surface, Minimum, Maximum, Moyenne, Constante Z et Géométrie Z.
La valeur du paramètre 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.
```
[
  {
    "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

Paramètres

Étiquette	Explication	Type de données
MNS en entrée	Raster d’élévation du modèle numérique de surface (MNS) en entrée. 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. Géométrie Z—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 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 Type de surface de base est défini sur 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) en entrée. 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 l’outil 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 *

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

Exemple 2 d’utilisation de l’outil 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 *

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

Environnements

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

Informations de licence

Basic: Nécessite Image Analyst
Standard: Nécessite Image Analyst
Advanced: Nécessite Image Analyst

Rubriques connexes

Vous avez un commentaire à formuler concernant cette rubrique ?