Différence de surface (3D Analyst)—ArcGIS Pro

Synthèse

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.
Il est possible de 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.

Paramètres

Étiquette	Explication	Type de données
Surface en entrée	La surface triangulée dont le déplacement relatif est évalué à partir de la surface de référence.	LAS Dataset Layer; Terrain Layer; TIN Layer
Surface de référence	La surface triangulée qui sera utilisée comme ligne de base pour déterminer le déplacement relatif de la surface en entrée.	LAS Dataset Layer; Terrain Layer; TIN Layer
Classe d’entités en sortie	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
Résolution d’analyse (Facultatif)	La résolution qui sera utilisée pour générer la surface en entrée. Pour un jeu de données de MNT, ceci correspondra à ses définitions des niveaux de pyramide, où la valeur par défaut 0 représente la résolution maximale. Pour un jeu de données LAS, cette valeur représente la longueur de chaque côté du carré qui sera utilisé pour éclaircir les retours de points LAS.	Double
Référencer la résolution d’analyse (Facultatif)	La résolution qui sera utilisée pour générer la surface de référence. Pour un jeu de données de MNT, ceci correspondra à ses définitions des niveaux de pyramide, où la valeur par défaut 0 représente la résolution maximale. Pour un jeu de données LAS, cette valeur représente la longueur de chaque côté du carré qui sera utilisé pour affiner les retours de points LAS.	Double
Raster en sortie (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
Taille de cellule raster (Facultatif)	La taille de la cellule du Raster en sortie.	Double
Dossier TIN en sortie (Facultatif)	L’emplacement du dossier de stockage d'une ou plusieurs surfaces TIN dont les valeurs représentent la différence entre la surface en entrée et celle de référence.	Folder
Nom de base TIN en sortie (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
Méthode d’affinage LAS	La méthode utilisée pour sélectionner un point LAS dans chaque fenêtre d'analyse lors de l’application d’une résolution d'analyse pour affiner la surface du jeu de données LAS en entrée. Les points résultants seront utilisés pour construire une surface triangulée. La plus proche de la moyenne—Le point LAS dont la valeur est la plus proche de la moyenne de tous les points LAS dans la fenêtre d’analyse sera utilisé. Il s’agit de l’option par défaut. Minimal—Le point LAS ayant la plus petite valeur z de tous les points LAS dans la fenêtre d’analyse. Maximum—Le point LAS ayant la valeur z la plus élevée de tous les points LAS dans la fenêtre d’analyse.	String
Méthode d’affinage LAS de référence	La méthode utilisée pour sélectionner un point LAS dans chaque fenêtre d'analyse lors de l’application d’une résolution d'analyse pour affiner la surface du jeu de données LAS en entrée. Les points résultants seront utilisés pour construire une surface triangulée. La plus proche de la moyenne—Le point LAS dont la valeur est la plus proche de la moyenne de tous les points LAS dans la fenêtre d’analyse sera utilisé. Il s’agit de l’option par défaut. Minimal—Le point LAS ayant la plus petite valeur z de tous les points LAS dans la fenêtre d’analyse. Maximum—Le point LAS ayant la valeur z la plus élevée de tous les points LAS dans la fenêtre d’analyse.	String
Etendue de traitement (Facultatif)	Spécifie l’étendue des données qui seront évaluées. Default (Par défaut) : l’étendue repose sur l’étendue maximale de toutes les entrées participantes. Il s’agit de l’option par défaut. Union of Inputs (Union des entrées) : l’étendue est basée sur l’étendue maximale de toutes les entrées. Intersection of inputs (Intersection des entrées) : l’étendue est basée sur la surface minimale commune à toutes les entrées. Current Display Extent (Étendue d’affichage actuelle) : l’étendue correspond à l’affichage visible. Cette option n’est pas disponible lorsque aucune carte n’est active. As Specified Below (Comme spécifié ci-dessous) : l’étendue est basée sur les valeurs d’étendue minimale et maximale indiquées. Browse (Parcourir) : l’étendue repose sur un jeu de données existant.	Extent
Limite de traitement	Entité surfacique définissant la zone d’intérêt à traiter.	Feature Layer

arcpy.ddd.SurfaceDifference(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}, method, reference_method, {extent}, boundary)

Nom	Explication	Type de données
in_surface	La surface triangulée dont le déplacement relatif est évalué à partir de la surface de référence.	LAS Dataset Layer; Terrain Layer; TIN Layer
in_reference_surface	La surface triangulée qui sera utilisée comme ligne de base pour déterminer le déplacement relatif de la surface en entrée.	LAS Dataset Layer; 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)	La résolution qui sera utilisée pour générer la surface en entrée. Pour un jeu de données de MNT, ceci correspondra à ses définitions des niveaux de pyramide, où la valeur par défaut 0 représente la résolution maximale. Pour un jeu de données LAS, cette valeur représente la longueur de chaque côté du carré qui sera utilisé pour éclaircir les retours de points LAS.	Double
reference_pyramid_level_resolution (Facultatif)	La résolution qui sera utilisée pour générer la surface de référence. Pour un jeu de données de MNT, ceci correspondra à ses définitions des niveaux de pyramide, où la valeur par défaut 0 représente la résolution maximale. Pour un jeu de données LAS, cette valeur représente la longueur de chaque côté du carré qui sera utilisé pour affiner les retours de points LAS.	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)	L’emplacement du dossier de stockage d'une ou plusieurs surfaces TIN dont les valeurs représentent la différence entre la surface en entrée et celle 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
method	La méthode utilisée pour sélectionner un point LAS dans chaque fenêtre d'analyse lors de l’application d’une résolution d'analyse pour affiner la surface du jeu de données LAS en entrée. Les points résultants seront utilisés pour construire une surface triangulée. CLOSEST_TO_MEAN—Le point LAS dont la valeur est la plus proche de la moyenne de tous les points LAS dans la fenêtre d’analyse sera utilisé. Il s’agit de l’option par défaut. MIN—Le point LAS ayant la plus petite valeur z de tous les points LAS dans la fenêtre d’analyse. MAX—Le point LAS ayant la valeur z la plus élevée de tous les points LAS dans la fenêtre d’analyse.	String
reference_method	La méthode utilisée pour sélectionner un point LAS dans chaque fenêtre d'analyse lors de l’application d’une résolution d'analyse pour affiner la surface du jeu de données LAS en entrée. Les points résultants seront utilisés pour construire une surface triangulée. CLOSEST_TO_MEAN—Le point LAS dont la valeur est la plus proche de la moyenne de tous les points LAS dans la fenêtre d’analyse sera utilisé. Il s’agit de l’option par défaut. MIN—Le point LAS ayant la plus petite valeur z de tous les points LAS dans la fenêtre d’analyse. MAX—Le point LAS ayant la valeur z la plus élevée de tous les points LAS dans la fenêtre d’analyse.	String
extent (Facultatif)	Spécifie l’étendue des données qui seront évaluées. MAXOF : l’étendue maximale de toutes les entrées est utilisée. MINOF : l’étendue minimale de toutes les entrées est utilisée. DISPLAY : l’étendue est égale à l’affichage visible. Nom de la couche : l’étendue de la couche spécifiée est utilisée. Objet Extent : l’étendue de l’objet spécifié est utilisée. Chaîne délimitée par des espaces de coordonnées géographiques : l’étendue de la chaîne spécifiée est utilisée. Les coordonnées sont exprimées dans l’ordre x-min, y-min, x-max, y-max.	Extent
boundary	Entité surfacique définissant la zone d’intérêt à traiter.	Feature Layer

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.

arcpy.env.workspace = "C:/data"
arcpy.SurfaceDifference_3d("sample.gdb/lidar/terrain", "flood_tin", "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

# Set environment settings
arcpy.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)

Environnements

Espace de travail courant, Étendue, Système de coordonnées en sortie, Transformations géographiques, Résolution XY, Tolérance XY, Domaine XY en sortie, Mot-clé CONFIG en sortie, Validation automatique, Utilisation de la mémoire de terrain

Synthèse

Utilisation

Paramètres

Exemple de code

Environnements

Cas particuliers

Informations de licence

Rubriques connexes

Dans cette rubrique