Punkte entlang Linien generieren (Data Management Tools)

Zusammenfassung

Erstellt Punkt-Features entlang von Linien oder Polygonen.

Verwendung

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 Linien- oder Polygon-Features, die zum Platzieren der Punkte verwendet werden sollen.	Feature Layer
Ausgabe-Feature-Class	Die Point-Feature-Class, die aus den Eingabe-Features erstellt wird.	Feature Class
Punktplatzierung	Gibt die Methode an, die zum Platzieren der Punkte verwendet werden soll. Nach Prozentsatz—Anhand des Parameterwertes für Prozentsatz werden Punkte entlang der Features nach Prozentsatz platziert. Nach Entfernung—Anhand des Parameterwertes für Abstand werden Punkte in festen Abständen entlang der Features platziert. Dies ist die Standardeinstellung. Nach Entfernungsfeld—Zum Platzieren der Punkte entlang der Features werden Feldwerte aus dem Wert des Parameters Entfernungsfeld verwendet.	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—Es sind zusätzlichen Punkte am Startpunkt und am Endpunkt des Features enthalten. Deaktiviert—Es sind keine zusätzlichen Punkte am Startpunkt und am Endpunkt des Features enthalten. Dies ist die Standardeinstellung.	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—Die Felder für akkumulierten Abstand (`ORIG_LEN`) und Sequenz (`ORIG_SEQ`) werden zur Ausgabe hinzugefügt. Abstandswerte werden in den Einheiten des Raumbezugs des Parameterwertes Eingabe-Features addiert. Deaktiviert—Die Felder für akkumulierten Abstand und Sequenz werden der Ausgabe nicht hinzugefügt. Dies ist die Standardeinstellung.	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
Entfernungsmethode (Optional)	Gibt die Messmethode an, die zum Erstellen von Punkten verwendet wird. Dieser Parameter ist aktiv, wenn der Parameter Punktplatzierung auf Nach Entfernung festgelegt ist. Planar—Punkte werden mit der Methode "Planar" erstellt. Planare Messungen beruhen auf der zweidimensionalen kartesischen Mathematik. Dies ist die Standardeinstellung. Geodätisch—Punkte werden mit der Methode "Geodätisch" erstellt. Bei geodätischen Messungen wird die Entfernung zwischen zwei Punkten auf der Erdoberfläche berechnet.	String

arcpy.management.GeneratePointsAlongLines(Input_Features, Output_Feature_Class, Point_Placement, {Distance}, {Percentage}, {Include_End_Points}, {Add_Chainage_Fields}, {Distance_Field}, {Distance_Method})

Name	Erläuterung	Datentyp
Input_Features	Die Linien- oder Polygon-Features, die zum Platzieren der Punkte verwendet werden sollen.	Feature Layer
Output_Feature_Class	Die Point-Feature-Class, die aus den Eingabe-Features erstellt wird.	Feature Class
Point_Placement	Gibt die Methode an, die zum Platzieren der Punkte verwendet werden soll. `PERCENTAGE`—Anhand des Parameterwertes für `Percentage` werden Punkte entlang der Features nach Prozentsatz platziert. `DISTANCE`—Anhand des Parameterwertes für `Distance` werden Punkte in festen Abständen entlang der Features platziert. Dies ist die Standardeinstellung. `DISTANCE_FIELD`—Zum Platzieren der Punkte werden Feldwerte aus dem Wert des Parameters `Distance_Field` verwendet.	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` 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`—Es sind zusätzlichen Punkte am Startpunkt und am Endpunkt des Features enthalten. `NO_END_POINTS`—Es sind keine zusätzlichen Punkte am Startpunkt und am Endpunkt des Features enthalten. Dies ist die Standardeinstellung.	Boolean
Add_Chainage_Fields (Optional)	Gibt an, ob die Felder für akkumulierten Abstand und Sequenz zur Ausgabe hinzugefügt werden. `ADD_CHAINAGE`—Die Felder für akkumulierten Abstand (`ORIG_LEN`) und Sequenz (`ORIG_SEQ`) werden zur Ausgabe hinzugefügt. Abstandswerte werden in den Einheiten des Raumbezugs des Parameterwertes `Input_Features` addiert. `NO_CHAINAGE`—Die Felder für akkumulierten Abstand und Sequenz werden der Ausgabe nicht hinzugefügt. Dies ist die Standardeinstellung.	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
Distance_Method (Optional)	Gibt die Messmethode an, die zum Erstellen von Punkten verwendet wird. Dieser Parameter ist aktiv, wenn der Parameter `Point_Placement` auf `DISTANCE` festgelegt ist. `PLANAR`—Punkte werden mit der Methode "Planar" erstellt. Planare Messungen beruhen auf der zweidimensionalen kartesischen Mathematik. Dies ist die Standardeinstellung. `GEODESIC`—Punkte werden mit der Methode "Geodätisch" erstellt. Bei geodätischen Messungen wird die Entfernung zwischen zwei Punkten auf der Erdoberfläche berechnet.	String

Codebeispiel

GeneratePointsAlongLines: Beispiel 1 (Python-Fenster)

Das folgende Skript für das Python-Fenster veranschaulicht, wie die Funktion GeneratePointsAlongLines im Direkt-Modus verwendet wird.

import arcpy
arcpy.env.workspace = 'C:/data/base.gdb'
arcpy.management.GeneratePointsAlongLines('rivers', 'distance_intervals', 'DISTANCE', Distance='500 meters')
arcpy.management.GeneratePointsAlongLines('rivers', 'percentage_intervals', 'PERCENTAGE', Percentage=10)
arcpy.management.GeneratePointsAlongLines('rivers', 'distance_by_field', 'DISTANCE_FIELD', Distance_Field='distance')

GeneratePointsAlongLines: Beispiel 2 (eigenständiges Skript)

Das folgende eigenständige Skript veranschaulicht, wie die Funktion GeneratePointsAlongLines verwendet wird.

# Description: Convert point features to line features

import arcpy

# Set environment settings
arcpy.env.workspace = 'C:/data/base.gdb'

# Set local variables
in_features = 'rivers'
out_fc_1 = 'distance_intervals'
out_fc_2 = 'percentage_intervals'

# Run GeneratePointsAlongLines by distance
arcpy.management.GeneratePointsAlongLines(in_features, out_fc_1, 'DISTANCE',
                                          Distance='500 meters')

# Run GeneratePointsAlongLines by percentage
arcpy.management.GeneratePointsAlongLines(in_features, out_fc_2, 'PERCENTAGE',
                                          Percentage=10,
                                          Include_End_Points='END_POINTS')

# Run GeneratePointsAlongLines by distance field
arcpy.management.GeneratePointsAlongLines(in_features, out_fc_2, 'DISTANCE_FIELD',
                                          Distance_Field='distance')

Umgebungen

Aktueller Workspace, Ausgabe-CONFIG-Schlüsselwort, Ausgabe hat M-Werte, Ausgabe hat Z-Werte

Lizenzierungsinformationen