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

Краткая информация
Иллюстрация
Использование
Синтаксис
Пример кода
Параметры среды
Информация о лицензиях

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

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

Иллюстрация

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

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

Синтаксис

PointFileInformation_3d (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,...]	Один или несколько входных файлов данных точек либо папок для анализа.	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

Пример кода

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)

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

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

ArcGIS Desktop Basic: Требует 3D Analyst
ArcGIS Desktop Standard: Требует 3D Analyst
ArcGIS Desktop Advanced: Требует 3D Analyst

ArcMap

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