Différence de surface (Outils 3D Analyst)

Résumé

Calculez le déplacement entre deux surfaces pour déterminer si l’une d’entre elles est au-dessus, au-dessous ou identique à l’autre surface.

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—Le 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—La zone surfacique de la surface en entrée liée par le polygone.
- Code—Une 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.

Etiqueter	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ésolution d’analyse de référence (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 les 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 en utilisant 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—The LAS point whose value is closest to the mean of all LAS points in the analysis window will be used. This is the default. Minimum—The LAS point with the smallest z-value among all the LAS points in the analysis window. Maximum—The LAS point with the highest z-value among all the LAS points in the analysis window.	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—The LAS point whose value is closest to the mean of all LAS points in the analysis window will be used. This is the default. Minimum—The LAS point with the smallest z-value among all the LAS points in the analysis window. Maximum—The LAS point with the highest z-value among all the LAS points in the analysis window.	String
Étendue de traitement (Facultatif)	Étendue des données qui seront évaluées. Current Display Extent (Étendue actuellement affichée) : l’étendue repose sur la carte ou scène active. Draw Extent (Dessiner l’étendue) : l’étendue est basée sur un rectangle dessiné sur la carte ou dans la scène. Extent of a Layer (Étendue d’une couche) : l’étendue repose sur une couche de carte active. Choisissez une couche disponible ou utilisez l’option Étendue des données dans toutes les couches. Chaque couche de carte comporte les options suivantes : All Features (Toutes les entités) : étendue de toutes les entités. Selected Features (Entités sélectionnées) : étendue des entités sélectionnées. Visible Features (Entités visibles) : étendue des entités visibles. 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 d’intersection de toutes les entrées. Union of Inputs (Union des entrées) : l’étendue est basée sur l’étendue combinée de toutes les entrées. Clipboard (Presse-papiers) : l’étendue peut être copiée depuis et vers le Presse-papiers. Copy Extent (Copier l’étendue) : copie l’étendue et le système de coordonnées dans le Presse-papiers. Paste Extent (Coller l’étendue) : colle l’étendue et les coordonnées depuis le Presse-papiers. Si le Presse-papiers n’inclut pas de système de coordonnées, l’étendue utilise celui de la carte. Reset Extent (Réinitialiser l’étendue) : la valeur par défaut de l’étendue est rétablie. Lorsque les coordonnées sont saisies manuellement, elles doivent être des valeurs numériques incluses dans le système de coordonnées de la carte active. La carte peut utiliser des unités d’affichage différentes de celles des coordonnées saisies. Utilisez le signe moins pour les coordonnées sud et ouest.	Extent
Limite de traitement	Entité ou entités surfaciques qui définissent la surface à traiter.	Feature Layer

arcpy.3d.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 les 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 en utilisant 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`—The LAS point whose value is closest to the mean of all LAS points in the analysis window will be used. This is the default. `MIN`—The LAS point with the smallest z-value among all the LAS points in the analysis window. `MAX`—The LAS point with the highest z-value among all the LAS points in the analysis window.	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`—The LAS point whose value is closest to the mean of all LAS points in the analysis window will be used. This is the default. `MIN`—The LAS point with the smallest z-value among all the LAS points in the analysis window. `MAX`—The LAS point with the highest z-value among all the LAS points in the analysis window.	String
extent (Facultatif)	É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. `Extent` object : 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é ou entités surfaciques qui définissent la surface à traiter.	Feature Layer

Exemple de code

Exemple 1 d’utilisation de la fonction 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")

Exemple 2 d’utilisation de la fonction 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")

# Run 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, Réduire l’utilisation de la mémoire pendant l’analyse sur les MNT

Informations de licence