Différence de surface (3D Analyst)

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

Boîte de dialogue

É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. 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
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. 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
Etendue de traitement (Facultatif)	Spécifie l’étendue des données qui seront évaluées. Current Display Extent (Étendue actuellement affichée)  : l’étendue repose sur la carte ou la scène active. Cette option est uniquement disponible lorsqu’une carte est active. Dessiner l’étendue  : l’étendue est basée sur un rectangle dessiné sur la carte ou dans la scène. Cette option crée une classe d’entités dans la géodatabase du projet et ajoute une couche à la carte. La classe d’entités possède le même système de coordonnées que la carte. Remarque : Cette option n’est pas disponible dans la boîte de dialogue Environnements. Elle est disponible uniquement dans un paramètre de l’outil correspondant à un type de données d’étendue ou dans l’onglet Environnements de la boîte de dialogue de l’outil. Remarque : Lorsque l’option de mise à jour Activer et désactiver la mise à jour de l’onglet Mettre à jour est activée, vous devez activer la mise à jour dans l’onglet du ruban Mettre à jour pour dessiner l’étendue. Extent of a Layer (Étendue d’une couche)  : l’étendue repose sur une couche de carte active. Utilisez la liste déroulante pour choisir une couche disponible ou utilisez l’option Extent of data in all layers (Étendue des données dans toutes les couches) pour obtenir l’étendue combinée de toutes les couches de carte actives, y compris le fond de carte. Cette option est uniquement disponible lorsqu’une carte avec des couches est active. Chaque couche de carte comporte les options suivantes : Toutes les entités  : étendue de toutes les entités dans la couche. Entités sélectionnées : étendue de toutes les entités sélectionnées dans la couche. Entités visibles  : étendue de toutes les entités visibles dans la couche. Remarque : Les étendues des options Entités sélectionnées  et Entités visibles  sont disponibles uniquement pour les couches d’entités. Browse (Parcourir)  : l’étendue repose sur un jeu de données existant. Intersection of Inputs (Intersection des entrées)  : l’étendue repose sur l’étendue minimale ou l’étendue d’intersection de toutes les entrées. S’il n’existe aucune intersection entre les entrées, il en résulte une étendue nulle avec uniquement des zéros. Union of Inputs (Union des entrées)  : l’étendue est basée sur l’étendue maximale ou combinée de toutes les entrées. Presse-papiers  : l’étendue peut être copiée depuis et vers le Presse-papiers. Copier l’étendue  : copie les coordonnées et le système de coordonnées de l’étendue dans le Presse-papiers. Coller l’étendue  : colle les coordonnées et, éventuellement, le système de coordonnées de l’étendue depuis le Presse-papiers. Si les valeurs du Presse-papiers n’incluent pas de système de coordonnées, l’étendue utilise celui de la carte. Remarque : Les coordonnées de l’étendue sont copiées vers et collées depuis le Presse-Papiers avec la même mise en forme et le même ordre que ceux de l’objet ArcPy Extent : X min, Y min, X max, Y max et la référence spatiale. Reset Extent (Réinitialiser l’étendue)  : la valeur par défaut de l’étendue est rétablie. Manually entered coordinates (Coordonnées saisies manuellement) : les coordonnées doivent être des valeurs numériques incluses dans le système de coordonnées de la carte active. Attention : La carte peut utiliser des unités d’affichage différentes de celles des coordonnées saisies. L’utilisation d’une direction cardinale (N, S, E, O) n’est pas prise en charge. Utilisez le signe moins pour les coordonnées sud et ouest.	Extent
Limite de traitement	Entité surfacique qui définira la zone d’intérêt à traiter.	Feature Layer

Python

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 commune à 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 qui définira 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.ddd.SurfaceDifference("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.ddd.SurfaceDifference(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