Информация о файле точек (Point File Information) (3D Analyst)
Краткая информация
Формирует статистическую информацию об одном или нескольких файлах точек в виде многоугольника или мультипатча.
Рисунок
 |
Использование
-
Входные файлы могут иметь формат XYZ, XYZI, LAS и GENERATE.
-
Если в качестве входа выбрана папка, содержащая файлы данных точек, необходимо ввести Суффикс файла (File Suffix). Однако для входных данных в виде файлов это не требуется.
-
Если опции суммирования не используются, статистическая информация, представленная в таблице атрибутов пространственных объектов покрытия, состоит из количества точек, среднего интервала между точками, z-минимума и z-максимума для каждой из точек введенного файла. Для каждого обнаруженного входного файла создается отдельная строка. Интервал между точками является приблизительной величиной, с учетом того, что точки равномерно распределены по XY экстенту каждого из входных файлов.
-
Каждый полученный объект будет включать XY экстент входного файла. Объекты могут создаваться как 2D полигоны или вытянутые мультипатчи с 3D ограничивающим прямоугольником, значения z которого в основании и в вершине отражают диапазон высот, обнаруженный в данном файле. Мультипатч можно визуализировать в 3D с помощью ArcScene или ArcGlobe.
Опция суммирования может оказаться полезной для статистического суммирования информации по каждому коду класса во входном файле, но она весьма ресурсоемка, так как каждый файл необходимо просканировать и проанализировать.
Интервал между точками, который выдает Информация о файле точек, не является точным; он подсчитывается приблизительно. Интервал между точками является суммой при просмотре трендов для набора файлов. Инструмент выполняет лишь грубую оценку, которая получается при сравнении площади ограничивающей рамки файла и числа точек. Наиболее точный результат получается, когда прямоугольный экстент изучаемого файла заполнен данными. Файлы с точками, разбросанными по большим водным пространствам или по периметру изучаемой территории, лишь частично заняты данными, и поэтому точной оценке не поддаются.
Синтаксис
| Параметр | Объяснение | Тип данных |
input [input,...] |
Один или несколько входных файлов данных точек либо папок для анализа. | Folder; File |
out_feature_class |
Выходной класс объектов. | Feature Class |
in_file_type |
Формат входных файлов.
| String |
file_suffix (дополнительно) |
Суффикс импортируемых файлов, если в качестве входа задана папка. Этот параметр является обязательным, если указана входная папка. | String |
input_coordinate_system (дополнительно) |
Система координат входных данных. | Coordinate System |
folder_recursion (дополнительно) |
Сканирует подпапки, если в качестве входных данных указана папка. Выходной класс объектов будет содержать строку для каждого найденного файла.
| Boolean |
extrude_geometry (дополнительно) |
Указывает, требуется ли создавать класс 2D-полигональных объектов или мультипатчей с вытянутыми объектами, отражающими диапазон высот, обнаруженный в каждом из файлов.
| Boolean |
decimal_separator (дополнительно) | Десятичный символ, используемый в текстовом файле, чтобы отделить целую часть числа от дробной.
| String |
summarize_by_class_code (дополнительно) |
Указывает, будут ли файлы LAS в результатах суммироваться по коду класса или файлу LAS.
| Boolean |
improve_las_point_spacing (дополнительно) | Обеспечивает улучшенную оценку интервала между точками в файлах LAS, что может снизить недооценку, вызванную неравномерностью распределения данных.
| Boolean |
Пример кода
В следующем примере показано использование этого инструмента в окне Python:
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)
В следующем примере показано использование этого инструмента в автономном скрипте Python:
'''****************************************************************************
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)