3D-ASCII in Feature-Class (3D Analyst Tools)

Zusammenfassung

Dient zum Importieren von 3D-Features aus einer oder mehreren ASCII-Dateien, die in den Formaten "XYZ", "XYZI" oder "GENERATE" gespeichert sind, in eine neue Feature-Class.

Abbildung

Beispiel für "3D-ASCII in Feature-Class"

Verwendung

Alle Eingabedateien müssen im selben Format vorliegen und denselben Geometrietyp aufweisen.
XYZ und XYZI-Formate unterstützen Kopfzeilen und behandeln die erste Reihe, die mit drei aufeinanderfolgenden Zahlen beginnt, als Anfang der Punktdatensätze. Beide Formate können Punkte, Linien und Polygone speichern, jede Datei kann jedoch nur eine Singlepart-Linie oder eine Polygon-Feature enthalten. Polygon-Features müssen geschlossen sein, wobei die Koordinaten des letzten Stützpunkts mit denen des ersten übereinstimmen müssen, und dürfen sich nicht selbst schneiden.
XYZ Dateien speichern die X-, Y- und Z-Koordinaten als Gleitkommawerte, wobei jede Zeile einen eigenen Punktdatensatz darstellt. Auf die XYZ-Koordinaten können alphanumerische Angaben folgen, diese Informationen werden jedoch nicht in die resultierende Feature-Class übernommen.
XYZI Dateien speichern X-, Y-, Z- und Intensitätskennzahlen. Intensitätswerte werden in einem BLOB-Feld (Binary Large Object) für Multipatch-Ausgaben gespeichert.

Hinweis:

Wenn die ASCII-Datei im XYZI-Format vorliegt, jedoch keine Intensitätskennzahlen erwünscht sind, wählen Sie XYZ aus. Dadurch wird der Intensitätswert beim Lesen der Dateien übersprungen.
Das Format GENERATE unterstützt keine Kopfzeilen, stellt jedoch für jeden Punkt eine ID zusammen mit XYZ-Koordinaten bereit, und die letzte Zeile der Datei wird optional mit dem END-Schlüsselwort angegeben:

<!--```nohighlight id x y z id x y z wurde nicht gefunden. wurde nicht gefunden. END

Das Format GENERATE unterstützt mehrere Features pro Datei. Bei Linien und Polygonen kennzeichnet das Schlüsselwort END das Ende eines Features, und jedes Feature muss ein Singlepart-Feature sein. Zwei aufeinanderfolgende END-Schlüsselwörter kennzeichnen das Ende der Datei.

<!--```nohighlight id x y z x y z x y z END id x y z x y z END END


> [!NOTE]
> Polygone sollten im Uhrzeigersinn ausgerichtet sein, keine Schnittpunkte mit sich selbst aufweisen und geschlossen sein (d. h., der letzte Stützpunkt ist gleich dem ersten). Wenn eine dieser Bedingungen nicht erfüllt ist, ist das Ausgabepolygon ungültig. Mit dem Werkzeug [**Geometrie überprüfen**](../data-management/check-geometry.yml) können Sie die resultierenden Features überprüfen, und mit dem Werkzeug [**Geometrie reparieren**](../data-management/repair-geometry.yml) können Sie die Fehler beheben.

Beschriftung	Erläuterung	Datentyp
ASCII-3D-Daten	Die ASCII-Dateien oder Ordner, die Daten im XYZ-, XYZI- (mit Lidar-Intensität) oder 3D GENERATE-Format enthalten. Alle Eingabedateien müssen im selben Format vorliegen. Wenn ein Ordner angegeben wird, ist die Angabe des Parameters Dateisuffix obligatorisch, und alle Dateien, die dieselbe Erweiterung wie das angegebene Suffix haben, werden verarbeitet. Im Bereich Geoverarbeitung kann ein Ordner auch als Eingabe festgelegt werden, indem der Ordner im Datei-Explorer ausgewählt und in das Eingabefeld des Parameters gezogen wird.	Folder; File
Dateiformat	Das Format der ASCII-Dateien, die in eine Feature-Class konvertiert werden. XYZ—Text file that contain geometry information stored as XYZ coordinates. XYZI—Text files that contain XYZ coordinates alongside intensity measurements. Generate—Text files structured in the Generate format.	String
Ausgabe-Feature-Class	Die Feature-Class, die erstellt werden soll.	Feature Class
Typ der Ausgabe-Feature-Class	Der Geometrietyp der Ausgabe-Feature-Class. Multipoint features—Multipoints are recommended the input data contains a large number of points and attributes per feature are not required. Point features—Each XYZ coordinate will produce one point feature. Polyline features—The output will contain polyline features. Polygon features—The output will contain polygon features.	String
Z-Faktor (Optional)	Der Faktor, mit dem Z-Werte multipliziert werden. Dieser wird in der Regel verwendet, um lineare Z-Einheiten zu konvertieren, sodass sie den linearen XY-Einheiten entsprechen. Der Standardwert ist 1, wodurch die Höhenwerte unverändert bleiben. Dieser Parameter ist nicht verfügbar, wenn der Raumbezug der Eingabe-Oberfläche über ein Z-Datum mit einer angegebenen linearen Einheit verfügt.	Double
Koordinatensystem (Optional)	Das Koordinatensystem der Eingabedaten. Der Standardwert ist ein unbekanntes Koordinatensystem. Falls angegeben, kann die Ausgabe in ein anderes Koordinatensystem projiziert werden oder auch nicht. Dies hängt davon ab, ob die Geoverarbeitungsumgebung über ein Koordinatensystem für den Speicherort der Ziel-Feature-Class verfügt.	Coordinate System
Durchschnittl. Punktabstand (Optional)	Die durchschnittliche planimetrische Entfernung zwischen den Eingabepunkten. Dieser Parameter wird nur verwendet, wenn für die Ausgabegeometrie auf MULTIPOINT festgelegt ist. Die Funktion des Parameters ist die Zusammengruppierung der Punkte. Dieser Wert wird zusammen mit den Punkten pro Shape-Grenzwert verwendet, um ein virtuelles Kachelungssystem zum Gruppieren der Punkte zu erstellen. Der Ursprung des Kachelsystems basiert auf der Domäne der Ziel-Feature-Class. Geben Sie den Abstand in den horizontalen Einheiten der Ziel-Feature-Class an.	Double
Dateisuffix (Optional)	Das Suffix der Dateien, die aus einem Eingabeordner importiert werden sollen. Dieser Parameter ist erforderlich, wenn als Eingabe ein Ordner angegeben wird.	String
Dezimaltrennzeichen (Optional)	Das Dezimalzeichen, das in der Textdatei verwendet werden soll, um den ganzzahligen Teil einer Zahl von ihrem Bruchteil zu unterscheiden. Point—A point will be used as the decimal character. This is the default. Comma—A comma will be used as the decimal character.	String

arcpy.3d.ASCII3DToFeatureClass(input, in_file_type, out_feature_class, out_geometry_type, {z_factor}, {input_coordinate_system}, {average_point_spacing}, {file_suffix}, {decimal_separator})

Name	Erläuterung	Datentyp
input [input,...]	Die ASCII-Dateien oder Ordner, die Daten im XYZ-, XYZI- (mit Lidar-Intensität) oder 3D GENERATE-Format enthalten. Alle Eingabedateien müssen im selben Format vorliegen. Wenn ein Ordner angegeben wird, ist die Angabe des Parameters Dateisuffix obligatorisch, und alle Dateien, die dieselbe Erweiterung wie das angegebene Suffix haben, werden verarbeitet. Im Bereich Geoverarbeitung kann ein Ordner auch als Eingabe festgelegt werden, indem der Ordner im Datei-Explorer ausgewählt und in das Eingabefeld des Parameters gezogen wird.	Folder; File
in_file_type	Das Format der ASCII-Dateien, die in eine Feature-Class konvertiert werden. `XYZ`—Text file that contain geometry information stored as XYZ coordinates. `XYZI`—Text files that contain XYZ coordinates alongside intensity measurements. `GENERATE`—Text files structured in the Generate format.	String
out_feature_class	Die Feature-Class, die erstellt werden soll.	Feature Class
out_geometry_type	Der Geometrietyp der Ausgabe-Feature-Class. `MULTIPOINT`—Multipoints are recommended the input data contains a large number of points and attributes per feature are not required. `POINT`—Each XYZ coordinate will produce one point feature. `POLYLINE`—The output will contain polyline features. `POLYGON`—The output will contain polygon features.	String
z_factor (Optional)	Der Faktor, mit dem Z-Werte multipliziert werden. Dieser wird in der Regel verwendet, um lineare Z-Einheiten zu konvertieren, sodass sie den linearen XY-Einheiten entsprechen. Der Standardwert ist 1, wodurch die Höhenwerte unverändert bleiben. Dieser Parameter ist nicht verfügbar, wenn der Raumbezug der Eingabe-Oberfläche über ein Z-Datum mit einer angegebenen linearen Einheit verfügt.	Double
input_coordinate_system (Optional)	Das Koordinatensystem der Eingabedaten. Der Standardwert ist ein unbekanntes Koordinatensystem. Falls angegeben, kann die Ausgabe in ein anderes Koordinatensystem projiziert werden oder auch nicht. Dies hängt davon ab, ob die Geoverarbeitungsumgebung über ein Koordinatensystem für den Speicherort der Ziel-Feature-Class verfügt.	Coordinate System
average_point_spacing (Optional)	Die durchschnittliche planimetrische Entfernung zwischen den Eingabepunkten. Dieser Parameter wird nur verwendet, wenn für die Ausgabegeometrie auf MULTIPOINT festgelegt ist. Die Funktion des Parameters ist die Zusammengruppierung der Punkte. Dieser Wert wird zusammen mit den Punkten pro Shape-Grenzwert verwendet, um ein virtuelles Kachelungssystem zum Gruppieren der Punkte zu erstellen. Der Ursprung des Kachelsystems basiert auf der Domäne der Ziel-Feature-Class. Geben Sie den Abstand in den horizontalen Einheiten der Ziel-Feature-Class an.	Double
file_suffix (Optional)	Das Suffix der Dateien, die aus einem Eingabeordner importiert werden sollen. Dieser Parameter ist erforderlich, wenn als Eingabe ein Ordner angegeben wird.	String
decimal_separator (Optional)	Das Dezimalzeichen, das in der Textdatei verwendet werden soll, um den ganzzahligen Teil einer Zahl von ihrem Bruchteil zu unterscheiden. `DECIMAL_POINT`—A point will be used as the decimal character. This is the default. `DECIMAL_COMMA`—A comma will be used as the decimal character.	String

Codebeispiel

ASCII3DToFeatureClass: Beispiel 1 (Python-Fenster)

Anhand des folgenden Beispiels wird die Verwendung dieses Werkzeugs im Python-Fenster veranschaulicht:

arcpy.env.workspace = "C:/data"
#Create spatial reference object using WKID
sr = arcpy.SpatialReference(32136)
arcpy.ddd.ASCII3DToFeatureClass("masspntz.gen", "GENERATE", "elevation_points.shp",
                                "MULTIPOINT", z_factor=3.28,
                                input_coordinate_system=sr, average_point_spacing=2.5)

ASCII3DToFeatureClass: Beispiel 2 (eigenständiges Skript)

Im folgenden Beispiel wird die Verwendung dieses Werkzeugs in einem eigenständigen Python-Skript veranschaulicht:

'''****************************************************************************
Name: ASCII3D_to_Feature_Class Example
Description: Creates a TIN surface using XYZI files in a folder and breaklines
             imported from ASCII files.
****************************************************************************'''
# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = "C:/data"

# Define the spatial reference using the name
sr = arcpy.SpatialReference("Hawaii Albers Equal Area Conic")

# Create the elevation points
arcpy.ddd.ASCII3DToFeatureClass("Elevation Points", "XYZI",
                               "elevation_points.shp",
                               "MULTIPOINT", z_factor=3.28,
                               input_coordinate_system=sr,
                               average_point_spacing=2.5,
                               file_suffix="XYZ")

# Create the break lines
arcpy.ddd.ASCII3DToFeatureClass("brklines.gen", "GENERATE",
                               "breaklines.shp",
                               "POLYLINE", z_factor=3.28,
                               input_coordinate_system=sr)

arcpy.ddd.CreateTin("elevation_tin", sr,
                    [["breaklines.shp", "Shape", "hardline"],
                    ["elevation_points.shp", "Shape", "masspoints"]],
                    "CONSTRAINED_DELAUNAY")

Umgebungen

Aktueller Workspace, Ausdehnung, Ausgabe-Koordinatensystem, Geographische Transformationen, XY-Auflösung, XY-Toleranz, Z-Auflösung, Z-Toleranz, Ausgabe-CONFIG-Schlüsselwort, Auto-Commit

Lizenzierungsinformationen

Basic: Ja
Standard: Ja
Advanced: Ja