Punktdateiinformationen (3D Analyst)
Zusammenfassung
Erzeugt eine neue Ausgabe-Feature-Class mit statistischen Informationen über eine oder mehrere Punktdateien.
Abbildung
 |
Verwendung
-
Eingabedateien müssen die Formate LAS, XYZ, XYZI oder GENERATE aufweisen.
-
Wenn ein Ordner mit Punktdatendateien als Eingabe ausgewählt wird, muss das Suffix eingegeben werden. Wird nur eine Datei als Eingabe ausgewählt, ist das Suffix nicht erforderlich.
-
Wenn die Option "Nach Klassencode zusammenfassen" nicht verwendet wird, bestehen die statistischen Informationen in der Feature-Attributtabelle aus der Punktanzahl, dem mittleren Punktabstand sowie dem minimalen und dem maximalen Z-Wert für jede eingegebene Punktdatei. Für jede gefundene Eingabedatei wird eine separate Zeile erstellt. 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.
-
Eine Ausgabe-Polygon-Feature-Class wird mit den XY-Ausdehnungen der Eingabedateien erstellt. Alternativ können Multipatch-Features mit dem minimalen und dem maximalen Z-Wert der Ausdehnung jeder Eingabedatei generiert werden. Diese bieten eine 3D-Rahmendarstellung, die in ArcScene oder ArcGlobe angezeigt werden kann.
Die Option "Feldstatistik" ist nützlich, um Informationen für jeden Klassencode in der Eingabedatei in einer Statistik zusammenzufassen. Der Vorgang kann jedoch aufwendig sein, da jede Datei gescannt und analysiert werden muss.
Der von Punktdateiinformationen gemeldete Punktabstand ist nicht genau, sondern ein Schätzwert. Der angegebene Punktabstand ist als Zusammenfassung zu verstehen, wenn Trends für Sammlungen von Dateien betrachtet werden. Das Werkzeug verwendet eine grobe Schätzung, die einfach die Fläche des Rahmens der Datei mit der Punktanzahl vergleicht. Der Punktabstand ist allerdings dann sehr genau, wenn die rechteckige Ausdehnung der untersuchten Datei mit Daten ausgefüllt wird. Dateien mit Punkten über großen Gewässern oder auf dem Umfang eines Untersuchungsgebiets, das nur teilweise Daten enthält, ermöglichen keine genauen Schätzungen.
Syntax
| Parameter | Erläuterung | Datentyp |
input |
Einzelne oder mehrere Dateien oder Ordner mit Punktdaten. | File; Folder |
out_feature_class |
Die Ausgabe-Feature-Class. | Feature Class |
in_file_type |
Das Format der Eingabedatei(en). Eingabedateien müssen die Formate LAS, XYZ, XYZI oder GENERATE aufweisen. | String |
file_suffix |
Das Suffix der zu importierenden Dateien, wenn bei der Eingabe ein Ordner angegeben wird. | String |
input_coordinate_system (optional) |
Das Koordinatensystem der Eingabedaten. | Coordinate System |
summarize_by_class_code (optional) |
Durchsucht die LAS-Dateien und analysiert die Klassencodewerte. Die Attributtabelle der Ausgabe-Feature-Class enthält statistische Informationen für jeden gefundenen Klassencode.
| Boolean |
folder_recursion (optional) |
Durchsucht Unterordner, wenn ein Eingabeordner ausgewählt wird, der Daten im Unterordner-Verzeichnis enthält. Die Ausgabe-Feature-Class wird mit einer Zeile für jede in der Verzeichnisstruktur gefundene Datei generiert.
| Boolean |
extrude_geometry (optional) |
Eine 3D-Multipatch-Feature-Class wird basierend auf den minimalen und maximalen Z-Werten von jeder Eingabedatei generiert.
| Boolean |
decimal_separator (optional) |
In ASCII-Dateien verwendetes Trennzeichen. Der Standardwert ist das Dezimaltrennzeichen. Ermöglicht es dem Benutzer anzugeben, ob das in den Dateien verwendete Dezimaltrennzeichen ein Punkt oder ein Komma ist. | String |
Codebeispiel
Das folgende Skript im Python-Fenster veranschaulicht die Verwendung der Funktion Punktdateiinformationen im unmittelbaren Modus.
import arcpy
from arcpy import env
arcpy.CheckOutExtension("3D")
env.workspace = "C:/data"
arcpy.PointFileInformation_3d(env.workspace, "Test.gdb/two_las", "LAS", "las", "Coordinate Systems/Projected Coordinate Systems/UTM/NAD 1983/NAD 1983 UTM Zone 17N.prj", True, True, "DECIMAL_POINT", True)
Das folgende Python-Skript veranschaulicht die Verwendung der Funktion Punktdateiinformationen in einem eigenständigen Skript.
'''****************************************************************************
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
from arcpy import env
import exceptions, sys, traceback
try:
# Obtain a license for the ArcGIS 3D Analyst extension
arcpy.CheckOutExtension("3D")
# Set environment settings
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.PointFileInformation_3d(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)
except arcpy.ExecuteError:
print arcpy.GetMessages()
except:
# Get the traceback object
tb = sys.exc_info()[2]
tbinfo = traceback.format_tb(tb)[0]
# Concatenate error information into message string
pymsg = 'PYTHON ERRORS:\nTraceback info:\n{0}\nError Info:\n{1}'\
.format(tbinfo, str(sys.exc_info()[1]))
msgs = 'ArcPy ERRORS:\n {0}\n'.format(arcpy.GetMessages(2))
# Return python error messages for script tool or Python Window
arcpy.AddError(pymsg)
arcpy.AddError(msgs)