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

Zusammenfassung

Exportiert 3D-Features in Form von GENERATE-, XYZ- oder Profildaten in ASCII-Textdateien.

Verwendung

Mit der Option "Profil" wird eine aus zwei Spalten bestehende ASCII-Datei geschrieben, die 3D-Linien-Features in Datensätze konvertiert, aus denen Liniendiagramme generiert werden können. Jede Linie aus der Quell-Feature-Class wird in eine separate Datei geschrieben, an deren Namen die eindeutige ID der Linie angefügt wird. Jede Zeile in der ASCII-Datei enthält die Entfernung zwischen der Anfangsposition der Linie und dem Stützpunkt (D), gefolgt von der Höhe an diesem Stützpunkt. Beim Laden der resultierenden ASCII-Datei in eine grafische Anwendung wird anhand der ersten Spalte die X-Achse und anhand der zweiten Spalte die Y-Achse definiert.

<!--```nohighlight 0 z₁ D₁ z₂ D₂ z₃ D₃ z₄

Mit der XYZ-Option werden X-, Y- und Z-Koordinaten als Gleitkommawerte geschrieben, wobei jede Zeile einen Punktdatensatz darstellt.

<!--```nohighlight x₁ y₁ z₁ x₂ y₂ z₂ x₃ y_{3 z} ₃ x₄ y₄ z₄


> [!NOTE]
> Punkt- und Multipoint-Features werden in dieselbe Datei geschrieben. Dagegen wird jedes Polygon- und Polylinien-Feature in eine separate Textdatei geschrieben, an deren Namen die ID des Features angefügt wird. Jeder Teil eines Multipart-Features wird in eine separate Datei geschrieben, wobei die Teilelementnummer im Dateinamen auf die ID des Features folgt.

Das GENERATE-Format unterstützt keine Kopfzeilen, speichert jedoch alle Eingabe-Features in einer Datei.
- Punkt-Features werden mit ihrer jeweiligen ID und den XYZ-Koordinaten gespeichert. Die letzte Zeile wird durch das END-Schlüsselwort gekennzeichnet:
  
  <!--```nohighlight id₁ x₁ y₁ z₁ id₂ x₂ y₂ z₂ id₃ x₃ y₃ z₃ id₄ x₄ y₄ z₄END
```
> [!NOTE]
> Multipoint-Features, die aus demselben Datensatz in der Ursprungs-Feature-Class stammen, weisen dieselbe ID auf.
```
- Linien- und Polygon-Features werden durch das END-Schlüsselwort getrennt, und zwei aufeinander folgende END-Schlüsselwörter zeigen das Ende der Datei an:
  
  <!--```nohighlight id₁ x₁ y₁ z₁ x₂ y₂ z₂ x₃ y_{3 z} ₃ x₄ y₄ z₄ END
  
  id₂ x₁ y₁ z₁ x₂ y₂ z₂ END
  
  END
```
> [!NOTE]
> Die ersten und letzten XYZ-Koordinaten für Polygon-Features sind immer identisch.
```

Beschriftung	Erläuterung	Datentyp
Eingabe-Features	Die 3D-Point-, Multipoint-, Polyline- oder Polygon-Feature-Class, die in eine ASCII-Datei exportiert wird.	Feature Layer
Ausgabeverzeichnis	Der Ordner, in den Ausgabedateien geschrieben werden.	Folder
Ausgabetextdatei	Der Name der resultierenden ASCII-Datei. Wird eine Line- oder Polygon-Feature-Class in das XYZ-Format exportiert, wird der Dateiname als Basisname verwendet. Jedes Feature wird in einer eigenen Ausgabedatei gespeichert, da das XYZ-Format nur eine Linie oder ein Polygon pro Datei unterstützt. Bei Multipart-Features wird jeder Teil in eine eigene Datei geschrieben. Dem Dateinamen werden die OID jedes Features sowie alle weiteren Zeichen angehängt, die erforderlich sind, um jeden Dateinamen eindeutig zu machen.	String
ASCII-Format (Optional)	Gibt das Format der zu erstellenden ASCII-Datei an. GENERATE—Writes output in the GENERATE format. This is the default. XYZ—Writes XYZ information of input features. One file will be created for each line or polygon in the input feature. Profile—Writes profile information for line features that can be used in external graphing applications.	String
Trennzeichen (Optional)	Gibt das Trennzeichen an, das zwischen Einträgen in Spalten der Textdateitabelle verwendet wird. Space—A space will be used to delimit field values. This is the default. Comma—A comma will be used to delimit field values. This option is not applicable if the decimal separator is also a comma.	String
Dezimalschreibweise (Optional)	Gibt die Methode an, nach der die Anzahl der signifikanten Stellen in den Ausgabendateien bestimmt wird. Automatically Determined—The number of significant digits needed to preserve the available precision, while removing unnecessary trailing zeros, is automatically determined. This is the default. Specified Number—The number of significant digits is defined in the Digits after Decimal parameter.	String
Stellen nach Dezimaltrennzeichen (Optional)	Die Anzahl der Stellen hinter dem Komma für Gleitkommawerte, die in die Ausgabedateien geschrieben werden. Dieser Parameter wird verwendet, wenn der Parameter Dezimalschreibweise auf Angegebene Anzahl festgelegt ist (`decimal_format=FIXED` in Python).	Long
Dezimaltrennzeichen (Optional)	Gibt das Dezimalzeichen an, mit dem der ganzzahlige Teil einer Zahl von ihrem Bruchteil unterschieden wird. Point—A point is used as the decimal character. This is the default. Comma—A comma is used as the decimal character.	String

Abgeleitete Ausgabe

Beschriftung	Erläuterung	Datentyp
Aktualisierter Ordner	Der Ordner, in den Ausgabedateien geschrieben werden.	Folder; File

arcpy.3d.FeatureClassZToASCII(in_feature_class, output_location, out_file, {format}, {delimiter}, {decimal_format}, {digits_after_decimal}, {decimal_separator})

Name	Erläuterung	Datentyp
in_feature_class	Die 3D-Point-, Multipoint-, Polyline- oder Polygon-Feature-Class, die in eine ASCII-Datei exportiert wird.	Feature Layer
output_location	Der Ordner, in den Ausgabedateien geschrieben werden.	Folder
out_file	Der Name der resultierenden ASCII-Datei. Wird eine Line- oder Polygon-Feature-Class in das XYZ-Format exportiert, wird der Dateiname als Basisname verwendet. Jedes Feature wird in einer eigenen Ausgabedatei gespeichert, da das XYZ-Format nur eine Linie oder ein Polygon pro Datei unterstützt. Bei Multipart-Features wird jeder Teil in eine eigene Datei geschrieben. Dem Dateinamen werden die OID jedes Features sowie alle weiteren Zeichen angehängt, die erforderlich sind, um jeden Dateinamen eindeutig zu machen.	String
format (Optional)	Gibt das Format der zu erstellenden ASCII-Datei an. `GENERATE`—Writes output in the GENERATE format. This is the default. `XYZ`—Writes XYZ information of input features. One file will be created for each line or polygon in the input feature. `PROFILE`—Writes profile information for line features that can be used in external graphing applications.	String
delimiter (Optional)	Gibt das Trennzeichen an, das zwischen Einträgen in Spalten der Textdateitabelle verwendet wird. `SPACE`—A space will be used to delimit field values. This is the default. `COMMA`—A comma will be used to delimit field values. This option is not applicable if the decimal separator is also a comma.	String
decimal_format (Optional)	Gibt die Methode an, nach der die Anzahl der signifikanten Stellen in den Ausgabendateien bestimmt wird. `AUTOMATIC`—The number of significant digits needed to preserve the available precision, while removing unnecessary trailing zeros, is automatically determined. This is the default. `FIXED`—The number of significant digits is defined in the Digits after Decimal parameter.	String
digits_after_decimal (Optional)	Die Anzahl der Stellen hinter dem Komma für Gleitkommawerte, die in die Ausgabedateien geschrieben werden. Dieser Parameter wird verwendet, wenn der Parameter Dezimalschreibweise auf Angegebene Anzahl festgelegt ist (`decimal_format=FIXED` in Python).	Long
decimal_separator (Optional)	Gibt das Dezimalzeichen an, mit dem der ganzzahlige Teil einer Zahl von ihrem Bruchteil unterschieden wird. `DECIMAL_POINT`—A point is used as the decimal character. This is the default. `DECIMAL_COMMA`—A comma is used as the decimal character.	String

Abgeleitete Ausgabe

Name	Erläuterung	Datentyp
derived_output	Der Ordner, in den Ausgabedateien geschrieben werden.	Folder; File

Codebeispiel

FeatureClassZToASCII: Beispiel 1 (Python-Fenster)

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

arcpy.env.workspace = "C:/data"
arcpy.ddd.FeatureClassZToASCII("LidarPts.shp", "", "ASCII_LidarPts.txt",
                            "GENERATE", "COMMA", "FIXED", 6, "DECIMAL_POINT")

FeatureClassZToASCII: Beispiel 2 (eigenständiges Skript)

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

'''****************************************************************************
Name: FeatureClassZToASCII Example
Description: This script demonstrates how to use the
             FeatureClassZToASCII tool to create generate files for all
             z-aware point features in a given workspace.
****************************************************************************'''
import arcpy

try:
    # Set environment settings
    arcpy.env.workspace = 'C:/data'
    # List all points in the target workspace
    fcList = arcpy.ListFeatureClasses("*", "POINT")
    if fcList:
        # Set Local Variables
        outFolder = "C:/output"
        outFormat = "GENERATE"
        delimeter = "SPACE"
        decimal = "FIXED"
        digits = 3
        dec_sep = "DECIMAL_POINT"
        for fc in fcList:
            # Use Describe method to evaluate whether the feature class is z-aware
            desc = arcpy.Describe(fc)
            if desc.hasZ == True:
                # Define the output file name by replacing '.shp' with _ascii.txt
                outName = fc.replace('.shp', '') + "_ascii.txt"
                # Run FeatureClassZToASCII_3d
                arcpy.ddd.FeatureClassZToASCII(fc, outFolder, outName, outFormat, delimeter, decimal, digits, dec_sep)
    else:
        print("There are no feature classes in the " + env.workspace + " directory.")

except arcpy.ExecuteError:
    print(arcpy.GetMessages())
except Exception as err:
    print(err)

Umgebungen

Aktueller Workspace, Ausdehnung, Ausgabe-Koordinatensystem, Geographische Transformationen

Lizenzierungsinformationen

Basic: Ja
Standard: Ja
Advanced: Ja

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

Zusammenfassung

Verwendung

Parameter

Abgeleitete Ausgabe

Umgebungen

Lizenzierungsinformationen

Verwandte Themen