Surface - Volume (3D Analyst)
Récapitulatif
Calcule la surface et le volume d'une surface de jeu de données de raster, de réseau triangulé irrégulier (TIN) ou de MNT au-dessus ou au-dessous d'un plan de référence donné.
Illustration
 |
Utilisation
-
Utilisez l'outil Volume du polygone pour déterminer le volume d'une portion spécifique d'une surface de jeu de données de MNT ou TIN.
-
L'utilisation d'un Facteur Z est indispensable pour corriger les calculs de volume lorsque les unités Z de surface sont exprimées dans des unités autres que les unités au sol. L'utilisation d'un Facteur Z ne modifie pas les données d'origine.
Un raster MNT comporte des points espacés régulièrement, et pas des cellules, comme sur une image. Le calcul de surface indiqué par l'outil Surface - Volume est basé sur l'étendue des points espacés régulièrement du MNT, et non l'étendue des cellules. Comme ce calcul est basé sur des points, et non des cellules, la zone de données du raster MNT est réduit de la moitié d'une cellule par rapport à la zone de données affichée sous la forme d'une image raster.
Syntaxe
| Paramètre | Explication | Type de données |
in_surface |
Surface raster, TIN ou de jeu de données de MNT en entrée permettant de calculer la superficie et le volume. | Raster Layer; Terrain Layer; TIN Layer |
out_text_file (Facultatif) |
Fichier texte en sortie facultatif contenant les résultats. | File |
reference_plane (Facultatif) |
Déterminez s'il convient de calculer au-dessus ou en dessous d'une hauteur donnée.
| String |
base_z (Facultatif) |
Altitude du plan servant à calculer la surface et le volume. | Double |
z_factor (Facultatif) |
Facteur par lequel les hauteurs de la surface en entrée sont multipliées pour calculer le volume de surface ; il sert à convertir les unités Z afin d'apparier les unités XY. | Double |
pyramid_level_resolution (Facultatif) |
Résolution du niveau de pyramide du jeu de données de MNT à utiliser pour le géotraitement. La valeur par défaut est 0 (ou résolution maximale). | Double |
Exemple de code
L'exemple suivant illustre l'utilisation de cet outil dans la fenêtre Python :
import arcpy
from arcpy import env
arcpy.CheckOutExtension("3D")
env.workspace = "C:/data"
arcpy.SurfaceVolume_3d("sample.gdb/featuredataset/terrain", "surf_vol.txt",
"ABOVE", 300, 1, 5)
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
from arcpy import env
import exceptions, sys, traceback
try:
# Obtain a license for the ArcGIS 3D Analyst extension
arcpy.CheckOutExtension("3D")
# Set environment settings
env.workspace = "C:/data"
# Set Local Variables
inSurface = "elevation_tin"
#Execute SurfaceVolume
result = arcpy.SurfaceVolume_3d(inSurface, "", "ABOVE", "300", "1", "5")
print result.GetMessage(0)
except arcpy.ExecuteError:
print arcpy.GetMessages()
except:
# Get the traceback object
tb = sys.exc_info()[2]
tbinfo = traceback.format_tb(tb)[0]
# Concatenate error information into message string
pymsg = 'PYTHON ERRORS:\nTraceback info:\n{0}\nError Info:\n{1}'\
.format(tbinfo, str(sys.exc_info()[1]))
msgs = 'ArcPy ERRORS:\n {0}\n'.format(arcpy.GetMessages(2))
# Return python error messages for script tool or Python Window
arcpy.AddError(pymsg)
arcpy.AddError(msgs)