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

Сводка

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

Иллюстрация

Вывод информации о файле точек

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

  • Если в качестве входа выбрана папка, содержащая файлы данных точек, необходимо ввести Суффикс файла. Однако для входных данных в виде файлов это не требуется.

  • Если опции суммирования не используются, статистическая информация, представленная в таблице атрибутов пространственных объектов покрытия, состоит из количества точек, среднего интервала между точками, 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

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

  • 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

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

NameОбъяснениеТип данных
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))

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

  • Basic: Требуется 3D Analyst
  • Standard: Требуется 3D Analyst
  • Advanced: Требуется 3D Analyst

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