Punkte in Linie (Data Management)

Zusammenfassung

Erstellt Linien-Features aus Punkten.

Abbildung

Abbildung des Werkzeugs "Punkte in Linie"

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

BeschriftungErläuterungDatentyp
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.

  • Aktiviert: Bei einer kontinuierlichen Linie wird ein zusätzliches Segment hinzugefügt, das den letzten Punkt mit dem ersten Punkt verbindet, sodass eine geschlossene Linie entsteht. Bei 2-Punkt-Linien wird ein zusätzliches Linien-Feature hinzugefügt, das den letzten Punkt mit dem ersten Punkt verbindet, sodass ein geschlossenes Shape entsteht.
  • Deaktiviert: Es wird kein zusätzliches Segment bzw. keine zusätzliche Linie erstellt, um eine geschlossene Linie oder ein geschlossenes Shape sicherzustellen. Dies ist die Standardeinstellung.
Boolean
Konstruktionsmethode für Linien
(optional)

Gibt die Methode an, die zum Konstruieren der Linien-Features verwendet wird.

  • Kontinuierliche Linie konstruierenLinien-Features werden erstellt, indem Punkte kontinuierlich verbunden werden. Dies ist die Standardeinstellung.
  • 2-Punkt-Linie konstruierenLinien-Features werden erstellt, indem zwei aufeinanderfolgende Punkte verbunden werden.
String
Attributquelle
(optional)

Gibt an, wie die angegebenen Attribute übertragen werden.

  • KeinEs werden keine Attribute übertragen. Dies ist die Standardeinstellung.
  • Start- und EndpunktDie Attribute vom Start- und Endpunkt der Linie werden übertragen.
  • StartpunktDie Attribute vom Startpunkt der Linie werden übertragen.
  • EndpunktDie Attribute vom Endpunkt der Linie werden übertragen.
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

arcpy.management.PointsToLine(Input_Features, Output_Feature_Class, {Line_Field}, {Sort_Field}, {Close_Line}, {Line_Construction_Method}, {Attribute_Source}, {Transfer_Fields})
NameErläuterungDatentyp
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.

  • CLOSEBei einer kontinuierlichen Linie wird ein zusätzliches Segment hinzugefügt, das den letzten Punkt mit dem ersten Punkt verbindet, sodass eine geschlossene Linie entsteht. Bei 2-Punkt-Linien wird ein zusätzliches Linien-Feature hinzugefügt, das den letzten Punkt mit dem ersten Punkt verbindet, sodass ein geschlossenes Shape entsteht.
  • NO_CLOSEEs wird kein zusätzliches Segment bzw. keine zusätzliche Linie erstellt, um eine geschlossene Linie oder ein geschlossenes Shape sicherzustellen. Dies ist die Standardeinstellung.
Boolean
Line_Construction_Method
(optional)

Gibt die Methode an, die zum Konstruieren der Linien-Features verwendet wird.

  • CONTINUOUSLinien-Features werden erstellt, indem Punkte kontinuierlich verbunden werden. Dies ist die Standardeinstellung.
  • TWO_POINTLinien-Features werden erstellt, indem zwei aufeinanderfolgende Punkte verbunden werden.
String
Attribute_Source
(optional)

Gibt an, wie die angegebenen Attribute übertragen werden.

  • NONEEs werden keine Attribute übertragen. Dies ist die Standardeinstellung.
  • BOTH_ENDSDie Attribute vom Start- und Endpunkt der Linie werden übertragen.
  • STARTDie Attribute vom Startpunkt der Linie werden übertragen.
  • ENDDie Attribute vom Endpunkt der Linie werden übertragen.
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

PointsToLine: Beispiel (Python-Fenster)

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")
PointsToLine: Beispiel 2 (eigenständiges Skript)

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)
PointsToLine: Beispiel 3 (eigenständiges Skript)

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)

Verwandte Themen