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

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

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

Иллюстрация

Иллюстрация инструмента Информация о файле точек

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

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

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

Параметры

ПодписьОписаниеТип данных
Точечные данные

Точечные данные, которые будут обработаны. Поддерживаемые входные данные включают наборы данных LAS, файлы .las, .zlas и .laz, а также файлы ASCII, содержащие записи точек. В качестве входных данных также можно указать одну или несколько папок, содержащих файлы. Когда папка включена, суффикс файлов точек должен быть указан в параметре Суффикс файла.

File; Folder
Выходной класс объектов

Класс объектов, который будет создан.

Feature Class
Формат файла

Указывает формат входных файлов.

  • Формат лидара LASФормат входных файлов - формат лидара LAS, который включает файлы .las, .zlas и .laz.
  • Формат файла ASCII XYZФормат входных файлов - файлы ASCII с XYZ.
  • Формат файла ASCII XYZIФормат входных файлов - файлы ASCII с XYZI.
  • Формат файла ASCII в GenerateФормат входных файлов — файлы ASCII в формате Generate.
String
Суффикс файла
(Дополнительный)

Суффикс импортируемых файлов, если в качестве входных данных задана папка.

String
Система координат
(Дополнительный)

Система координат входных данных.

Coordinate System
Включить подпапки
(Дополнительный)

Указывает, будут ли данные во вложенных папках использоваться для создания результатов. Инструмент сканирует вложенные папки, когда выбрана входная папка, содержащая данные в каталоге вложенных папок. Выходной класс объектов будет содержать строку для каждого файла в структуре директории.

  • Не отмечено – для построения результата будут использоваться только те данные, которые будут во входной папке. Это значение по умолчанию
  • Отмечено - для построения результата будут использоваться данные, присутствующие во входной папке и подпапках, вложенных в нее.
Boolean
Вытянуть геометрические формы
(Дополнительный)

Указывает, требуется ли создавать выходной класс 2D-полигональных объектов или мультипатчей с вытянутыми объектами отражающими диапазон высот, в каждом из файлов.

  • Не отмечено – на выходе будет создан класс 2D-полигональных пространственных объектов. Это значение по умолчанию
  • Отмечено — выходные данные будут созданы как класс объектов-мультипатчей.
Boolean
Разделитель десятичных знаков
(Дополнительный)

Десятичный символ, используемый в текстовом файле, чтобы отделить целую часть числа от дробной.

  • ТочкаВ качестве разделителя будет использоваться точка. Это значение по умолчанию
  • ЗапятаяВ качестве разделителя будет использоваться запятая.
String
Суммировать по коду класса
(Дополнительный)

Указывает, будут ли выходные данные суммировать файлы .las или .zlas по кодам классов или по файлам. Этот параметр не поддерживается для файлов .laz.

  • Не отмечено – каждый выходной пространственный объект будет представлять все данные в файле .las или .zlas. Это значение по умолчанию
  • Отмечено — каждый выходной объект будет представлять один код класса во входном файле .las или .zlas. Эта опция требует полного сканирования входных файлов.
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,...]

Точечные данные, которые будут обработаны. Поддерживаемые входные данные включают наборы данных LAS, файлы .las, .zlas и .laz, а также файлы ASCII, содержащие записи точек. В качестве входных данных также можно указать одну или несколько папок, содержащих файлы. Когда папка включена, суффикс файлов точек должен быть указан в параметре file_suffix.

File; Folder
out_feature_class

Класс объектов, который будет создан.

Feature Class
in_file_type

Указывает формат входных файлов.

  • LASФормат входных файлов - формат лидара LAS, который включает файлы .las, .zlas и .laz.
  • 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 или .zlas по коду класса или по файлу. Эта опция не доступна для файлов .laz.

  • NO_SUMMARIZEКаждый выходной пространственный объект будет представлять все коды классов, в файле .las или .las. Это значение по умолчанию
  • SUMMARIZEКаждый выходной объект будет представлять один код класса во входном файле .las или .zlas. Эта опция требует полного сканирования входных файлов.
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))

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

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

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