Résumé
Calculez le déplacement entre deux surfaces pour déterminer si l'une d'entre elle est au-dessus, au-dessous ou identique à l'autre surface.
Pour en savoir plus sur le fonctionnement de l'outil Différence de surface
Utilisation
- La sortie représente uniquement les portions superposées des surfaces en entrée.
- Vous pouvez générer un raster en sortie ou un TIN pour évaluer la différence Z entre la surface en entrée et celle de référence.
- Il est préférable que les systèmes de coordonnée horizontaux et verticaux des surfaces en entrée soient les mêmes.
La classe d'entités en sortie comportera des entités surfaciques qui sépareront les régions de la surface en entrée selon qu'elles se trouvent au-dessus, au-dessous ou qu'elles sont identiques au plan de référence. La table attributaire de l'entité présente les champs suivants :
- Volume : volume d'espace entre l'entrée et la surface de référence liée par le polygone. Le volume sera toujours équivalent à 0 pour les zones où les deux surfaces sont identiques.
- SArea : zone surfacique de la surface en entrée liée par le polygone.
- Code : valeur numérique qui décrit la relation spatiale de la surface avec le plan de référence. -1 indique que la surface se trouve sous le plan de référence, 0 indique que la surface est identique au plan de référence et 1 indique que la surface se trouve au-dessus du plan de référence.
Syntaxe
SurfaceDifference_3d (in_surface, in_reference_surface, out_feature_class, {pyramid_level_resolution}, {reference_pyramid_level_resolution}, {out_raster}, {raster_cell_size}, {out_tin_folder}, {out_tin_basename})| Paramètre | Explication | Type de données |
in_surface | MNT ou surface TIN dont le déplacement relatif est évalué à partir de la surface de référence. | Terrain Layer; TIN Layer |
in_reference_surface | MNT ou surface TIN qui seront utilisés en tant que ligne de base pour déterminer le déplacement relatif de la surface en entrée. | Terrain Layer; TIN Layer |
out_feature_class | Classe d'entités en sortie qui contient des triangles contigus et des parties de triangle de même classification, regroupés dans des polygones. Le volume englobé par chaque région de différence est répertorié dans la table attributaire. | Feature Class |
pyramid_level_resolution (Facultatif) | Niveau de pyramide de MNT qui sera utilisé pour générer la surface en entrée. La valeur par défaut est 0 (ou résolution maximale). Ce paramètre n'est utilisé qu'avec le jeu de données de MNT. | Double |
reference_pyramid_level_resolution (Facultatif) | Niveau de pyramide de MNT qui sera utilisé pour générer la surface de référence. La valeur par défaut est 0 (ou résolution maximale). Ce paramètre n'est utilisé qu'avec le jeu de données de MNT. | Double |
out_raster (Facultatif) | Surface raster en sortie dont les valeurs représentent la surface en entrée normalisée par rapport à la surface de référence. Les valeurs positives reflètent des zones où la surface en entrée est au-dessus de la surface de référence, alors que les valeurs négatives indiquent les zones où la surface en entrée est au-dessous de la surface de référence. Les valeurs du raster sont dérivées d'un TIN via l'interpolation linéaire. | Raster Dataset |
raster_cell_size (Facultatif) | La taille de la cellule du Raster en sortie. | Double |
out_tin_folder (Facultatif) | Emplacement du dossier de stockage d'une ou plusieurs surfaces TIN dont les valeurs représentent la différence entre l'entrée et la surface de référence. | Folder |
out_tin_basename (Facultatif) | Nom de base donné à chaque surface TIN en sortie. Si un jeu de données TIN ne suffit pas pour représenter les données, plusieurs TIN portant le même nom de base sont créés. | String |
Exemple de code
1er exemple d'utilisation de l'outil SurfaceDifference (fenêtre Python)
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.SurfaceDifference_3d("sample.gdb/featuredataset/terrain", "sample.gdb/featuredataset/terrain2", "surface_diff.shp")
2e exemple d'utilisation de l'outil SurfaceDifference (script autonome)
L'exemple suivant illustre l'utilisation de cet outil dans un script Python autonome.
'''****************************************************************************
Name: SurfaceDifference Example
Description: This script demonstrates how to use the
SurfaceDifference tool.
****************************************************************************'''
# Import system modules
import arcpy
from arcpy import env
# Obtain a license for the ArcGIS 3D Analyst extension
arcpy.CheckOutExtension("3D")
# Set environment settings
env.workspace = "C:/data"
# Set Local Variables
inSurface = "flood_tin"
inReference = "elev_tin"
# Ensure output name is unique
outPoly = arcpy.CreateUniqueName("difference.shp")
#Execute SurfaceDifference
arcpy.SurfaceDifference_3d(inSurface, inReference, outPoly)
del arcpy, inSurface, inReference, outPoly
Environnements
Informations de licence
- ArcGIS Desktop Basic: Requiert 3D Analyst
- ArcGIS Desktop Standard: Requiert 3D Analyst
- ArcGIS Desktop Advanced: Requiert 3D Analyst