Beschriftung | Erläuterung | Datentyp |
Eingabe-Features | Die Punkt-Features, die zum Konstruieren von Linien verwendet werden. | Feature Layer |
Ausgabe-Feature-Class | Die Line-Feature-Class, die aus den Eingabepunkten erstellt wird. | Feature Class |
Linienfeld (optional) | Das Feld, das zum Identifizieren von eindeutigen Attributwerten verwendet wird, sodass Linien-Features mithilfe von Punkten mit den gleichen Werten konstruiert werden können. Wenn kein Feld angegeben ist, werden Linien ohne Verwendung eindeutiger Attributwerte konstruiert. Dies ist die Standardeinstellung. | Field |
Sortierfeld (optional) | Das Feld, das zum Sortieren der Punktreihenfolge verwendet wird. Wenn kein Feld angegeben ist, werden zum Erstellen von Ausgabe-Linien-Features verwendete Punkte in der Reihenfolge sortiert, in der sie gefunden wurden. Dies ist die Standardeinstellung. | Field |
Linie schließen (optional) | Gibt an, ob die Ausgabe-Linien-Features geschlossen sind.
| Boolean |
Konstruktionsmethode für Linien (optional) | Gibt die Methode an, die zum Konstruieren der Linien-Features verwendet wird.
| String |
Attributquelle (optional) | Gibt an, wie die angegebenen Attribute übertragen werden.
| String |
Felder übertragen (optional) | Die Werte enthaltenden Felder, die von den Quellpunkten auf die Ausgabelinien übertragen werden. Wenn keine Felder ausgewählt sind, werden keine Attribute übertragen. Wenn für den Parameter Attributquelle der Wert Keine angegeben ist, ist dieser Parameter deaktiviert. | Field |
Zusammenfassung
Erstellt Linien-Features aus Punkten.
Abbildung
Verwendung
Linien-Features werden nur in die Ausgabe geschrieben, wenn die Linie mindestens zwei Stützpunkte enthält.
Wenn ein Feld als Wert des Parameters Linienfeld angegeben ist, werden Linien-Features erstellt, die nur Punkte des Einzelwerts im Feld enthalten. Das Feld ist in der Ausgabe-Feature-Class enthalten.
Wenn ein Feld als Wert des Parameters Sortierfeld angegeben ist, werden Punkte in aufsteigender Reihenfolge des Feldes sortiert.
Sie können Polygone aus Eingabepunkten erstellen, indem Sie zuerst den Parameter Linie schließen aktivieren, um geschlossene Linien-Features zu erstellen. Verwenden Sie dann die Ausgabe-Line-Feature-Class als Eingabe für das Werkzeug Feature in Polygon, um Polygon-Features zu erstellen.
Der Parameter Konstruktionsmethode für Linien gibt an, wie Linien-Features konstruiert werden. Linien-Features können durch kontinuierliches Verbinden von Punkten oder durch Verbinden von zwei in der Sortierung aufeinanderfolgenden Punkten erstellt werden. Wenn zum Beispiel die Eingabe drei Punkte mit dem Wert A für Linienfeld enthält, und vier Punkte den Wert B für Linienfeld aufweisen, ist für die Optionen das folgende Verhalten zu erwarten:
- Kontinuierliche Linie konstruieren: Es werden zwei Ausgabelinien erstellt, eine mit zwei Segmenten und eine mit drei Segmenten. Wenn der Parameter Linie schließen aktiviert ist, wird ein zusätzliches Segment hinzugefügt, das den letzten Punkt mit dem Startpunkt jedes Linien-Features verbindet, sodass eine geschlossene Linie entsteht.
- 2-Punkt-Linie konstruieren: Es werden fünf Ausgabelinien jeweils zwischen aufeinanderfolgenden Punkten mit dem gleichen Wert für Linienfeld erstellt. Wenn der Parameter Linie schließen aktiviert ist, werden zusätzliche Linien-Features hinzugefügt, die den letzten Punkt mit dem Startpunkt jedes Satzes von Eingabepunkten mit dem gleichen Wert für Linienfeld verbinden, sodass ein geschlossenes Shape entsteht.
-
Mit dem Parameter Attributquelle können Sie angeben, ob bzw. wie die Attribute der mit dem Parameter Felder übertragen angegebenen Eingabepunkte auf die Ausgabelinien übertragen werden. Der Parameter Attributquelle unterstützt die folgenden Optionen:
- Keine: Es werden keine Attribute übertragen.
- Vom Start- und Endpunkt: Die Attribute vom Start- und Endpunkt jeder Linie werden übertragen. Die Ausgabefeldnamen und Aliasnamen erhalten die Präfixe START_ und END_, zum Beispiel START_FIELD1 (START_ALIAS1),END_FIELD1 (END_ALIAS1) usw.
- Vom Startpunkt: Die Attribute vom Startpunkt jeder Linie werden übertragen.
- Vom Endpunkt: Die Attribute vom Endpunkt jeder Linie werden übertragen.
Verwenden Sie den Parameter Felder übertragen zum Identifizieren der Felder, die aus der Eingabe übertragen werden sollen. Die Feldwerte werden gemäß dem Wert des Parameters Attributquelle übertragen. Wenn für diesen Parameter der Wert Keine angegeben ist, werden keine Attribute übertragen.
Parameter
arcpy.management.PointsToLine(Input_Features, Output_Feature_Class, {Line_Field}, {Sort_Field}, {Close_Line}, {Line_Construction_Method}, {Attribute_Source}, {Transfer_Fields})
Name | Erläuterung | Datentyp |
Input_Features | Die Punkt-Features, die zum Konstruieren von Linien verwendet werden. | Feature Layer |
Output_Feature_Class | Die Line-Feature-Class, die aus den Eingabepunkten erstellt wird. | Feature Class |
Line_Field (optional) | Das Feld, das zum Identifizieren von eindeutigen Attributwerten verwendet wird, sodass Linien-Features mithilfe von Punkten mit den gleichen Werten konstruiert werden können. Wenn kein Feld angegeben ist, werden Linien ohne Verwendung eindeutiger Attributwerte konstruiert. Dies ist die Standardeinstellung. | Field |
Sort_Field (optional) | Das Feld, das zum Sortieren der Punktreihenfolge verwendet wird. Wenn kein Feld angegeben ist, werden zum Erstellen von Ausgabe-Linien-Features verwendete Punkte in der Reihenfolge sortiert, in der sie gefunden wurden. Dies ist die Standardeinstellung. | Field |
Close_Line (optional) | Gibt an, ob die Ausgabe-Linien-Features geschlossen sind.
| Boolean |
Line_Construction_Method (optional) | Gibt die Methode an, die zum Konstruieren der Linien-Features verwendet wird.
| String |
Attribute_Source (optional) | Gibt an, wie die angegebenen Attribute übertragen werden.
| String |
Transfer_Fields [Transfer_Fields,...] (optional) | Die Werte enthaltenden Felder, die von den Quellpunkten auf die Ausgabelinien übertragen werden. Wenn keine Felder ausgewählt sind, werden keine Attribute übertragen. Wenn für den Parameter Attribute_Source der Wert NONE angegeben ist, ist dieser Parameter deaktiviert. | Field |
Codebeispiel
Das folgende Skript für das Python-Fenster veranschaulicht, wie die Funktion PointsToLine im unmittelbaren Modus verwendet wird.
import arcpy
arcpy.env.workspace = "C:/data"
arcpy.management.PointsToLine("calibration_points.shp",
"C:/output/output.gdb/out_lines",
"ROUTE1", "MEASURE")
Das folgende eigenständige Skript veranschaulicht, wie die Funktion PointsToLine verwendet wird.
# Description: Convert point features into line features
# Import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = "C:/data"
# Set local variables
inFeatures = "calibration_points.shp"
outFeatures = "C:/output/output.gdb/out_lines"
lineField = "ROUTE1"
sortField = "MEASURE"
# Run PointsToLine
arcpy.management.PointsToLine(inFeatures, outFeatures, lineField, sortField)
Das folgende eigenständige Skript veranschaulicht, wie die Funktion PointsToLine verwendet wird.
# Description: Convert point features into line features
# Import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = "C:/data/points.gdb"
# Set local variables
inFeatures = "in_points"
outFeatures = "out_lines"
lineField = "lineID"
sortField = "stopID"
transFields = ["OBJECTID", "stopID"]
# Run PointsToLine
arcpy.management.PointsToLine(inFeatures, outFeatures, lineField, sortField,
"NO_CLOSE", "TWO_POINT", "BOTH_ENDS", transFields)