Étiquette | 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 nouveaux résultats sont ajoutés au fichier. | File |
Plan de référence (Facultatif) | Direction à partir du plan de référence pour laquelle calculer les résultats.
| 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. Cette option permet généralement de convertir les unités linéaires z afin d’apparier les unités linéaires x,y. La valeur par défaut est 1, qui laisse les valeurs d'altitude 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 dont l’unité linéaire est 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 |
Synthèse
Calcule la superficie et le volume de la région entre une surface et un plan de référence.
Illustration
Utilisation
Appliquez un 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 XY. L’utilisation d’un 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 XY 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.
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
Si la région pour laquelle les calculs volumétriques et de superficie de la surface sont souhaités est définie par une étendue non rectangulaire, créez un polygone afin de délimiter la zone d’intérêt, puis utilisez l’outil Volume du polygone afin d’effectuer les calculs pour la région située entre le plan défini par le polygone et une surface donnée.
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.
Paramètres
arcpy.ddd.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 nouveaux résultats sont ajoutés au fichier. | File |
reference_plane (Facultatif) | Direction à partir du plan de référence pour laquelle calculer les résultats.
| 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. Cette option permet généralement de convertir les unités linéaires z afin d’apparier les unités linéaires x,y. La valeur par défaut est 1, qui laisse les valeurs d'altitude 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 dont l’unité linéaire est 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
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)
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"
# Execute SurfaceVolume
result = arcpy.ddd.SurfaceVolume(inSurface, "", "ABOVE", "300", "1", "5")
print(result.getMessages())
Environnements
Informations de licence
- Basic: Nécessite 3D Analyst
- Standard: Nécessite 3D Analyst
- Advanced: Nécessite 3D Analyst
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?