ArcMap

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

Сводка

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

Иллюстрация

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

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

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

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

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

  • Опция суммирования может оказаться полезной для статистического суммирования информации по каждому коду класса во входном файле, но она весьма ресурсоемка, так как каждый файл необходимо просканировать и проанализировать.

  • Интервал между точками из Информации о файле точек является не точным, а предполагаемым. Интервал между точками является суммой при просмотре трендов для набора файлов. Инструмент выполняет лишь грубую оценку, которая получается при сравнении площади ограничивающей рамки файла и числа точек. Наиболее точный результат получается, когда прямоугольный экстент изучаемого файла заполнен данными. Файлы с точками, разбросанными по большим водным пространствам или по периметру изучаемой территории, лишь частично заняты данными, и поэтому точной оценке не поддаются.

Синтаксис

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 выбрать желаемую папку и перетащить её в окно для ввода параметра.

Folder; File
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.

import arcpy
from arcpy import env

arcpy.CheckOutExtension("3D")
env.workspace = "C:/data"
arcpy.PointFileInformation_3d(env.workspace, "Test.gdb/two_las", "LAS", "las", "Coordinate Systems/Projected Coordinate Systems/UTM/NAD 1983/NAD 1983 UTM Zone 17N.prj", True, True, "DECIMAL_POINT", True)
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
from arcpy import env
import exceptions, sys, traceback

try:
    # Obtain a license for the ArcGIS 3D Analyst extension
    arcpy.CheckOutExtension("3D")
    # Set environment settings
    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)

except arcpy.ExecuteError:
    print arcpy.GetMessages()
except:
    # Get the traceback object
    tb = sys.exc_info()[2]
    tbinfo = traceback.format_tb(tb)[0]
    # Concatenate error information into message string
    pymsg = 'PYTHON ERRORS:\nTraceback info:\n{0}\nError Info:\n{1}'\
          .format(tbinfo, str(sys.exc_info()[1]))
    msgs = 'ArcPy ERRORS:\n {0}\n'.format(arcpy.GetMessages(2))
    # Return python error messages for script tool or Python Window
    arcpy.AddError(pymsg)
    arcpy.AddError(msgs)

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

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

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

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