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

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

Формирует статистическую информацию об одном или нескольких файлах точек в выходных данных полигонов или мультипатчей.

Иллюстрация

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

Если в качестве входа выбрана папка, содержащая файлы данных точек, необходимо ввести Суффикс файла. Однако для входных данных в виде файлов это не требуется.
Если опции суммирования не используются, статистическая информация, представленная в таблице атрибутов пространственных объектов покрытия, состоит из количества точек, среднего интервала между точками, z-минимума и z-максимума для каждой из точек введенного файла. Для каждого обнаруженного входного файла создается отдельная строка. Интервал между точками является приблизительной величиной, с учетом того, что точки равномерно распределены по XY экстенту каждого из входных файлов.
Каждый полученный объект будет включать XY экстент входного файла. Объекты могут создаваться как 2D-полигоны или вытянутые мультипатчи с 3D ограничивающим прямоугольником, значения z которого в основании и в вершине отражают диапазон высот, обнаруженный в данном файле. Мультипатч можно визуализировать в 3D с помощью ArcScene или ArcGlobe.
Опция суммирования может оказаться полезной для статистического суммирования информации по каждому коду класса во входном файле, но она весьма ресурсоемкая, так как каждый файл необходимо просканировать и проанализировать.
Интервал между точками из Информации о файле точек является не точным, а предполагаемым. Интервал между точками является суммой при просмотре трендов для набора файлов. Инструмент выполняет лишь грубую оценку, которая получается при сравнении площади ограничивающей рамки файла и числа точек. Наиболее точный результат получается, когда прямоугольный экстент изучаемого файла заполнен данными. Файлы с точками, разбросанными по большим водным пространствам или по периметру изучаемой территории, лишь частично заняты данными, и поэтому точной оценке не поддаются.

Параметры

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

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

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

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,...]	Любая комбинация папок и файлов, хранящих записи точек, которые будут проанализированы. В диалоговом окне инструмента, в качестве входной может быть указана папка: необходимо в Windows Explorer выбрать папку и перетащить её в окно для ввода параметра.	File; Folder
out_feature_class	Класс объектов, который будет создан.	Feature Class
in_file_type	Указывает формат входных файлов. LAS—Формат хранения лидарных данных, разработанный Американским обществом по фотограмметрии и дистанционному зондированию (ASPRS). XYZ—Файл XYZ. XYZI—Файл XYZI. GENERATE—Файл 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 в результатах суммироваться по коду класса или файлу LAS. NO_SUMMARIZE—Каждый выходной пространственный объект будет представлять все коды классов, найденные в файле лидара. Это значение по умолчанию. SUMMARIZE—Каждый выходной пространственный объект будет представлять единственный код класса, найденный в файле лидара.	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.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")

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

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

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

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

Иллюстрация

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

Параметры

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

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

Пример кода

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

Особые случаи

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

Связанные разделы

В этом разделе