Информация о файле точек (3D Analyst)

Краткая информация

Создает выходной полигон или мультипатч, который захватывает пространственный экстент и статистическую информацию об одном или нескольких файлах точек в формате ASCII или LAS.

Иллюстрация

Использование

• Каждый выходной объект будет охватывать x,y экстент входного файла. Объекты могут быть созданы в виде 2D-полигонов или мультипатчей, отображающих z-диапазон каждого входного файла. Таблица атрибутов будет иметь следующие поля:

  • FileName— имя файла точек, связанного с объектом.
  • Pt_Count— общее количество точек в файле точек.
  • Pt_Spacing— приблизительное среднее расстояние между точками в линейных единицах указанной системы координат. Интервал между точками является приблизительной величиной, с учетом того, что точки равномерно распределены по x,y экстенту каждого из входных файлов.
  • Z_Min— z-значение самой нижней точки в файле.
  • Z_Max— z-значение самой высокой точки в файле.

• При обработке набора файлов .las выходные данные могут быть созданы таким образом, чтобы суммировать информацию о каждом коде класса, присутствующем в каждом файле. Итоговые выходные данные отражают z-диапазон каждого кода класса. Когда используется параметр Суммировать по коду класса, выходные данные будут включать поле с именем Class, которое содержит код суммируемого класса, и каждый атрибут, связанный с объектом, будет отражать свойства для этого кода класса.

Параметры

Диалог

Подпись	Описание	Тип данных
Точечные данные	Точечные данные, которые будут обработаны. Поддерживаемые входные данные включают наборы данных LAS, файлы .las, файлы .zlas и файлы ASCII, содержащие записи точек. В качестве входных данных также можно указать одну или несколько папок, содержащих файлы. Когда папка включена, суффикс файлов точек должен быть указан в параметре Суффикс файла.	File; Folder
Выходной класс пространственных объектов	Класс объектов, который будет создан.	Feature Class
Формат файла	Указывает формат входных файлов. Формат лидара LAS—Формат входных файлов - формат лидара LAS. Формат файла ASCII XYZ—Формат входных файлов - файлы ASCII с XYZ. Формат файла ASCII XYZI—Формат входных файлов - файлы ASCII с XYZI. Формат файла ASCII в Generate—Формат входных файлов — файлы ASCII в формате Generate.	String
Суффикс файла (Дополнительный)	Суффикс импортируемых файлов, если в качестве входных данных задана папка.	String
Система координат (Дополнительный)	Система координат входных данных.	Coordinate System
Включить подпапки (Дополнительный)	Указывает, будут ли данные во вложенных папках использоваться для создания результатов. Инструмент сканирует вложенные папки, когда выбрана входная папка, содержащая данные в каталоге вложенных папок. Выходной класс объектов будет содержать строку для каждого найденного файла в структуре директории. Не отмечено – для построения результата будут использоваться только те данные, которые будут найдены во входной папке. Это значение по умолчанию Отмечено - для построения результата будут использоваться данные, найденные во входной папке и подпапках, вложенных в нее.	Boolean
Вытянуть геометрические формы (Дополнительный)	Указывает, требуется ли создавать выходной класс 2D-полигональных объектов или мультипатчей с вытянутыми объектами, отражающими диапазон высот, обнаруженный в каждом из файлов. Не отмечено – на выходе будет создан класс 2D-полигональных пространственных объектов. Это значение по умолчанию Отмечено — выходные данные будут созданы как класс объектов-мультипатчей.	Boolean
Разделитель десятичных знаков (Дополнительный)	Десятичный символ, используемый в текстовом файле, чтобы отделить целую часть числа от дробной. Точка—В качестве разделителя будет использоваться точка. Это значение по умолчанию Запятая—В качестве разделителя будет использоваться запятая.	String
Суммировать по коду класса (Дополнительный)	Указывает, будут ли выходные данные суммировать файлы .las по кодам классов или по файлам. Этот параметр доступен только для данных формата LAS и требует полного сканирования каждого входного файла. Не отмечено – каждый выходной пространственный объект будет представлять все данные, найденные в файле .las. Это значение по умолчанию Отмечено — каждый выходной объект будет представлять один код класса, найденный в файле .las.	Boolean
Улучшить оценочные смещения точек файлов LAS (Дополнительный)	Указывает, будет ли использоваться улучшенная оценка интервала между точками в файлах .las, которая может снизить погрешность, вызванную неравномерностью распределения данных. Не отмечено — для файлов .las, в которых экстент равномерно делится на число точек, используется обычная оценка расстояния между точками. Это значение по умолчанию Отмечено – для файлов .las будет использоваться биннинг, чтобы получить более точную оценку интервалов между точками. Это может увеличить время работы инструмента.	Boolean

Производные выходные данные

Подпись	Описание	Тип данных
Средний интервал между точками	Средний интервал между точками.	Double

Python

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})

Имя	Описание	Тип данных
input [input,...]	Точечные данные, которые будут обработаны. Поддерживаемые входные данные включают наборы данных LAS, файлы .las, файлы .zlas и файлы ASCII, содержащие записи точек. В качестве входных данных также можно указать одну или несколько папок, содержащих файлы. Когда папка включена, суффикс файлов точек должен быть указан в параметре file_suffix.	File; Folder
out_feature_class	Класс объектов, который будет создан.	Feature Class
in_file_type	Указывает формат входных файлов. LAS—Формат входных файлов - формат лидара LAS. XYZ—Формат входных файлов - файлы ASCII с XYZ. XYZI—Формат входных файлов - файлы ASCII с XYZI. GENERATE—Формат входных файлов — файлы ASCII в формате Generate.	String
file_suffix (Дополнительный)	Суффикс импортируемых файлов, если в качестве входных данных задана папка.	String
input_coordinate_system (Дополнительный)	Система координат входных данных.	Coordinate System
folder_recursion (Дополнительный)	Указывает, будут ли данные во вложенных папках использоваться для создания результатов. Инструмент сканирует вложенные папки, когда выбрана входная папка, содержащая данные в каталоге вложенных папок. Выходной класс объектов будет содержать строку для каждого найденного файла в структуре директории. NO_RECURSION—Для построения результата будут использоваться только те данные, которые будут найдены во входной папке. Это значение по умолчанию RECURSION—Для построения результата будут использоваться данные, которые будут найдены во входной папке и папках, вложенных в нее.	Boolean
extrude_geometry (Дополнительный)	Указывает, требуется ли создавать выходной класс 2D-полигональных объектов или мультипатчей с вытянутыми объектами, отражающими диапазон высот, обнаруженный в каждом из файлов. NO_EXTRUSION—На выходе будет создан класс 2D-полигональных пространственных объектов. Это значение по умолчанию EXTRUSION—Выходные данные будут созданы как класс объектов-мультипатчей.	Boolean
decimal_separator (Дополнительный)	Десятичный символ, используемый в текстовом файле, чтобы отделить целую часть числа от дробной. DECIMAL_POINT—В качестве разделителя будет использоваться точка. Это значение по умолчанию DECIMAL_COMMA—В качестве разделителя будет использоваться запятая.	String
summarize_by_class_code (Дополнительный)	Указывает, будут ли результаты суммировать файлы .las по коду класса или по файлу. NO_SUMMARIZE—Каждый выходной пространственный объект будет представлять все коды классов, найденные в файле .las. Это значение по умолчанию SUMMARIZE—Каждый выходной объект будет представлять один код класса, найденный в файле .las.	Boolean
improve_las_point_spacing (Дополнительный)	Указывает, будет ли использоваться улучшенная оценка интервала между точками в файлах .las, которая может снизить погрешность, вызванную неравномерностью распределения данных. LAS_SPACING—Для файлов .las, в которых экстент равномерно делится на число точек, используется обычная оценка расстояния между точками. Это значение по умолчанию NO_LAS_SPACING—Для файлов .las будет использоваться биннинг, чтобы получить более точную оценку интервалов между точками. Это может увеличить время работы инструмента.	Boolean

Производные выходные данные

Имя	Описание	Тип данных
min_point_spacing	Средний интервал между точками.	Double

Пример кода

PointFileInformation, пример 1 (окно Python)

В следующем примере показано использование этого инструмента в окне Python.

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, пример 2 (автономный скрипт)

В следующем примере показано использование этого инструмента в автономном скрипте 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.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))

Параметры среды

Текущая рабочая область, Временная рабочая область, Выходная система координат, Экстент, Разрешение XY, Допуск XY, Разрешение Z, Допуск Z, Выходное ключевое слово CONFIG, Автоматическое подтверждение, Выходной XY домен, Выходной домен Z

Информация о лицензиях

• Basic: Обязательно 3D Analyst
• Standard: Обязательно 3D Analyst
• Advanced: Обязательно 3D Analyst