Punktdatei-Informationen (3D Analyst)

Zusammenfassung

Erstellt eine Polygon- oder Multipatch-Ausgabe, die die räumliche Ausdehnung und statistische Informationen über eine oder mehrere Punktdateien im ASCII- oder LAS-Format erfasst.

Abbildung

Abbildung des Werkzeugs "Punktdatei-Informationen"

Verwendung

  • Jedes Ausgabe-Feature umfasst die XY-Ausdehnung einer Eingabedatei. Die Features können als 2D-Polygone oder Multipatches erstellt werden, die den Z-Bereich jeder Eingabedatei darstellen. Die Attributtabelle enthält die folgenden Felder:

    • FileName: Name der mit dem Feature verknüpften Punktdatei.
    • Pt_Count: Gesamtzahl der Punkte in der Punktdatei.
    • Pt_Spacing: Geschätzter durchschnittlicher Abstand der Punkte in den linearen Einheiten des angegebenen Koordinatensystems. Der Punktabstand ist eine Schätzung, für die vorausgesetzt wird, dass in der XY-Ausdehnung jeder Eingabedatei die Punkte einen gleichmäßigen Abstand aufweisen.
    • Z_Min: Z-Wert des niedrigsten Punktes in der Datei.
    • Z_Max: Z-Wert des höchsten Punktes in der Datei.
  • Verwenden Sie den Parameter Nach Klassencode zusammenfassen, um ein Ausgabe-Feature für jeden Klassencode in einer .las- oder .zlas-Eingabedatei zu erstellen. Die Ausgabe-Features enthalten ein Feld mit der Bezeichnung Class, das den zusammenzufassenden Klassencode enthält, und jedes Attribut, das mit dem Feature verknüpft ist, weist die Eigenschaften für diesen Klassencode auf. Diese Option wird für .laz-Dateien nicht unterstützt.

Parameter

BeschriftungErläuterungDatentyp
Punktdaten

Die Punktdaten, die verarbeitet werden. Zu den unterstützten Eingaben zählen u. a. LAS-Datasets, .las-Dateien, .zlas-Dateien und .laz-Dateien sowie ASCII-Dateien mit Punkt-Datensätzen. Es können auch ein oder mehrere Ordner, in denen die Dateien gespeichert sind, als Eingabe angegeben werden. Wenn ein Ordner ausgewählt wird, muss das Dateisuffix der Punktdateien im Parameter Dateisuffix angegeben werden.

File; Folder
Ausgabe-Feature-Class

Die Feature-Class, die erstellt wird.

Feature Class
Dateiformat

Gibt das Format der Eingabedateien an.

  • LAS-Lidar-FormatDie Eingabedateien weisen das LAS-Lidar-Format auf. Dazu gehören .las-, .zlas- und .laz-Dateien.
  • ASCII-Datei mit XYZDie Eingabedateien liegen als ASCII-Dateien mit XYZ vor.
  • ASCII-Datei mit XYZIDie Eingabedateien liegen als ASCII-Dateien mit XYZI vor.
  • ASCII-Datei im Generate-FormatDie Eingabedateien liegen als ASCII-Dateien im Generate-Format vor.
String
Dateisuffix
(optional)

Das Suffix der Dateien, die importiert werden, wenn für die Eingabe ein Ordner angegeben wird.

String
Koordinatensystem
(optional)

Das Koordinatensystem der Eingabedaten.

Coordinate System
Unterordner einbeziehen
(optional)

Gibt an, ob Daten in Unterordnern zum Generieren von Ergebnissen verwendet werden. Das Werkzeug durchsucht Unterordner, wenn ein Eingabeordner ausgewählt wird, der Daten in einem Unterordnerverzeichnis enthält. Die Ausgabe-Feature-Class wird mit einer Zeile für jede Datei in der Verzeichnisstruktur generiert.

  • Deaktiviert: Die Ergebnisse werden nur aus den Daten im Eingabeordner generiert. Dies ist die Standardeinstellung.
  • Aktiviert: Die Ergebnisse werden aus allen Daten im Eingabeordner und seinen Unterverzeichnissen generiert.
Boolean
Geometrie-Shapes extrudieren
(optional)

Gibt an, ob die Ausgabe als ein 2D-Polygon oder eine Multipatch-Feature-Class mit extrudierten Features, die den Höhenbereichen in jeder Datei entsprechen, erzeugt werden soll.

  • Deaktiviert: Die Ausgabe wird als 2D-Polygon-Feature-Class erstellt. Dies ist die Standardeinstellung.
  • Aktiviert: Die Ausgabe wird als Multipatch-Feature-Class erstellt.
Boolean
Dezimaltrennzeichen
(optional)

Das in der Textdatei verwendete Dezimalzeichen, mit dem der ganzzahlige Teil einer Zahl von ihrem Bruchteil unterschieden wird.

  • DECIMAL_POINTAls Dezimalzeichen wird ein Punkt verwendet. Dies ist die Standardeinstellung.
  • DECIMAL_COMMAAls Dezimalzeichen wird ein Komma verwendet.
String
Nach Klassencode zusammenfassen
(optional)

Gibt an, ob .las- oder .zlas-Dateien in der Ausgabe nach Klassencode oder nach Datei zusammengefasst werden sollen. Dieser Parameter wird für .laz-Dateien nicht unterstützt.

  • Deaktiviert: Jedes Ausgabe-Feature repräsentiert alle Daten in der .las- oder .zlas-Datei. Dies ist die Standardeinstellung.
  • Aktiviert: Jedes Ausgabe-Feature repräsentiert einen einzelnen Klassencode in der .las- oder .zlas-Eingabedatei. Für diese Option ist ein vollständiger Scan der Eingabedateien erforderlich.
Boolean
Punktabstandsschätzung von LAS-Dateien verbessern
(optional)

Gibt an, ob die verbesserte Abschätzung des Punktabstands in .las-Dateien verwendet wird, um so Überbewertungen wegen unregelmäßiger Datenverteilung reduzieren zu können.

  • Deaktiviert: Es wird eine reguläre Punktabstandsschätzung für .las-Dateien verwendet. Die Ausdehnung wird dabei gleichmäßig durch die Anzahl der Punkte geteilt. Dies ist die Standardeinstellung.
  • Aktiviert: Klasseneinteilungen werden verwendet, um eine präzisere Punktabstandsschätzung für .las-Dateien zu erhalten. Durch diese Option kann sich die Ausführungszeit des Werkzeugs erhöhen.
Boolean

Abgeleitete Ausgabe

BeschriftungErläuterungDatentyp
Durchschnittl. Punktabstand

Der durchschnittliche Punktabstand.

Double

arcpy.ddd.PointFileInformation(input, out_feature_class, in_file_type, {file_suffix}, {input_coordinate_system}, {folder_recursion}, {extrude_geometry}, {decimal_separator}, {summarize_by_class_code}, {improve_las_point_spacing})
NameErläuterungDatentyp
input
[input,...]

Die Punktdaten, die verarbeitet werden. Zu den unterstützten Eingaben zählen u. a. LAS-Datasets, .las-Dateien, .zlas-Dateien und .laz-Dateien sowie ASCII-Dateien mit Punkt-Datensätzen. Es können auch ein oder mehrere Ordner, in denen die Dateien gespeichert sind, als Eingabe angegeben werden. Wenn ein Ordner ausgewählt wird, muss das Dateisuffix im Parameter file_suffix angegeben werden.

File; Folder
out_feature_class

Die Feature-Class, die erstellt wird.

Feature Class
in_file_type

Gibt das Format der Eingabedateien an.

  • LASDie Eingabedateien weisen das LAS-Lidar-Format auf. Dazu gehören .las-, .zlas- und .laz-Dateien.
  • XYZDie Eingabedateien liegen als ASCII-Dateien mit XYZ vor.
  • XYZIDie Eingabedateien liegen als ASCII-Dateien mit XYZI vor.
  • GENERATEDie Eingabedateien liegen als ASCII-Dateien im Generate-Format vor.
String
file_suffix
(optional)

Das Suffix der Dateien, die importiert werden, wenn für die Eingabe ein Ordner angegeben wird.

String
input_coordinate_system
(optional)

Das Koordinatensystem der Eingabedaten.

Coordinate System
folder_recursion
(optional)

Gibt an, ob Daten in Unterordnern zum Generieren von Ergebnissen verwendet werden. Das Werkzeug durchsucht Unterordner, wenn ein Eingabeordner ausgewählt wird, der Daten in einem Unterordnerverzeichnis enthält. Die Ausgabe-Feature-Class wird mit einer Zeile für jede Datei in der Verzeichnisstruktur generiert.

  • NO_RECURSIONDie Ergebnisse werden nur aus den Daten im Eingabeordner generiert. Dies ist die Standardeinstellung.
  • RECURSIONDie Ergebnisse werden aus allen Daten im Eingabeordner und seinen Unterverzeichnissen generiert.
Boolean
extrude_geometry
(optional)

Gibt an, ob die Ausgabe als ein 2D-Polygon oder eine Multipatch-Feature-Class mit extrudierten Features, die den Höhenbereichen in jeder Datei entsprechen, erzeugt werden soll.

  • NO_EXTRUSIONDie Ausgabe wird als 2D-Polygon-Feature-Class erstellt. Dies ist die Standardeinstellung.
  • EXTRUSIONDie Ausgabe wird als Multipatch-Feature-Class erstellt.
Boolean
decimal_separator
(optional)

Das in der Textdatei verwendete Dezimalzeichen, mit dem der ganzzahlige Teil einer Zahl von ihrem Bruchteil unterschieden wird.

  • DECIMAL_POINTAls Dezimalzeichen wird ein Punkt verwendet. Dies ist die Standardeinstellung.
  • DECIMAL_COMMAAls Dezimalzeichen wird ein Komma verwendet.
String
summarize_by_class_code
(optional)

Gibt an, ob .las- oder .zlas-Dateien in den Ergebnissen nach Klassencode oder nach Datei zusammengefasst werden sollen. Diese Option ist nicht für .laz-Dateien verfügbar.

  • NO_SUMMARIZEJedes Ausgabe-Feature repräsentiert alle Klassencodes in der .las- oder .las-Datei. Dies ist die Standardeinstellung.
  • SUMMARIZEJedes Ausgabe-Feature repräsentiert einen einzelnen Klassencode in der .las- oder .zlas-Eingabedatei. Für diese Option ist ein vollständiger Scan der Eingabedateien erforderlich.
Boolean
improve_las_point_spacing
(optional)

Gibt an, ob die verbesserte Abschätzung des Punktabstands in .las-Dateien verwendet wird, um so Überbewertungen wegen unregelmäßiger Datenverteilung reduzieren zu können.

  • LAS_SPACINGEs wird eine reguläre Punktabstandsschätzung für .las-Dateien verwendet. Die Ausdehnung wird dabei gleichmäßig durch die Anzahl der Punkte geteilt. Dies ist die Standardeinstellung.
  • NO_LAS_SPACINGKlasseneinteilungen werden verwendet, um eine präzisere Punktabstandsschätzung für .las-Dateien zu erhalten. Durch diese Option kann sich die Ausführungszeit des Werkzeugs erhöhen.
Boolean

Abgeleitete Ausgabe

NameErläuterungDatentyp
min_point_spacing

Der durchschnittliche Punktabstand.

Double

Codebeispiel

PointFileInformation: Beispiel 1 (Python-Fenster)

Im folgenden Beispiel wird die Verwendung dieses Werkzeugs im Python-Fenster veranschaulicht.

arcpy.env.workspace = "C:/data"
arcpy.ddd.PointFileInformation('las_files', "Test.gdb/two_las", 
                              in_file_type="LAS", file_suffix="las", 
                              input_coordinate_system="NAD 1983 UTM Zone 17N.prj", 
                              decimal_separator="DECIMAL_POINT")
PointFileInformation: Beispiel 2 (eigenständiges Skript)

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

'''****************************************************************************
Name: PointFileInformation Example
Description: This script demonstrates how to use the 
             PointFileInformation tool to create an output file that contains
             all LAS files under a parent folder.
****************************************************************************'''
# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = "C:/data"
lidarList = arcpy.ListFiles("*.las")
if lidarList:
    # Set Local Variables
    outputFC = "Test.gdb/output_las_info"
    prj = "Coordinate Systems/Geographic Coordinate Systems/World/WGS 1984.prj"
    extrudeGeom = True # Indicates whether to create extruded geometry shapes
    sumClass = True # Indicates whether to summarize output by class code
    decSep = "DECIMAL_POINT" # Identifies the decimal separator
    
    #Execute PointFileInformation
    arcpy.ddd.PointFileInformation(lidarList, outputFC, "LAS", "las", prj, 
                                "", extrudeGeom, decSep, sumClass)
    print("Finished executing Point File Information.")
else:
    print("There are no LAS files in {0}.".format(env.workspace))

Verwandte Themen