Punkte entlang Linien generieren (Data Management)

Zusammenfassung

Erstellt Punkt-Features entlang von Linien oder Polygonen in festen Abständen oder nach einem aus der Feature-Länge abgeleiteten Prozentsatz.

Verwendung

  • 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.

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Features

Die Linien- oder Polygon-Features, die in Punkte konvertiert werden sollen.

Feature Layer
Ausgabe-Feature-Class

Die Punkt-Feature-Class, die aus den Eingabe-Features erstellt wird.

Feature Class
Punktplatzierung

Gibt die zur Erstellung von Punkten verwendete Methode an.

  • Nach ProzentsatzAnhand des Parameterwertes für Prozentsatz werden Punkte entlang der Features nach Prozentsatz platziert.
  • Nach AbstandAnhand des Parameterwertes für Abstand werden Punkte in festen Abständen entlang der Features platziert. Dies ist die Standardeinstellung.
String
Abstand
(optional)

Das Intervall vom Anfang des Features, in dem Punkte platziert werden.

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.

Double
Endpunkte einbeziehen
(optional)

Gibt an, ob zusätzliche Punkte am Startpunkt und am Endpunkt des Features enthalten sind.

  • Aktiviert: Es sind zusätzliche 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 der Ausgabe hinzugefügt. Abstandswerte werden in den Einheiten des Raumbezugs des Wertes Eingabe-Features addiert.
  • Deaktiviert: Die Felder für akkumulierten Abstand oder Sequenz werden der Ausgabe nicht hinzugefügt. Dies ist die Standardeinstellung.
Boolean

arcpy.management.GeneratePointsAlongLines(Input_Features, Output_Feature_Class, Point_Placement, {Distance}, {Percentage}, {Include_End_Points}, {Add_Chainage_Fields})
NameErläuterungDatentyp
Input_Features

Die Linien- oder Polygon-Features, die in Punkte konvertiert werden sollen.

Feature Layer
Output_Feature_Class

Die Punkt-Feature-Class, die aus den Eingabe-Features erstellt wird.

Feature Class
Point_Placement

Gibt die Methode an, die zum Erstellen von Punkten verwendet wird.

  • PERCENTAGEAnhand des Parameterwertes für Percentage werden Punkte entlang der Features nach Prozentsatz platziert.
  • DISTANCEAnhand des Parameterwertes für Distance werden Punkte in festen Abständen entlang der Features platziert. Dies ist die Standardeinstellung.
String
Distance
(optional)

Das Intervall vom Anfang des Features, in dem Punkte platziert werden.

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.

Double
Include_End_Points
(optional)

Gibt an, ob zusätzliche Punkte am Startpunkt und am Endpunkt des Features enthalten sind.

  • END_POINTSEs sind zusätzlichen Punkte am Startpunkt und am Endpunkt des Features enthalten.
  • NO_END_POINTSEs 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_CHAINAGEDie Felder für akkumulierten Abstand (ORIG_LEN) und Sequenz (ORIG_SEQ) werden zur Ausgabe hinzugefügt. Abstandswerte werden in den Einheiten des Raumbezugs des Wertes Input_Features addiert.
  • NO_CHAINAGEDie Felder für akkumulierten Abstand oder Sequenz werden der Ausgabe nicht hinzugefügt. Dies ist die Standardeinstellung.
Boolean

Codebeispiel

GeneratePointsAlongLines – Beispiel 1 (Python-Fenster)

Das folgende Skript für das Python-Fenster veranschaulicht, wie die Funktion GeneratePointsAlongLines im unmittelbaren 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)
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')

Verwandte Themen