Punkte entlang 3D-Linien generieren (3D Analyst Tools)

Zusammenfassung

Erstellt 3D-Punkt-Features entlang von 3D-Linien mithilfe von dreidimensionalen Entfernungen.

Verwendung

Dieses Werkzeug erzeugt 3D-Punkt-Features entlang von 3D-Linien, indem es den Abstand misst, in dem die Punkte unter Verwendung dreidimensionaler Entfernungen erstellt werden sollen. Wenn die Punkte, die von der 3D-Linie abgetastet werden, anhand von zweidimensionalen Abständen entlang der X- und Y-Ebene berechnet werden müssen, verwenden Sie stattdessen das Werkzeug Punkte entlang Linien generieren.
Die Punkte können in einem festen Abstand voneinander für alle Features oder entlang von Features nach einem aus der Feature-Länge abgeleiteten Prozentsatz platziert werden. Zum Platzieren der Punkte kann auch ein Feld in der Eingabe verwendet werden. Dieses Feld kann einen festen Abstand für jedes Feature oder bestimmte Entfernungen für jedes Feature angeben.

Verwenden Sie den Parameter Punktplatzierung, um die Methode zum Platzieren der Ausgabepunkte anzugeben.
Die Attribute der Eingabe-Features werden in der Ausgabe-Feature-Class beibehalten. Ein neues Feld, ORIG_FID, wird der Ausgabe-Feature-Class hinzugefügt und auf die IDs des Eingabe-Features gesetzt.
Wenn der Parameter Felder für akkumulierten Abstand und Sequenz hinzufügen aktiviert ist, werden die folgenden Felder hinzugefügt:
- ORIG_LEN—Der akkumulierte Abstand entlang der Linie vom Startpunkt der Linie bis zum Punkt. Abstandswerte werden in den Einheiten des Raumbezugs des Wertes Eingabe-Features addiert.
- ORIG_SEQ—Die Sequenznummer für jeden Punkt in der Reihenfolge der aus jeder Eingabelinie erzeugten Punkte.

Beschriftung	Erläuterung	Datentyp
Eingabe-Features	Die 3D-Linien-Features, die zum Erstellen von Punkten verwendet werden.	Feature Layer
Ausgabe-Feature-Class	Die 3D-Punkt-Features, die auf Basis der Eingabe-Linien erstellt werden.	Feature Class
Punktplatzierung (Optional)	Gibt die Methode an, die zum Abtasten der Punkte entlang der 3D-Linien-Features verwendet wird. By Percentage—The Distance parameter value will be used to place points at fixed distances along the features. This is the default. By Distance—The Percentage parameter value will be used to place points along the features by percentage. By Distance Field—Field values from the Distance Field parameter value will be used to place points along the features.	String
Entfernung (Optional)	Das Intervall vom Anfang des Features, in dem Punkte platziert werden. Dieser Parameter ist aktiv, wenn der Parameter Punktplatzierung auf Nach Entfernung festgelegt ist.	Linear Unit
Prozentsatz (Optional)	Der Prozentsatz vom Anfang des Features, an dem Punkte platziert werden. Wenn beispielsweise der Prozentsatz 40 verwendet wird, werden Punkte bei 40 und 80 Prozent der Länge des Features platziert. Dieser Parameter ist aktiv, wenn der Parameter Punktplatzierung auf Nach Prozentsatz festgelegt ist.	Double
Endpunkte einbeziehen (Optional)	Gibt an, ob zusätzliche Punkte am Startpunkt und am Endpunkt des Features enthalten sind. Aktiviert—Additional points will be included at the start point and end point of the feature. Deaktiviert—No additional points will be included at the start point and end point of the feature. This is the default.	Boolean
Felder für akkumulierten Abstand und Sequenz hinzufügen (Optional)	Gibt an, ob die Felder für akkumulierten Abstand und Sequenz zur Ausgabe hinzugefügt werden. Aktiviert—The accumulated distance (`ORIG_LEN`) and sequence (`ORIG_SEQ`) fields will be added to the output. Distance values are added in the units of the Input Features parameter value's spatial reference. Deaktiviert—The accumulated distance and sequence fields will not be added to the output. This is the default.	Boolean
Entfernungsfeld (Optional)	Ein Feld aus den Eingabe-Features, das zum Platzieren der Ausgabepunkte verwendet werden soll. Wenn das Feld ein numerisches Feld ist, dann wird der Wert dieses Feldes zum Platzieren der Punkte in diesem Abstand verwendet. Wenn es sich um ein Feld vom Typ "Zeichenfolge" handelt, dann müssen die Feldwerte als eine durch Semikolon getrennte Zeichenfolge aus Entfernungsangaben angegeben sein. Die Punkte werden dann in diesen Abständen platziert. Feldwerte, die Null oder negativ sind, werden ignoriert. Feldwerte, die die Länge eines Features überschreiten, werden für dieses Feature ignoriert. Die Entfernungen werden in den linearen Einheiten des Raumbezugs der Eingabe gemessen. Dieser Parameter ist aktiv, wenn der Parameter Punktplatzierung auf Nach Entfernungsfeld festgelegt ist.	Field

arcpy.3d.GeneratePointsAlong3DLines(in_features, out_features, {point_placement}, {distance}, {percentage}, {include_end_points}, {add_chainage_fields}, {distance_field})

Name	Erläuterung	Datentyp
in_features	Die 3D-Linien-Features, die zum Erstellen von Punkten verwendet werden.	Feature Layer
out_features	Die 3D-Punkt-Features, die auf Basis der Eingabe-Linien erstellt werden.	Feature Class
point_placement (Optional)	Gibt die Methode an, die zum Abtasten der Punkte entlang der 3D-Linien-Features verwendet wird. `PERCENTAGE`—The `percentage` parameter value will be used to place points along the features by percentage. `DISTANCE`—The `distance` parameter value will be used to place points at fixed distances along the features. This is the default. `DISTANCE_FIELD`—Field values from the `distance_field` parameter value will be used to place points along the features.	String
distance (Optional)	Das Intervall vom Anfang des Features, in dem Punkte platziert werden. Dieser Parameter ist aktiv, wenn der Parameter `point_placement` auf `DISTANCE_FIELD` festgelegt ist.	Linear Unit
percentage (Optional)	Der Prozentsatz vom Anfang des Features, an dem Punkte platziert werden. Wenn beispielsweise der Prozentsatz 40 verwendet wird, werden Punkte bei 40 und 80 Prozent der Länge des Features platziert. Dieser Parameter ist aktiv, wenn der Parameter `point_placement` auf `PERCENTAGE` festgelegt ist.	Double
include_end_points (Optional)	Gibt an, ob zusätzliche Punkte am Startpunkt und am Endpunkt des Features enthalten sind. `END_POINTS`—Additional points will be included at the start point and end point of the feature. `NO_END_POINTS`—No additional points will be included at the start point and end point of the feature. This is the default.	Boolean
add_chainage_fields (Optional)	Gibt an, ob die Felder für akkumulierten Abstand und Sequenz zur Ausgabe hinzugefügt werden. `ADD_CHAINAGE`—The accumulated distance (`ORIG_LEN`) and sequence (`ORIG_SEQ`) fields will be added to the output. Distance values are added in the units of the `in_features` parameter value's spatial reference. `NO_CHAINAGE`—The accumulated distance and sequence fields will not be added to the output. This is the default.	Boolean
distance_field (Optional)	Ein Feld aus den Eingabe-Features, das zum Platzieren der Ausgabepunkte verwendet werden soll. Wenn das Feld ein numerisches Feld ist, dann wird der Wert dieses Feldes zum Platzieren der Punkte in diesem Abstand verwendet. Wenn es sich um ein Feld vom Typ "Zeichenfolge" handelt, dann müssen die Feldwerte als eine durch Semikolon getrennte Zeichenfolge aus Entfernungsangaben angegeben sein. Die Punkte werden dann in diesen Abständen platziert. Feldwerte, die Null oder negativ sind, werden ignoriert. Feldwerte, die die Länge eines Features überschreiten, werden für dieses Feature ignoriert. Die Entfernungen werden in den linearen Einheiten des Raumbezugs der Eingabe gemessen. Dieser Parameter ist aktiv, wenn der Parameter `point_placement` auf `DISTANCE_FIELD` festgelegt ist.	Field

Codebeispiel

GeneratePointsAlong3DLines: Beispiel (Python-Fenster)

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

import arcpy
arcpy.env.workspace = 'C:/data'
arcpy.ddd.GeneratePointsAlong3DLines("hiking_trail.shp", "evaluation_points.shp", "PERCENTAGE",
                                      percentage=5, add_chainage_fields="ADD_CHAINAGE")

Umgebungen

Aktueller Workspace, Ausgabe-Koordinatensystem, Geographische Transformationen, Ausgabe-CONFIG-Schlüsselwort, Ausgabe-M-Domäne, Ausgabe-XY-Domäne, Ausgabe-Z-Domäne, XY-Auflösung, XY-Toleranz, Z-Auflösung, Z-Toleranz, Ausdehnung

Lizenzierungsinformationen