Stack-Profil (3D Analyst Tools)

Zusammenfassung

Erstellt eine Tabelle und optional ein Diagramm, wobei das Profil von Linien-Features auf einer oder mehreren Multipatch-, Raster-, TIN- oder Terrain-Oberflächen dargestellt wird.

Verwendung

Jede Eingabelinie wird verdichtet, um die Höhe entlang ihrer überlappenden Profilziele zu interpolieren. Die Höhen- und Entfernungswerte entlang der durch die Verdichtung erstellten Eingabelinien werden in der Ausgabetabelle zusammen mit Informationen über die Linien-Features und Profilziele gespeichert.
In ArcGIS Pro 3.7 wurde die Ausgabetabelle geändert, um die Erstellung eines spezialisierten Liniendiagramms zu unterstützen, das das Profil darstellt. Derzeit kann dieses Liniendiagramm nur durch das Ausführen dieses Werkzeugs erstellt werden. Die Tabelle enthält folgende Felder, die zur Erstellung eines Liniendiagramms verwendet werden:
- DISTANCE—Entfernung ab dem Beginn der Position, für die ein Profil erstellt wird.
- Z—Höhe des Stützpunktes.
- LINE_ID—Eindeutige ID des Linien-Features, das zur Definition des Profils verwendet wurde.
- SRC_NAME—Name der Höhenquelle.
- LINE_TARG—Identifikator zur Gruppierung der Daten im Diagramm.
Die Output-Legacy-Tabelle kann auch generiert werden, um die ältere Formattabelle zu erstellen. Obwohl diese Tabelle nicht zum Erstellen eines Liniendiagramms in ArcGIS Pro verwendet werden kann, kann sie Workflows unterstützen, die um ihr Schema herum gestaltet wurden. Die Legacy-Tabelle enthält die folgenden Felder:
- FIRST_DIST—Entfernung zum ersten Stützpunkt im Profilsegment.
- FIRST_Z—Höhe des ersten Stützpunkts im Profilsegment.
- SEC_DIST—Entfernung des zweiten Stützpunkts im Profilsegment.
- SEC_Z—Höhe des zweiten Stützpunkts im Profilsegment.
- LINE_ID—Eindeutige ID des Linien-Features, das zur Definition des Profils verwendet wurde.
- SRC_TYPE—Datentyp der Quelle des Profils, entweder eine Oberfläche oder ein Multipatch.
- SRC_ID—Eindeutige ID des Multipatch-Features, für das ein Profil erstellt wird. Nicht anwendbar für Oberflächen-Eingaben.
- SRC_NAME—Name und Pfad der Quelle des Profils.
Das Profildiagramm kann durch Angabe eines Namens des Ausgabediagramms erstellt werden. Dieses Diagramm wird unter der Tabelle im Bereich Inhalt angezeigt, wenn die Tabelle in eine Karte oder Szene geladen wird, wird aber nicht erstellt, wenn mehr als 100 Zeilenreihen generiert werden.
Wenn ein Profil für ein Multipatch-Feature erstellt wird, hat jedes Segment, für das ein Profil erstellt wurde, an jedem Ende des Segments eine Zeile für die Stützpunktposition und eine weitere Zeile mit NULL als Z-Wert, um das Vorhandensein einer Lücke zwischen den Segmenten anzuzeigen.

Beschriftung	Erläuterung	Datentyp
Eingabe-Linien-Features	Die Linien-Features, für die ein Profil über die Oberflächen-Eingaben erstellt wird.	Feature Layer
Profilziele	Die abgebildeten Daten, die aus einer beliebigen Kombination aus Multipatch-Features, Rastern und triangulierten Oberflächenmodellen bestehen können.	Feature Layer; LAS Dataset Layer; Mosaic Layer; Raster Layer; Terrain Layer; TIN Layer
Ausgabetabelle	Die Ausgabetabelle, in der die Höhe gespeichert wird, die für jedes Profilziel interpoliert wird, das die Eingabelinie schneidet.	Table
Name des Ausgabediagramms (Optional)	Der Titel des Ausgabe-Liniendiagramms, das erstellt wird. Ein Name muss angegeben werden, um das Diagramm zu generieren.	Graph
Multipatch-Granularität (Optional)	Gibt an, wie die Zeilenreihen, die Multipatch-Features repräsentieren, im Ausgabediagramm definiert werden. Dieser Parameter ist nur verfügbar, wenn mindestens eine Multipatch-Feature-Class als Profilziel angegeben ist. 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
Legacy-Ausgabetabelle (Optional)	Die optionale Tabelle, die die Höheninformationen mit erstelltem Profil mit den Feldern enthält, die vor ArcGIS Pro 3.7 verwendet wurden.	Table

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

Name	Erläuterung	Datentyp
in_line_features	Die Linien-Features, für die ein Profil über die Oberflächen-Eingaben erstellt wird.	Feature Layer
profile_targets [profile_targets,...]	Die abgebildeten Daten, die aus einer beliebigen Kombination aus Multipatch-Features, Rastern und triangulierten Oberflächenmodellen bestehen können.	Feature Layer; LAS Dataset Layer; Mosaic Layer; Raster Layer; Terrain Layer; TIN Layer
out_table	Die Ausgabetabelle, in der die Höhe gespeichert wird, die für jedes Profilziel interpoliert wird, das die Eingabelinie schneidet.	Table
out_graph (Optional)	Der Titel des Ausgabe-Liniendiagramms, das erstellt wird. Ein Name muss angegeben werden, um das Diagramm zu generieren.	Graph
multipatch_granularity (Optional)	Gibt an, wie die Zeilenreihen, die Multipatch-Features repräsentieren, im Ausgabediagramm definiert werden. Dieser Parameter ist nur verfügbar, wenn mindestens eine Multipatch-Feature-Class als Profilziel angegeben ist. `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 (Optional)	Die optionale Tabelle, die die Höheninformationen mit erstelltem Profil mit den Feldern enthält, die vor ArcGIS Pro 3.7 verwendet wurden.	Table

Codebeispiel

StackProfile: Beispiel 1 (Python-Fenster)

Anhand des folgenden Beispiels wird die Verwendung dieses Werkzeugs im Python-Fenster veranschaulicht:

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

StackProfile: Beispiel 2 (eigenständiges Skript)

Im folgenden Beispiel wird die Verwendung dieses Werkzeugs in einem eigenständigen Python-Skript veranschaulicht:

'''**********************************************************************
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)

Umgebungen

Aktueller Workspace, Ausdehnung

Lizenzierungsinformationen