Ajouter des informations de surface (Spatial Analyst)

Synthèse

Attribuer aux entités des informations spatiales tirées d’une surface.

Utilisation

• Les valeurs z des entités 3D sont ignorées. Chaque entité récapitule les propriétés z de surface qui intersectent sa géométrie. Les points tirent les valeurs z de la localisation x,y sur la surface, les lignes acquièrent les propriétés z en interpolant des mesures de surface sur leur longueur et les polygones récapitulent les propriétés z de surface au sein de leur surface.

• Les options du paramètre Propriété en sortie sont écrites dans la table attributaire de l’entité en entrée. Chaque entité définit la localisation des propriétés de surface évaluées et le type de propriété pouvant être renvoyé varie en fonction de la géométrie de l’entité :

  Géométrie d’entité	Propriétés de surface
  Point	Points cotés interpolés à partir des coordonnées x,y du point sur la surface
  Multi-point	Valeurs minimale, maximale et moyenne du point coté pour tous les points d’un enregistrement multi-point
  Polyligne	Distance 3D de la ligne sur la surface Valeurs minimale, maximale et moyenne de l’élévation et de la pente de la ligne sur la surface
  Polygone	Superficie 3D de la surface superposée au polygone Valeurs minimale, maximale et moyenne de l’élévation et de la pente de la surface

• Les valeurs de pente sont mesurées sous la forme de pourcentages (grade) et, pour les entités linéaires, elles sont calculées à chaque segment de la ligne.

  • La pente minimale provient du segment dont la valeur est la plus proche de 0, ou du grade horizontal.
  • La pente maximale provient du segment présentant la plus grande valeur calculée.
  • La pente moyenne d’une polyligne est obtenue à partir de la moyenne pondérée de la pente de chaque segment linéaire. La pondération est basée sur la longueur 3D de chaque segment. Les segments les plus longs ont donc une plus grande influence sur le calcul obtenu que les segments les plus courts.

• Utilisez le paramètre Filtrage du bruit pour exclure du calcul de la pente les portions de la surface caractérisées par des mesures anormales. Les entités linéaires sont segmentées par des sommets qui capturent le profil de la surface, et le fait de filtrer ces segments par longueur permet de supprimer l’influence des segments courts probablement générés par des mesures de surface indésirables. De même, le filtre de surface pour les entités surfaciques permet de ne pas prendre en compte les microtriangles des surfaces triangulées dans le calcul de la pente. Pour les surfaces raster, un sous-ensemble de centroïdes de cellules permet de créer une surface triangulée à laquelle le filtre de surface est appliqué.

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Entités en entrée	Entités ponctuelles, multi-points, polylignes ou surfaciques qui définissent les localisations permettant de déterminer une ou plusieurs propriétés de surface.	Feature Layer
Surface en entrée	Surface de jeu de données LAS, de mosaïque, raster, TIN ou de MNT utilisée pour interpoler les valeurs z.	LAS Dataset Layer; Mosaic Layer; Raster Layer; Terrain Layer; TIN Layer
Propriété en sortie	Spécifie la propriété d’élévation de surface ajoutée à la table attributaire de la classe d’entités en entrée. Z—Les valeurs z de surface interpolées pour la localisation x,y de chaque entité ponctuelle unique sont ajoutées. Z minimum—Les valeurs z de surface les plus faibles dans la zone définie par le polygone, sur la longueur d’une ligne, ou parmi les valeurs interpolées des points dans un enregistrement multi-point sont ajoutées. Z maximum—L’élévation de surface la plus importante dans la zone définie par le polygone, sur la longueur d’une ligne, ou parmi les valeurs interpolées des points dans un enregistrement multi-point est ajoutée. Z moyen—L’élévation de surface moyenne de la zone définie par le polygone, sur la longueur d’une ligne, ou parmi les valeurs interpolées des points dans un enregistrement multi-point est ajoutée. Surface - Superficie—La superficie 3D de la région définie par chaque polygone est ajoutée. Surface - Longueur—La distance 3D de la ligne sur la surface est ajoutée. Pente minimale—La valeur de pente la plus proche de zéro sur la ligne ou à l’intérieur de la zone définie par le polygone est ajoutée. Pente maximale—La valeur de pente la plus élevée sur la ligne ou à l’intérieur de la zone définie par le polygone est ajoutée. Pente moyenne—La valeur de pente moyenne sur la ligne ou à l’intérieur de la zone définie par le polygone est ajoutée.	String
Méthode (Facultatif)	Spécifie la méthode d’interpolation utilisée pour déterminer les informations sur la surface. Bilinéaire—Une méthode d’interpolation spécifique à la surface raster, qui détermine les valeurs de cellule des quatre cellules les plus proches, est utilisée. Il s’agit de la seule option disponible pour une surface raster. Linéaire—L’élévation est obtenue à partir du plan défini par le triangle qui contient la localisation x,y d’un point de requête. Il s’agit de la méthode d’interpolation par défaut pour les TIN, les MNT et les jeux de données LAS. Voisins naturels—L’élévation est obtenue par l’application de pondérations basées sur la surface aux voisins naturels d’un point de requête. Fusion de la valeur Z minimale—L’élévation est obtenue à partir de la plus petite valeur z détectée parmi les voisins naturels d’un point de requête. Fusion de la valeur Z maximale—L’élévation est obtenue à partir de la plus grande valeur z détectée parmi les voisins naturels d’un point de requête. Fusion de la valeur Z la plus proche—L’élévation est obtenue à partir de la valeur la plus proche parmi les voisins naturels d’un point de requête. Fusion de la valeur Z la plus proche de la moyenne—L’élévation est obtenue à partir de la valeur z la plus proche de la moyenne de tous les voisins naturels d’un point de requête.	String
Distance d’échantillonnage (Facultatif)	Espacement selon lequel les valeurs z sont interpolées. Par défaut, la taille de cellule raster est utilisée lorsque la surface en entrée est un raster, et la densification naturelle de la surface triangulée est utilisée lorsque l’entrée est un MNT ou un jeu de données TIN.	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
Filtrage du bruit (Facultatif)	Indique si les portions de la surface susceptibles d’être caractérisées par des mesures anormales sont exclues du calcul de la pente. Les autres propriétés ne sont pas affectées par ce paramètre. Les entités linéaires offrent un filtre de longueur, dans lequel les segments linéaires dont la longueur 3D est inférieure à la valeur spécifiée sont exclus du calcul de la pente. Les entités surfaciques offrent un filtre de surface dans lequel les polygones couvrant une superficie inférieure à la valeur spécifiée sont exclus.	String

Sortie obtenue

Étiquette	Explication	Type de données
Entités en entrée mises à jour	Entités en entrée mises à jour.	Feature Layer

Python

AddSurfaceInformation(in_feature_class, in_surface, out_property, {method}, {sample_distance}, {z_factor}, {pyramid_level_resolution}, {noise_filtering})

Nom	Explication	Type de données
in_feature_class	Entités ponctuelles, multi-points, polylignes ou surfaciques qui définissent les localisations permettant de déterminer une ou plusieurs propriétés de surface.	Feature Layer
in_surface	Surface de jeu de données LAS, de mosaïque, raster, TIN ou de MNT utilisée pour interpoler les valeurs z.	LAS Dataset Layer; Mosaic Layer; Raster Layer; Terrain Layer; TIN Layer
out_property [out_property,...]	Spécifie la propriété d’élévation de surface ajoutée à la table attributaire de la classe d’entités en entrée. Z—Les valeurs z de surface interpolées pour la localisation x,y de chaque entité ponctuelle unique sont ajoutées. Z_MIN—Les valeurs z de surface les plus faibles dans la zone définie par le polygone, sur la longueur d’une ligne, ou parmi les valeurs interpolées des points dans un enregistrement multi-point sont ajoutées. Z_MAX—L’élévation de surface la plus importante dans la zone définie par le polygone, sur la longueur d’une ligne, ou parmi les valeurs interpolées des points dans un enregistrement multi-point est ajoutée. Z_MEAN—L’élévation de surface moyenne de la zone définie par le polygone, sur la longueur d’une ligne, ou parmi les valeurs interpolées des points dans un enregistrement multi-point est ajoutée. SURFACE_AREA—La superficie 3D de la région définie par chaque polygone est ajoutée. SURFACE_LENGTH—La distance 3D de la ligne sur la surface est ajoutée. MIN_SLOPE—La valeur de pente la plus proche de zéro sur la ligne ou à l’intérieur de la zone définie par le polygone est ajoutée. MAX_SLOPE—La valeur de pente la plus élevée sur la ligne ou à l’intérieur de la zone définie par le polygone est ajoutée. AVG_SLOPE—La valeur de pente moyenne sur la ligne ou à l’intérieur de la zone définie par le polygone est ajoutée.	String
method (Facultatif)	Spécifie la méthode d’interpolation utilisée pour déterminer les informations sur la surface. BILINEAR—Une méthode d’interpolation spécifique à la surface raster, qui détermine les valeurs de cellule des quatre cellules les plus proches, est utilisée. Il s’agit de la seule option disponible pour une surface raster. LINEAR—L’élévation est obtenue à partir du plan défini par le triangle qui contient la localisation x,y d’un point de requête. Il s’agit de la méthode d’interpolation par défaut pour les TIN, les MNT et les jeux de données LAS. NATURAL_NEIGHBORS—L’élévation est obtenue par l’application de pondérations basées sur la surface aux voisins naturels d’un point de requête. CONFLATE_ZMIN—L’élévation est obtenue à partir de la plus petite valeur z détectée parmi les voisins naturels d’un point de requête. CONFLATE_ZMAX—L’élévation est obtenue à partir de la plus grande valeur z détectée parmi les voisins naturels d’un point de requête. CONFLATE_NEAREST—L’élévation est obtenue à partir de la valeur la plus proche parmi les voisins naturels d’un point de requête. CONFLATE_CLOSEST_TO_MEAN—L’élévation est obtenue à partir de la valeur z la plus proche de la moyenne de tous les voisins naturels d’un point de requête.	String
sample_distance (Facultatif)	Espacement selon lequel les valeurs z sont interpolées. Par défaut, la taille de cellule raster est utilisée lorsque la surface en entrée est un raster, et la densification naturelle de la surface triangulée est utilisée lorsque l’entrée est un MNT ou un jeu de données TIN.	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
noise_filtering (Facultatif)	Indique si les portions de la surface susceptibles d’être caractérisées par des mesures anormales sont exclues du calcul de la pente. Les autres propriétés ne sont pas affectées par ce paramètre. Les entités linéaires offrent un filtre de longueur, dans lequel les segments linéaires dont la longueur 3D est inférieure à la valeur spécifiée sont exclus du calcul de la pente. Les entités surfaciques offrent un filtre de surface dans lequel les polygones couvrant une superficie inférieure à la valeur spécifiée sont exclus.	String

Sortie obtenue

Nom	Explication	Type de données
output_feature_class	Entités en entrée mises à jour.	Feature Layer

Exemple de code

Exemple 1 d’utilisation de la fonction AddSurfaceInformation (fenêtre Python)

L'exemple suivant illustre l'utilisation de cet outil dans la fenêtre Python.

from arcpy.sa import *
AddSurfaceInformation("point.shp", "dtm_tin", "Z", "LINEAR")

Exemple 2 d’utilisation de la fonction AddSurfaceInformation (script autonome)

L'exemple suivant illustre l'utilisation de cet outil dans un script Python autonome.

# Name: AddSurfaceInformation_Ex_02.py
# Description: This script demonstrates how to use AddSurfaceInformation 
# on a 2D point feature class in a target workspace.
# Requirements: Spatial Analyst Extension

# Import system modules
import arcpy
from arcpy.sa import *

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Set the analysis environments
arcpy.env.workspace = "C:/arcpyExamples/data"

# Set the local variables
inFeatureClass = "point.shp"
inSurface = "dtm_tin"
Prop = "Z"
method = "LINEAR"
pyramid = 5

# Execute the tool
AddSurfaceInformation(inFeatureClass, inSurface, Prop, method, 15, 1, pyramid)

Environnements

Espace de travail courant, Étendue, Transformations géographiques, Validation automatique

Cas particuliers

Informations de licence

• Basic: Nécessite Spatial Analyst ou 3D Analyst
• Standard: Nécessite Spatial Analyst ou 3D Analyst
• Advanced: Nécessite Spatial Analyst ou 3D Analyst