Profil de pile (Outils 3D Analyst)

Résumé

Crée une table et un diagramme facultatif indiquant le profil d’entités linéaires sur une ou plusieurs surfaces multipatch, raster, TIN ou de MNT.

Utilisation

Chaque ligne en entrée est densifiée pour interpoler la hauteur le long des profils cible superposés. L’élévation et la distance le long des lignes en entrée résultant de cette densification sont stockées dans la table en sortie avec les informations concernant les entités linéaires et les profils cible.
Dans ArcGIS Pro 3.7, la table en sortie a été modifiée pour permettre la création d’un diagramme linéaire spécialisé représentant le profil. Actuellement, ce diagramme linéaire ne peut être créé qu’en exécutant cet outil. La table contient les champs suivants qui servent à créer un diagramme linéaire :
- DISTANCE—Distance à partir du début de la position profilée.
- Z—Hauteur du sommet.
- LINE_ID—ID unique de l’entité linéaire utilisée pour définir le profil.
- SRC_NAME—Nom de la source hauteurs.
- LINE_TARG—Identifiant regroupant les données dans le diagramme.
La table héritée en sortie peut également être générée pour créer l’ancien format de table. Bien que cette table ne puisse pas être utilisée pour créer un diagramme linéaire dans ArcGIS Pro, elle peut prendre en charge des processus conçus autour de sa structure. La table héritée contient les champs suivants :
- FIRST_DIST—Distance jusqu’au premier sommet du segment de profil.
- FIRST_Z—Hauteur du premier sommet du segment de profil.
- SEC_DIST—Distance du deuxième sommet du segment de profil.
- SEC_Z—Hauteur du deuxième sommet du segment de profil.
- LINE_ID—ID unique de l’entité linéaire utilisée pour définir le profil.
- SRC_TYPE—Type de données de la source du profil qui représente une surface ou un multipatch.
- SRC_ID—ID unique des entités multipatch profilées. Non applicable aux entrées de surface.
- SRC_NAME—Nom et chemin d’accès à la source du profil.
Le diagramme de profil peut être créé en spécifiant un nom de diagramme en sortie. Ce diagramme apparaît sous la table dans la fenêtre Contents (Contenu) lors du chargement de la table dans une carte ou une scène, mais il ne sera pas créé si plus de 100 séries de lignes sont générées.
Lorsqu’une entité multipatch est profilée, chaque segment profilé possède une ligne pour la position des sommets à chaque extrémité du segment et une autre ligne avec NULL comme valeur Z pour indiquer la présence d’un espace entre les segments.

Etiqueter	Explication	Type de données
Entités linéaires en entrée	Entités linéaires qui seront profilées sur les entrées de la surface.	Feature Layer
Profils cible	Données profilées qui peuvent être composées d’une combinaison d’entités multipatch et de modèles de surface, raster et triangulés.	Feature Layer; LAS Dataset Layer; Mosaic Layer; Raster Layer; Terrain Layer; TIN Layer
Table en sortie	Table en sortie qui stocke la hauteur interpolée pour chaque profil cible intersectant la ligne en entrée.	Table
Nom du diagramme en sortie (Facultatif)	Titre du diagramme linéaire en sortie qui sera créé. Vous devez affecter un nom pour générer le diagramme.	Graph
Granularité multipatch (Facultatif)	Indique comment les séries de lignes représentant les entités multipatch seront définies dans le diagramme en sortie. Ce paramètre est disponible uniquement lorsqu’au moins une classe d’entités multipatch est fournie comme cible de profil. Feature Class—All the features in a multipatch feature class will be represented by one line series. This reduces the number of line series created in the chart and is a suitable option when one symbol is acceptable for all features. This is the default. Feature—Each feature in a given feature class will be represented by a unique line series. This provides the flexibility of symbolizing each feature with a different color in the output chart.	String
Table héritée en sortie (Facultatif)	Table facultative qui fournit les informations de hauteur profilées avec les champs utilisés avant ArcGIS Pro 3.7.	Table

arcpy.3d.StackProfile(in_line_features, profile_targets, out_table, {out_graph}, {multipatch_granularity}, {out_legacy_table})

Nom	Explication	Type de données
in_line_features	Entités linéaires qui seront profilées sur les entrées de la surface.	Feature Layer
profile_targets [profile_targets,...]	Données profilées qui peuvent être composées d’une combinaison d’entités multipatch et de modèles de surface, raster et triangulés.	Feature Layer; LAS Dataset Layer; Mosaic Layer; Raster Layer; Terrain Layer; TIN Layer
out_table	Table en sortie qui stocke la hauteur interpolée pour chaque profil cible intersectant la ligne en entrée.	Table
out_graph (Facultatif)	Titre du diagramme linéaire en sortie qui sera créé. Vous devez affecter un nom pour générer le diagramme.	Graph
multipatch_granularity (Facultatif)	Indique comment les séries de lignes représentant les entités multipatch seront définies dans le diagramme en sortie. Ce paramètre est disponible uniquement lorsqu’au moins une classe d’entités multipatch est fournie comme cible de profil. `FEATURE_CLASS`—All the features in a multipatch feature class will be represented by one line series. This reduces the number of line series created in the chart and is a suitable option when one symbol is acceptable for all features. This is the default. `FEATURE`—Each feature in a given feature class will be represented by a unique line series. This provides the flexibility of symbolizing each feature with a different color in the output chart.	String
out_legacy_table (Facultatif)	Table facultative qui fournit les informations de hauteur profilées avec les champs utilisés avant ArcGIS Pro 3.7.	Table

Exemple de code

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

L’exemple suivant illustre l’utilisation de cet outil dans la fenêtre Python :

arcpy.env.workspace = 'C:/data'
arcpy.ddd.StackProfile('profile_line.shp', profile_targets=['dem.tif', 'buildings.shp'],
                      out_table='profile_values.dbf')

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

L’exemple suivant illustre l’utilisation de cet outil dans un script Python autonome :

'''**********************************************************************
Name: Save Profiles to Graph Files
Description: Creates profile graphs of multipatch and surface features,
             which are then saved as graph files.
**********************************************************************'''
# Import system modules
import arcpy

# Set Local Variables
profileLine = arcpy.GetParameterAsText(0)
profileTargets = arcpy.GetParameterAsText(1) # input las files
profileTable = arcpy.CreateUniqueName('profile_table', 'in_memory')
graphName = "Sample Graph"
outGraph = arcpy.GetParameterAsText(2) # output graph file

# Run StackProfile
arcpy.ddd.StackProfile(profileLine, profileTargets, profileTable, graphName)

# Run SaveGraph
arcpy.management.SaveGraph(graphName, outGraph)

Environnements

Espace de travail courant, Étendue

Informations de licence