XY in Linie (Data Management Tools)

Zusammenfassung

Erstellt eine Feature-Class mit geodätischen oder planaren Linien-Features, die basierend auf den Werten in den Feldern für die X- und Y-Anfangs- und -Endkoordinaten einer Tabelle konstruiert werden.

Verwendung

Die Ausgabelinien wurden anhand von Feldwerten konstruiert. Zu den Feldwerten gehören die folgenden:
- Die X- und Y-Koordinaten eines Startpunktes
- Die X- und Y-Koordinaten eines Endpunktes
Die Felder und deren Werte werden in die Ausgabe aufgenommen.
Bei einer geodätischen Linie stellen die X- und Y-Koordinaten Positionen auf der Erdoberfläche dar. Bei einer planaren Linie sind die Koordinaten Positionen auf der projizierten Ebene.
Eine geodätische Linie ist eine Krümmung auf der Erdoberfläche. Ein geodätisches Linien-Feature wird jedoch in der Ausgabe nicht als parametrische (echte) Kurve gespeichert, sondern als verdichtete Polylinie, die den Pfad der geodätischen Linie darstellt. Wenn die Länge einer geodätischen Linie relativ kurz ist, wird sie in der Ausgabe möglicherweise durch eine gerade Linie dargestellt. Je länger die Linie wird, desto mehr Stützpunkte werden zur Darstellung des Pfades verwendet.
Wenn es sich bei der Ausgabe um eine Feature-Class in einer Geodatabase handelt, liegen die Werte im Feld Shape_Length stets in den Einheiten des durch den Parameter Raumbezug festgelegten Ausgabekoordinatensystems vor und entsprechen den planaren Längen der Polylinien. Um eine geodätische Länge oder Entfernung zu messen, verwenden Sie das Werkzeug Messen in ArcGIS Pro, und wählen Sie vor der Messung die Option Geodätisch, Loxodrome oder Große Ellipse aus.

Beschriftung	Erläuterung	Datentyp
Eingabetabelle	Die Eingabetabelle. Dabei kann es sich um eine Text-, CSV- oder Excel-Datei, eine dBASE-Tabelle oder eine Geodatabase-Tabelle handeln.	Table View
Ausgabe-Feature-Class	Die Ausgabe-Feature-Class, die geodätische und planare Linien enthält.	Feature Class
X-Startfeld	Ein numerisches Feld in der Eingabetabelle, das die X-Koordinaten (oder Längengrade) der Startpunkte von Linien enthält, die in dem durch den Parameter Raumbezug festgelegten Ausgabekoordinatensystem positioniert werden sollen.	Field
Y-Startfeld	Ein numerisches Feld in der Eingabetabelle, das die Y-Koordinaten (oder Breitengrade) der Startpunkte von Linien enthält, die in dem durch den Parameter Raumbezug festgelegten Ausgabekoordinatensystem positioniert werden sollen.	Field
X-Endfeld	Ein numerisches Feld in der Eingabetabelle, das die X-Koordinaten (oder Längengrade) der Endpunkte von Linien enthält, die in dem durch den Parameter Raumbezug festgelegten Ausgabekoordinatensystem positioniert werden sollen.	Field
Y-Endfeld	Ein numerisches Feld in der Eingabetabelle, das die Y-Koordinaten (oder Breitengrade) der Endpunkte von Linien enthält, die in dem durch den Parameter Raumbezug festgelegten Ausgabekoordinatensystem positioniert werden sollen.	Field
Linientyp (Optional)	Gibt den Typ der Linie an, der konstruiert wird. Geodätisch—Ein Typ von geodätischer Linie, die die kürzeste Entfernung zwischen zwei beliebigen Punkten auf der Erde sehr genau wiedergibt, wird erstellt. Dies ist die Standardeinstellung. Großkreis—Ein Typ von geodätischer Linie, die den Pfad zwischen zwei beliebigen Punkten entlang der Schnittlinie zwischen der Oberfläche der Erde und einer Ebene durch den Mittelpunkt der Erde wiedergibt, wird erstellt. Wenn der Parameterwert Raumbezug ein sphäroidbasiertes Koordinatensystem ist, ist die Linie eine große Ellipse. Wenn der Parameterwert Raumbezug ein sphäroidbasiertes Koordinatensystem ist, wird die Linie nur als Großkreis bezeichnet – ein Kreis mit dem größten Radius auf der sphäroidischen Oberfläche. Loxodrome—Ein Typ von geodätischer Linie, auch als Loxodrome-Linie bezeichnet, die einen Pfad zwischen zwei beliebigen Punkten auf der Oberfläche eines Sphäroids darstellt, definiert durch einen konstanten Azimut von einem Pol, wird erstellt. Eine Loxodrome erscheint in der Mercator-Projektion als gerade Linie. Normaler Abschnitt—Ein Typ von geodätischer Linie, die den Pfad zwischen zwei beliebigen Punkten auf der Oberfläche eines Sphäroids darstellt, definiert durch den Schnittpunkt zwischen der Sphäroidoberfläche und einer Ebene, die durch die zwei Punkte verläuft und normal (senkrecht) zu der Sphäroidoberfläche am Startpunkt der beiden Punkte ist, wird erstellt. Die normale Schnittlinie von Punkt A nach Punkt B unterscheidet sich von der Schnittlinie von Punkt B nach Punkt A. Planare Linie—Es wird eine gerade Linie in der projizierten Ebene verwendet. Eine planare Linie stellt in der Regel die kürzeste Entfernung auf der Erdoberfläche nicht so genau dar wie eine geodätische Linie. Diese Option ist für geographische Koordinatensysteme nicht verfügbar.	String
ID (Optional)	Ein Feld in der Eingabetabelle. Dieses Feld und die Werte werden in die Ausgabe aufgenommen und können verwendet werden, um die Ausgabe-Features mit den Datensätzen in der Eingabetabelle zu verbinden.	Field
Raumbezug (Optional)	Der Raumbezug der Ausgabe-Feature-Class. Der Standard ist GCS_WGS_1984 oder das Eingabe-Koordinatensystem, wenn dieses nicht "Unbekannt" ist.	Spatial Reference
Attribute beibehalten (Optional)	Gibt an, ob die verbleibenden Eingabefelder der Ausgabe-Feature-Class hinzugefügt werden. Aktiviert—Die verbleibenden Eingabefelder werden der Ausgabe-Feature-Class hinzugefügt. Zudem wird das neue Feld `ORIG_FID` der Ausgabe-Feature-Class hinzugefügt, in das die ID-Werte der Eingabe-Features aufgenommen werden. Deaktiviert—Die verbleibenden Eingabefelder werden nicht der Ausgabe-Feature-Class hinzugefügt. Dies ist die Standardeinstellung.	Boolean

arcpy.management.XYToLine(in_table, out_featureclass, startx_field, starty_field, endx_field, endy_field, {line_type}, {id_field}, {spatial_reference}, {attributes})

Name	Erläuterung	Datentyp
in_table	Die Eingabetabelle. Dabei kann es sich um eine Text-, CSV- oder Excel-Datei, eine dBASE-Tabelle oder eine Geodatabase-Tabelle handeln.	Table View
out_featureclass	Die Ausgabe-Feature-Class, die geodätische und planare Linien enthält.	Feature Class
startx_field	Ein numerisches Feld in der Eingabetabelle, das die X-Koordinaten (oder Längengrade) der Startpunkte von Linien enthält, die in dem durch den Parameter `spatial_reference` festgelegten Ausgabekoordinatensystem positioniert werden sollen.	Field
starty_field	Ein numerisches Feld in der Eingabetabelle, das die Y-Koordinaten (oder Breitengrade) der Startpunkte von Linien enthält, die in dem durch den Parameter `spatial_reference` festgelegten Ausgabekoordinatensystem positioniert werden sollen.	Field
endx_field	Ein numerisches Feld in der Eingabetabelle, das die X-Koordinaten (oder Längengrade) der Endpunkte von Linien enthält, die in dem durch den Parameter `spatial_reference` festgelegten Ausgabekoordinatensystem positioniert werden sollen.	Field
endy_field	Ein numerisches Feld in der Eingabetabelle, das die Y-Koordinaten (oder Breitengrade) der Endpunkte von Linien enthält, die in dem durch den Parameter `spatial_reference` festgelegten Ausgabekoordinatensystem positioniert werden sollen.	Field
line_type (Optional)	Gibt den Typ der Linie an, der konstruiert wird. `GEODESIC`—Ein Typ von geodätischer Linie, die die kürzeste Entfernung zwischen zwei beliebigen Punkten auf der Erde sehr genau wiedergibt, wird erstellt. Dies ist die Standardeinstellung. `GREAT_CIRCLE`—Ein Typ von geodätischer Linie, die den Pfad zwischen zwei beliebigen Punkten entlang der Schnittlinie zwischen der Oberfläche der Erde und einer Ebene durch den Mittelpunkt der Erde wiedergibt, wird erstellt. Wenn der Parameterwert Raumbezug ein sphäroidbasiertes Koordinatensystem ist, ist die Linie eine große Ellipse. Wenn der Parameterwert Raumbezug ein sphäroidbasiertes Koordinatensystem ist, wird die Linie nur als Großkreis bezeichnet – ein Kreis mit dem größten Radius auf der sphäroidischen Oberfläche. `RHUMB_LINE`—Ein Typ von geodätischer Linie, auch als Loxodrome-Linie bezeichnet, die einen Pfad zwischen zwei beliebigen Punkten auf der Oberfläche eines Sphäroids darstellt, definiert durch einen konstanten Azimut von einem Pol, wird erstellt. Eine Loxodrome erscheint in der Mercator-Projektion als gerade Linie. `NORMAL_SECTION`—Ein Typ von geodätischer Linie, die den Pfad zwischen zwei beliebigen Punkten auf der Oberfläche eines Sphäroids darstellt, definiert durch den Schnittpunkt zwischen der Sphäroidoberfläche und einer Ebene, die durch die zwei Punkte verläuft und normal (senkrecht) zu der Sphäroidoberfläche am Startpunkt der beiden Punkte ist, wird erstellt. Die normale Schnittlinie von Punkt A nach Punkt B unterscheidet sich von der Schnittlinie von Punkt B nach Punkt A. `PLANAR`—Es wird eine gerade Linie in der projizierten Ebene verwendet. Eine planare Linie stellt in der Regel die kürzeste Entfernung auf der Erdoberfläche nicht so genau dar wie eine geodätische Linie. Diese Option ist für geographische Koordinatensysteme nicht verfügbar.	String
id_field (Optional)	Ein Feld in der Eingabetabelle. Dieses Feld und die Werte werden in die Ausgabe aufgenommen und können verwendet werden, um die Ausgabe-Features mit den Datensätzen in der Eingabetabelle zu verbinden.	Field
spatial_reference (Optional)	Der Raumbezug der Ausgabe-Feature-Class. Ein Raumbezug kann wie folgt angegeben werden: Als Pfad zu einer `.prj`-Datei, z. B. `C:/workspace/watershed.prj` Als Pfad zu einer Feature-Class oder einem Feature-Dataset, deren/dessen Raumbezug Sie übernehmen möchten, z. B. `C:/workspace/myproject.gdb/landuse/grassland`. Als `SpatialReference`-Objekt, z. B. `arcpy.SpatialReference("C:/data/Africa/Carthage.prj")`	Spatial Reference
attributes (Optional)	Gibt an, ob die verbleibenden Eingabefelder der Ausgabe-Feature-Class hinzugefügt werden. `ATTRIBUTES`—Die verbleibenden Eingabefelder werden der Ausgabe-Feature-Class hinzugefügt. Zudem wird das neue Feld `ORIG_FID` der Ausgabe-Feature-Class hinzugefügt, in das die ID-Werte der Eingabe-Features aufgenommen werden. `NO_ATTRIBUTES`—Die verbleibenden Eingabefelder werden nicht der Ausgabe-Feature-Class hinzugefügt. Dies ist die Standardeinstellung.	Boolean

Codebeispiel

XYToLine: Beispiel (eigenständiges Skript)

In diesem Beispiel wird eine DBF-Tabelle in geodätische 2-Punkt-Linien konvertiert.

# Import system modules
import arcpy

# Set local variables
input_table = r"c:\workspace\city2city.dbf"
out_lines = r"c:\workspace\flt4421.gdb\routing001"

# XY To Line
arcpy.management.XYToLine(input_table, out_lines, "LOND1", "LATD1", "LOND2",
                          "LATD2", "GEODESIC", "idnum")

Umgebungen

Aktueller Workspace, Scratch-Workspace

Lizenzierungsinformationen