| Beschriftung | Erläuterung | Datentyp |
Eingabetabelle | Die Tabelle mit den X- und Y-Koordinaten, die die Positionen der zu erstellenden Punkt-Features angeben. | Table View |
Ausgabe-Feature-Class | Die Feature-Class, die die Ausgabe-Punkt-Features enthält. | Feature Class |
X-Feld | Das Feld in der Eingabetabelle, das die X-Koordinaten (oder den Längengrad) enthält. | Field |
Y-Feld | Das Feld in der Eingabetabelle, das die Y-Koordinaten (oder den Breitengrad) enthält. | Field |
Z-Feld (optional) | Das Feld in der Eingabetabelle, das die Z-Koordinaten enthält. | Field |
Koordinatensystem (optional) | Das Koordinatensystem der X- und Y-Koordinaten. Dies ist dann das Koordinatensystem der Ausgabe-Feature-Class. | Spatial Reference |
Zusammenfassung
Erstellt auf Grundlage von in einer Tabelle definierten X-, Y- und Z-Koordinaten eine Point-Feature-Class.
Verwendung
Attributfelder vom Parameterwert "Eingabetabelle" werden in die Ausgabe-Feature-Class übertragen.
Das im Parameter Koordinatensystem angegebene Koordinatensystem wird auf die Ausgabe angewendet. Dieses Koordinatensystem bestimmt, wie die X-, Y- und Z-Koordinaten in der Eingabetabelle interpretiert werden. Da dieses Werkzeug häufig mit Tabellen verwendet wird, die Werte für den Längen- und Breitengrad enthalten, ist das Standardkoordinatensystem das geographische Koordinatensystem WGS84. Wenn die X- und Y-Koordinaten in der Eingabetabelle projizierte Koordinaten enthalten, geben Sie das entsprechende projizierte Koordinatensystem an.
Wenn die Umgebungseinstellung Ausgabe-Koordinatensystem festgelegt wurde, wird die Ausgabe-Feature-Class über das im Parameter Koordinatensystem angegebene Koordinatensystem erneut auf dieses Koordinatensystem projiziert.
Wenn der Parameter Z-Feld angegeben wird, enthält das Standardkoordinatensystem auch das vertikale Koordinatensystem WGS84. Wenn die Z-Werte nicht in Metern angegeben werden, dann ändern Sie das Koordinatensystem, damit die richtige Höheneinheit verwendet wird.
Die X- und Y-Koordinatenwerte 0 und NULL sind gültige Eingaben und werden in die Ausgabe einbezogen. Bei Koordinaten mit dem Wert 0 werden Ausgabe-Punkt-Features an der Position 0 platziert. NULL-Koordinaten weisen eine leere Geometrie auf.
Die X- und Y-Koordinatenwerte in einem geographischen Koordinatensystem werden als ungültig angesehen, wenn sie kleiner als -400 oder größer als 400 sind. Es wird kein Ausgabedatensatz erstellt, und die Werkzeugmeldungen enthalten eine Warnmeldung, in der die ungültige Eingabe-ID angegeben ist.
Die X-, Y- und Z-Koordinatenfelder der Eingabe müssen numerische Felder sein. Als Eingabe für dieses Werkzeug dürfen nur Koordinatenwerte in den folgenden Formaten verwendet werden:
- Dezimalgrade in einem geographischen Koordinatensystem
- Lineare Messungen in einem projizierten Koordinatensystem, in denen Zahlen zum Angeben der Position mit einem X- und Y-Versatz von einer ursprünglichen Position verwendet werden
Andere Koordinatenformate oder -schreibweisen können als Eingabe für das Werkzeug Koordinatenschreibweise konvertieren verwendet werden.
Das Standardtrennzeichen für tabellarische Textdateien mit den Erweiterungen .csv und .txt ist ein Komma und für Dateien mit der Erweiterung .tab ein Tabulator (Tabstopp). Um eine Eingabetabelle mit einem nicht dem Standard entsprechenden Trennzeichen zu verwenden, müssen Sie zuerst das richtige Trennzeichen angeben, das in der Tabelle verwendet wird. Verwenden Sie dafür eine schema.ini-Datei.
Parameter
arcpy.management.XYTableToPoint(in_table, out_feature_class, x_field, y_field, {z_field}, {coordinate_system})| Name | Erläuterung | Datentyp |
in_table | Die Tabelle mit den X- und Y-Koordinaten, die die Positionen der zu erstellenden Punkt-Features angeben. | Table View |
out_feature_class | Die Feature-Class, die die Ausgabe-Punkt-Features enthält. | Feature Class |
x_field | Das Feld in der Eingabetabelle, das die X-Koordinaten (oder den Längengrad) enthält. | Field |
y_field | Das Feld in der Eingabetabelle, das die Y-Koordinaten (oder den Breitengrad) enthält. | Field |
z_field (optional) | Das Feld in der Eingabetabelle, das die Z-Koordinaten enthält. | Field |
coordinate_system (optional) | Das Koordinatensystem der X- und Y-Koordinaten. Dies ist dann das Koordinatensystem der Ausgabe-Feature-Class. | Spatial Reference |
Codebeispiel
Das folgende Skript für das Python-Fenster veranschaulicht, wie Sie die Funktion XYTableToPoint verwenden.
import arcpy
arcpy.env.workspace = r"c:\output.gdb"
arcpy.management.XYTableToPoint(r"c:\data\tree.csv", "tree_points",
"longitude", "latitude", "elevation",
arcpy.SpatialReference(4759, 115700))Im folgenden eigenständigen Python-Skript wird veranschaulicht, wie Sie die Funktion XYTableToPoint verwenden.
# XYTableToPoint.py
# Description: Creates a point feature class from input table
# import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = r"c:\output.gdb"
# Set the local variables
in_table = r"c:\data\tree.csv"
out_feature_class = "tree_points"
x_coords = "longitude"
y_coords = "latitude"
z_coords = "elevation"
# Make the XY event layer...
arcpy.management.XYTableToPoint(in_table, out_feature_class,
x_coords, y_coords, z_coords,
arcpy.SpatialReference(4759, 115700))
# Print the total rows
print(arcpy.management.GetCount(out_feature_class))