Zusammenfassung
Erzeugt statistische Informationen über Punktdateien in einer Polygon- oder Multipatch-Ausgabe.
Bild
Verwendung
Wenn ein Ordner mit Punktdatendateien als Eingabe ausgewählt ist, muss das Dateisuffix eingegeben werden. Dies ist jedoch nicht nötig, wenn die Eingabe direkt aus einer Datei erfolgt.
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.
Jede resultierende Feature-Class umfasst die XY-Ausdehnung einer Eingabedatei. Die Features können als 2D-Polygone oder als extrudierte Multipatch-Features erstellt werden, die einen 3D-Rahmen bereitstellen, dessen Z-Werte unten und oben den Bereich der in der Datei gefundenen Höhenwerte wiedergeben. Das Multipatch kann in ArcScene oder ArcGlobe in 3D visualisiert werden.
Die Option "Nach Klassencode zusammenfassen" kann dabei helfen, die Informationen für jeden Klassencode in der Eingabedatei statistisch zusammenzufassen; allerdings ist dies sehr aufwändig, da jede Datei gescannt und analysiert werden muss.
Der von Punktdatei-Informationen 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
PointFileInformation_3d (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})
Parameter | Erläuterung | Datentyp |
input [input,...] | Die Punktdatendateien oder -ordner, die analysiert werden. | Folder; File |
out_feature_class | Die Feature-Class, die von diesem Werkzeug erstellt wird. | Feature Class |
in_file_type | Das Format der Eingabedateien.
| String |
file_suffix (optional) | Das Suffix der zu importierenden Dateien, wenn für die Eingabe ein Ordner angegeben wird. Dieser Parameter ist erforderlich, wenn ein Eingabeordner bereitgestellt wird. | String |
input_coordinate_system (optional) | Das Koordinatensystem der Eingabedaten. | Coordinate System |
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) |
Gibt an, ob ein 2D-Polygon oder eine Multipatch-Feature-Class mit extrudierten Features, die den in jeder Datei gefundenen Höhenbereichen entsprechen, erzeugt werden soll.
| Boolean |
decimal_separator (optional) | Das in der Textdatei verwendete Dezimalzeichen, mit dem der ganzzahlige Teil einer Zahl von ihrem Bruchteil unterschieden wird.
| String |
summarize_by_class_code (optional) |
Gibt an, ob LAS-Dateien in den Ergebnissen nach Klassencode oder LAS-Datei zusammengefasst werden sollen.
| Boolean |
improve_las_point_spacing (optional) | Bietet eine verbesserte Bewertung des Punktabstands in LAS-Dateien, wodurch Überbewertungen wegen unregelmäßiger Datenverteilung reduziert werden können.
| Boolean |
Codebeispiel
PointFileInformation – Beispiel 1 (Python-Fenster)
Anhand des folgenden Beispiels wird die Verwendung dieses Werkzeugs im Python-Fenster veranschaulicht.
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)
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
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)
Umgebung
Lizenzierungsinformationen
- ArcGIS for Desktop Basic: Erfordert 3D Analyst
- ArcGIS for Desktop Standard: Erfordert 3D Analyst
- ArcGIS for Desktop Advanced: Erfordert 3D Analyst