Добавить информацию поверхности (3D Analyst)

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

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

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

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

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

  Геометрия объекта	Свойства поверхности
  Точка	Отметка высоты, интерполированная из x,y-координат точки на поверхности.
  Мультиточка	Минимум, максимум и среднее значение отметки высоты для всех точек в записи мультиточки
  Полилиния	3D-расстояние линии по поверхности Минимум, максимум и среднее значение высоты и уклона линии по поверхности
  Полигон	3D-площадь поверхности, перекрывающей полигон Минимум, максимум и среднее значение высоты и уклона по поверхности

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

  • Минимальный уклон получается от сегмента, значение которого ближе всего к 0, или горизонтального.
  • Максимальный уклон получается из сегмента с наибольшим расчетным значением.
  • Средний уклон полилинии получается из среднего взвешенного уклона от каждого линейного сегмента. Взвешивание основано на 3D-длине каждого сегмента. Это приводит к тому, что более длинные сегменты сильнее влияют на итоговое вычисление по сравнению с более короткими сегментами.

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

Параметры

Диалог

Подпись	Описание	Тип данных
Входные объекты	Точечные, мультиточечные, линейные или полигональные объекты, задающие местоположения для определения одного или нескольких свойств поверхности.	Feature Layer
Входная поверхность	Набор данных LAS, мозаика, растровая, TIN-поверхность или поверхность terrain, использованная для интерполяции z-значений.	LAS Dataset Layer; Mosaic Layer; Raster Layer; Terrain Layer; TIN Layer
Выходное свойство	Указывает свойство высоты поверхности, которое добавляется в таблицу атрибутов входного класса объектов. Z—Будут добавлены z-значения поверхности, интерполированные для x,y-положения каждого отдельного точечного объекта. Минимум Z—Будут добавлены самые низкие z-значения поверхности на площади, заданной полигоном, вдоль линии или среди интерполированных значений для точек в записи мультиточки. Максимум Z—Будет добавлена наибольшая высота поверхности на площади, заданной полигоном, вдоль линии или среди интерполированных значений для точек в записи мультиточки. Среднее Z—Будет добавлена средняя высота поверхности площади, заданной полигоном, вдоль линии или среди интерполированных значений для точек в записи мультиточки. Площадь поверхности—Будет добавлена 3D-площадь поверхности для региона, заданного каждым полигоном. Длина по поверхности—Будет добавлено 3D-расстояние линии по поверхности. Минимальный уклон—Будет добавлено самое близкое к нулю значение уклона вдоль линии или внутри области, заданной полигоном. Максимальный уклон—Будет добавлено самое высокое значение уклона вдоль линии или внутри области, заданной полигоном. Средний уклон—Будет добавлено среднее значение уклона вдоль линии или внутри области, заданной полигоном.	String
Метод (Дополнительный)	Задает метод интерполяции, используемый для определения информации о поверхности. Билинейный—Метод интерполяции применяется исключительно к растровой поверхности, при котором значения ячеек определяются из четырех ближайших ячеек. Это единственная доступная опция для растровой поверхности. Линейный—Высота будет получена из плоскости, которая определяется треугольником, содержащим x,y-расположение запрашиваемой точки. Это метод интерполяции по умолчанию для TIN, наборов данных terrains и наборов данных LAS. Естественная окрестность—Высота будет получена путем применения взвешивания на основе площади к естественной окрестности запрашиваемой точки. Объединить мин. z—Высота будет получена из наименьшего z-значения, найденного в естественной окрестности запрашиваемой точки. Объединить макс. z—Высота будет получена из наибольшего z-значения в естественной окрестности запрашиваемой точки. Объединить ближайшие Z—Высота будет получена из ближайшего значения в естественной окрестности запрашиваемой точки. Объединить ближайшие к среднему Z—Высота будет получена из z--значения, которое ближе всего к среднему из всех естественных окрестностей запрашиваемой точки.	String
Расстояние разбиения (Дополнительный)	Интервал, по которому будут интерполированы Z-значения. По умолчанию, используется размер ячейки растра, если входной поверхностью является растр, и используется естественное сгущение триангулированной поверхности, если входными данными является набор данных terrain или TIN.	Double
Коэффициент Z (Дополнительный)	Коэффициент, на который будут умножаться z-значения. Этот способ обычно используется для конвертации линейных z-единиц для соответствия линейным единицам x,y. Значение по умолчанию равно 1, при нем значения высоты не изменяются. Этот параметр недоступен, если пространственная привязка входной поверхности имеет Z датум с указанными линейными единицами.	Double
Разрешение уровня пирамидных слоев (Дополнительный)	Z-допуск или разрешение размера окна для уровня пирамидных слоев Terrain, которое будет использоваться. Значением по умолчанию является 0, полное разрешение.	Double
Фильтрация шума (Дополнительный)	Указывает, будут ли участки поверхности, характеризующиеся потенциально аномальными измерениями, исключаться из участия в вычислении уклона. Этот параметр не влияет на другие свойства. Линейные объекты предлагают фильтр длины, в котором линейные сегменты с 3D-длиной меньше указанного значения, исключаются из расчетов уклона. Полигональные объекты предлагают фильтр площади, в котором полигоны, охватывающие площадь поверхности меньше указанного значения, исключаются.	String

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

Подпись	Описание	Тип данных
Обновленные входные объекты	Обновленные входные объекты.	Feature Layer

Python

arcpy.ddd.AddSurfaceInformation(in_feature_class, in_surface, out_property, {method}, {sample_distance}, {z_factor}, {pyramid_level_resolution}, {noise_filtering})

Имя	Описание	Тип данных
in_feature_class	Точечные, мультиточечные, линейные или полигональные объекты, задающие местоположения для определения одного или нескольких свойств поверхности.	Feature Layer
in_surface	Набор данных LAS, мозаика, растровая, TIN-поверхность или поверхность terrain, использованная для интерполяции z-значений.	LAS Dataset Layer; Mosaic Layer; Raster Layer; Terrain Layer; TIN Layer
out_property [out_property,...]	Указывает свойство высоты поверхности, которое добавляется в таблицу атрибутов входного класса объектов. Z—Будут добавлены z-значения поверхности, интерполированные для x,y-положения каждого отдельного точечного объекта. Z_MIN—Будут добавлены самые низкие z-значения поверхности на площади, заданной полигоном, вдоль линии или среди интерполированных значений для точек в записи мультиточки. Z_MAX—Будет добавлена наибольшая высота поверхности на площади, заданной полигоном, вдоль линии или среди интерполированных значений для точек в записи мультиточки. Z_MEAN—Будет добавлена средняя высота поверхности площади, заданной полигоном, вдоль линии или среди интерполированных значений для точек в записи мультиточки. SURFACE_AREA—Будет добавлена 3D-площадь поверхности для региона, заданного каждым полигоном. SURFACE_LENGTH—Будет добавлено 3D-расстояние линии по поверхности. MIN_SLOPE—Будет добавлено самое близкое к нулю значение уклона вдоль линии или внутри области, заданной полигоном. MAX_SLOPE—Будет добавлено самое высокое значение уклона вдоль линии или внутри области, заданной полигоном. AVG_SLOPE—Будет добавлено среднее значение уклона вдоль линии или внутри области, заданной полигоном.	String
method (Дополнительный)	Задает метод интерполяции, используемый для определения информации о поверхности. BILINEAR—Метод интерполяции применяется исключительно к растровой поверхности, при котором значения ячеек определяются из четырех ближайших ячеек. Это единственная доступная опция для растровой поверхности. LINEAR—Высота будет получена из плоскости, которая определяется треугольником, содержащим x,y-расположение запрашиваемой точки. Это метод интерполяции по умолчанию для TIN, наборов данных terrains и наборов данных LAS. NATURAL_NEIGHBORS—Высота будет получена путем применения взвешивания на основе площади к естественной окрестности запрашиваемой точки. CONFLATE_ZMIN—Высота будет получена из наименьшего z-значения, найденного в естественной окрестности запрашиваемой точки. CONFLATE_ZMAX—Высота будет получена из наибольшего z-значения в естественной окрестности запрашиваемой точки. CONFLATE_NEAREST—Высота будет получена из ближайшего значения в естественной окрестности запрашиваемой точки. CONFLATE_CLOSEST_TO_MEAN—Высота будет получена из z--значения, которое ближе всего к среднему из всех естественных окрестностей запрашиваемой точки.	String
sample_distance (Дополнительный)	Интервал, по которому будут интерполированы Z-значения. По умолчанию, используется размер ячейки растра, если входной поверхностью является растр, и используется естественное сгущение триангулированной поверхности, если входными данными является набор данных terrain или TIN.	Double
z_factor (Дополнительный)	Коэффициент, на который будут умножаться z-значения. Этот способ обычно используется для конвертации линейных z-единиц для соответствия линейным единицам x,y. Значение по умолчанию равно 1, при нем значения высоты не изменяются. Этот параметр недоступен, если пространственная привязка входной поверхности имеет Z датум с указанными линейными единицами.	Double
pyramid_level_resolution (Дополнительный)	Z-допуск или разрешение размера окна для уровня пирамидных слоев Terrain, которое будет использоваться. Значением по умолчанию является 0, полное разрешение.	Double
noise_filtering (Дополнительный)	Указывает, будут ли участки поверхности, характеризующиеся потенциально аномальными измерениями, исключаться из участия в вычислении уклона. Этот параметр не влияет на другие свойства. Линейные объекты предлагают фильтр длины, в котором линейные сегменты с 3D-длиной меньше указанного значения, исключаются из расчетов уклона. Полигональные объекты предлагают фильтр площади, в котором полигоны, охватывающие площадь поверхности меньше указанного значения, исключаются.	String

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

Имя	Описание	Тип данных
output_feature_class	Обновленные входные объекты.	Feature Layer

Пример кода

AddSurfaceInformation, пример 1 (окно Python)

В следующем примере показано использование этого инструмента в окне Python.

arcpy.env.workspace = "C:/data"
arcpy.AddSurfaceInformation_3d("points.shp", "my_tin", "Z", "LINEAR")

AddSurfaceInformation, пример 2 (автономный скрипт)

В следующем примере показано использование этого инструмента в автономном скрипте Python.

'''*********************************************************************
Name: AddSurfaceInformation Example
Description: This script demonstrates how to use AddSurfaceInformation 
             on all 2D feature classes in a target workspace.
*********************************************************************'''
# Import system modules
import arcpy

# Set Local Variables
arcpy.env.workspace = 'c:/data'
inSurface = 'fgdb.gdb/municipal/terrain'
pyramid = 5
method = "BILINEAR"

# Create list of feature classes
fcList = arcpy.ListFeatureClasses()

if fcList:
    for fc in fcList:
        desc = arcpy.Describe(fc)
        # Determine if the feature is 2D
        if not desc.hasZ:
            if desc.shapeType == "Polygon":
                # Desired properties separated by semi-colons
                Prop = "Z_MIN;Z_MAX" 
            elif desc.shapeType == "Point":
                Prop = "Z"
            elif desc.shapeType == "Multipoint":
                Prop = "Z_MIN;Z_MAX;Z_MEAN"
            elif desc.shapeType == "Polyline":
                Prop = "LENGTH_3D"
            # Execute AddSurfaceInformation
            arcpy.ddd.AddSurfaceInformation(fc, inSurface, Prop, 
                                            method, 15, 1, pyramid)
            print("Completed adding surface information.")

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

Текущая рабочая область, Экстент, Географические преобразования, Автоматическое подтверждение

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

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

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