Сводка
Формирует статистическую информацию об одном или нескольких файлах точек в выходных данных полигонов или мультипатчей.
Иллюстрация
Использование
Если в качестве входа выбрана папка, содержащая файлы данных точек, необходимо ввести Суффикс файла. Однако для входных данных в виде файлов это не требуется.
Если опции суммирования не используются, статистическая информация, представленная в таблице атрибутов пространственных объектов покрытия, состоит из количества точек, среднего интервала между точками, z-минимума и z-максимума для каждой из точек введенного файла. Для каждого обнаруженного входного файла создается отдельная строка. Интервал между точками является приблизительной величиной, с учетом того, что точки равномерно распределены по XY экстенту каждого из входных файлов.
Каждый полученный объект будет включать XY экстент входного файла. Объекты могут создаваться как 2D-полигоны или вытянутые мультипатчи с 3D ограничивающим прямоугольником, значения z которого в основании и в вершине отражают диапазон высот, обнаруженный в данном файле. Мультипатч можно визуализировать в 3D с помощью ArcScene или ArcGlobe.
Опция суммирования может оказаться полезной для статистического суммирования информации по каждому коду класса во входном файле, но она весьма ресурсоемкая, так как каждый файл необходимо просканировать и проанализировать.
Интервал между точками из Информации о файле точек является не точным, а предполагаемым. Интервал между точками является суммой при просмотре трендов для набора файлов. Инструмент выполняет лишь грубую оценку, которая получается при сравнении площади ограничивающей рамки файла и числа точек. Наиболее точный результат получается, когда прямоугольный экстент изучаемого файла заполнен данными. Файлы с точками, разбросанными по большим водным пространствам или по периметру изучаемой территории, лишь частично заняты данными, и поэтому точной оценке не поддаются.
Синтаксис
arcpy.3d.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})
Parameter | Объяснение | Тип данных |
input [input,...] | Любая комбинация папок и файлов, хранящих записи точек, которые будут проанализированы. В этом диалоговом окне в качестве входной может быть указана папка: необходимо в Windows Explorer выбрать желаемую папку и перетащить её в окно для ввода параметра. | File; Folder |
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 |
Производные выходные данные
Name | Объяснение | Тип данных |
min_point_spacing | Средний интервал между точками. | Double |
Пример кода
В следующем примере показано использование этого инструмента в окне Python.
arcpy.env.workspace = "C:/data"
arcpy.PointFileInformation_3d('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")
В следующем примере показано использование этого инструмента в автономном скрипте 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
# 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.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))
Environments
Информация о лицензиях
- Basic: Требуется 3D Analyst
- Standard: Требуется 3D Analyst
- Advanced: Требуется 3D Analyst