Surface - Volume (Outils 3D Analyst)

Résumé

Calcule la superficie et le volume de la région entre une surface et un plan de référence.

Illustration

Illustration de l’outil Surface - Volume

Utilisation

Utilisez le paramètre Z Factor (Facteur Z) pour garantir la précision des calculs de volume lorsque les valeurs z de la surface sont exprimées dans une unité de mesure différente des unités x,y. Le paramètre Z Factor (Facteur Z) ne modifie pas les données d’origine. L’outil détermine automatiquement le facteur Z qui convient lorsque les systèmes de coordonnées x,y et z sont définis.

Le fichier texte en sortie va stocker le chemin d’accès complet à la surface, les paramètres utilisés pour générer les résultats et les mesures de superficie et de volume calculées. Si le même fichier en sortie est désigné pour différentes exécutions de l’outil, les enregistrements existants sont conservés et les résultats sont ajoutés à la table, conformément à l’exemple suivant :


Jeu de données	Hauteur du plan	Référence	Facteur Z	Surface 2D	Surface 3D	Volume
C:\data\tin	100,00	Au-dessus	1	15984467,82	16354331,40	1886012931,05
C:\data\raster.tif	250,5	En dessous	3.28084	0	0	0
C:\data.gdb\fd\terrain	1250	Au-dessus	0.3048	1854238,36	1970550,88	1099221466,89

Lorsque la région pour les calculs est une étendue non rectangulaire, utilisez un polygone pour la définir. Ensuite, utilisez l’outil Volume du polygone pour déterminer les calculs.
Une surface raster est évaluée à l’aide de l’étendue du point central de chaque cellule, et non de l’étendue de toute la superficie des cellules. L’analyse obtenue réduit la zone de données du raster de la moitié d’une cellule par rapport à la zone de données affichée pour le raster.

Etiqueter	Explication	Type de données
Surface en entrée	Surface raster, TIN ou de MNT à traiter.	Mosaic Layer; Raster Layer; Terrain Layer; TIN Layer
Fichier texte en sortie (Facultatif)	Fichier texte ASCII délimité par des virgules, contenant les calculs de superficie et de volume. Si le fichier existe déjà, les résultats sont ajoutés au fichier.	File
Plan de référence (Facultatif)	Indique la direction à partir du plan de référence à utiliser pour calculer les résultats. Above the Plane—Volume and area calculations will represent the region of space between the specified plane height and the portions of the surface that are above the plane. This is the default. Below the Plane—Volume and area calculations will represent the region of space between the specified plane height and the portions of the surface that are below the plane.	String
Hauteur du plan (Facultatif)	Valeur z du plan servant à calculer la superficie et le volume.	Double
Facteur Z (Facultatif)	Facteur par lequel les valeurs z sont multipliées. Il permet généralement de convertir des unités linéaires z afin de les apparier aux unités linéaires x,y. La valeur par défaut est 1 et laisse les valeurs d’élévation inchangées. Ce paramètre n’est pas disponible si la référence spatiale de la surface en entrée possède un datum z avec une unité linéaire spécifiée.	Double
Résolution des niveaux de pyramide (Facultatif)	Résolution de taille de fenêtre ou de tolérance z du niveau de pyramide de MNT qui sera utilisée. La valeur par défaut est 0 (ou résolution maximale).	Double

arcpy.3d.SurfaceVolume(in_surface, {out_text_file}, {reference_plane}, {base_z}, {z_factor}, {pyramid_level_resolution})

Nom	Explication	Type de données
in_surface	Surface raster, TIN ou de MNT à traiter.	Mosaic Layer; Raster Layer; Terrain Layer; TIN Layer
out_text_file (Facultatif)	Fichier texte ASCII délimité par des virgules, contenant les calculs de superficie et de volume. Si le fichier existe déjà, les résultats sont ajoutés au fichier.	File
reference_plane (Facultatif)	Indique la direction à partir du plan de référence à utiliser pour calculer les résultats. `ABOVE`—Volume and area calculations will represent the region of space between the specified plane height and the portions of the surface that are above the plane. This is the default. `BELOW`—Volume and area calculations will represent the region of space between the specified plane height and the portions of the surface that are below the plane.	String
base_z (Facultatif)	Valeur z du plan servant à calculer la superficie et le volume.	Double
z_factor (Facultatif)	Facteur par lequel les valeurs z sont multipliées. Il permet généralement de convertir des unités linéaires z afin de les apparier aux unités linéaires x,y. La valeur par défaut est 1 et laisse les valeurs d’élévation inchangées. Ce paramètre n’est pas disponible si la référence spatiale de la surface en entrée possède un datum z avec une unité linéaire spécifiée.	Double
pyramid_level_resolution (Facultatif)	Résolution de taille de fenêtre ou de tolérance z du niveau de pyramide de MNT qui sera utilisée. La valeur par défaut est 0 (ou résolution maximale).	Double

Exemple de code

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

L’exemple suivant illustre l’utilisation de cet outil dans la fenêtre Python :

arcpy.env.workspace = "C:/data"
arcpy.ddd.SurfaceVolume("sample.gdb/featuredataset/terrain", "surf_vol.txt",
                       reference_plane="ABOVE", base_z=300, z_factor=3.24,
                       pyramid_level_resolution=5)

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

L’exemple suivant illustre l’utilisation de cet outil dans un script Python autonome :

'''****************************************************************************
Name: Surface Volume Example
Description: This script demonstrates how to use the
             Surface Volume tool.

****************************************************************************'''
# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = "C:/data"

# Set Local Variables
inSurface = "elevation_tin"

# Run SurfaceVolume
result = arcpy.ddd.SurfaceVolume(inSurface, "", "ABOVE", "300", "1", "5")
print(result.getMessages())

Environnements

Espace de travail courant

Informations de licence

Basic: Nécessite 3D Analyst
Standard: Nécessite 3D Analyst
Advanced: Nécessite 3D Analyst