Растр в мультиточки (3D Analyst)

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

Конвертирует центры ячеек растра в 3D мультиточечные объекты, значения Z которых отражают значение ячейки растра.

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

  • Воспользуйтесь этим инструментом, если у вас имеются растровые данные высот и необходим доступ к функциям, предоставляемым триангуляционной поверхностью, например, загрузка мультиточечных объектов в TIN или набор данных terrain.

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

    • Допуск Z — прореживание ячеек с сохранением точности по вертикали.
    • Ядро — прореживание ячеек с контролем расстояния выборки по горизонтали.
    • VIP - используйте этот метод, если полученные мультиточки предназначены, в основном, для визуализации. Этот метод является относительно быстрым, с его помощью выводится прогнозируемое количество точек и идентифицируются локальные вершины и понижения. Однако он чувствителен к шуму и может игнорировать топографические объекты, экстент которых больше, чем область 3х3 ячейки.
    • Гистограмма VIP - используйте эту опцию как начальный шаг при применении метода VIP, т.к. при этом создается гистограмма значимости, позволяющая узнать, сколько точек будет выбираться при каждом следующем значении процентного соотношения.

Параметры

ПодписьОписаниеТип данных
Входной растр

Растр, который будет обрабатываться.

Raster Layer; Mosaic Layer
Выходной класс объектов

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

Feature Class
Выходная таблица VIP
(Дополнительный)

Таблица гистограммы, которая будет создана, если Гистограмма VIP задана для параметра Метод прореживания.

Таблица гистограммы, которая будет создана, если VIP_HISTOGRAM задана для параметра method.

Table
Метод прореживания
(Дополнительный)

Метод прореживания, применяемый к входному растру для выбора поднабора ячеек, которые будут экспортированы в класс мультиточечных объектов.

  • Без прореживанияПрореживание не применяется. Это значение по умолчанию
  • Допуск ZЭкспортируются только точки, необходимые для сохранения поверхности в пределах заданного диапазона значений Z входного растра.
  • ЯдроРастр будет разделен на листы равного размера, на основании настройки параметра Значение прореживания, и одна или две ячейки, соответствующие значению параметра Метод ядра будут экспортированы.
  • VIPДля создания 3D поверхности наилучшего соответствия будет использовано скользящее окно размером 3х3 ячейки. Каждой ячейке присваивается оценка значимости, основанная на абсолютном отклонении от этой поверхности. Гистограмма этих оценок используется для определения экспортируемых ячеек на основе установки параметра Значение прореживания.
  • Гистограмма VIPБудет создана таблица, содержащая значения значимости и соответствующие количества точек, связанные с этими значениями.
String
Метод ядер
(Дополнительный)

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

  • МинимумТочка создается в ячейке с наименьшим значением высоты в окрестности ядра. Это значение по умолчанию
  • МаксимумТочка создается в ячейке с наибольшим значением высоты в окрестности ядра.
  • Минимум и максимумДве точки создаются в ячейках с наименьшим и наибольшим Z-значениями в окрестности ядра.
  • Ближайший к среднемуТочка создается в ячейке, значение высоты которой находится ближе всего к среднему значению ячеек в окрестности ядра.
String
Коэффициент Z
(Дополнительный)

Коэффициент, на который будут умножаться z-значения. Этот способ обычно используется для конвертации линейных z-единиц для соответствия линейным единицам x,y. Значение по умолчанию равно 1, при нем значения высоты не изменяются. Этот параметр недоступен, если пространственная привязка входной поверхности имеет z-датум с указанными линейными единицами.

Double
Значение прореживания
(Дополнительный)

Значение прореживания, связанное со значением параметра Метод прореживания.

  • Допуск Z – максимально допустимая разница в единицах измерения z между входным растром и поверхностью, созданной по выходному классу мультиточечных объектов. По умолчанию z-допуск составляет 1/10 диапазона z входного растра.
  • Плотность ядер – число ячеек растра вдоль ребра каждого листа. Значение по умолчанию - 3, то есть растр будет разделен на окна размером 3х3 ячейки.
  • VIP – процентильный ранг по гистограмме значимости. По умолчанию используется значение 5.0, это означает, что экспортируются ячейки с оценкой значимости в пределах верхних 5% гистограммы.
Double

arcpy.ddd.RasterToMultipoint(in_raster, out_feature_class, {out_vip_table}, {method}, {kernel_method}, {z_factor}, {thinning_value})
ИмяОписаниеТип данных
in_raster

Растр, который будет обрабатываться.

Raster Layer; Mosaic Layer
out_feature_class

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

Feature Class
out_vip_table
(Дополнительный)

Таблица гистограммы, которая будет создана, если Гистограмма VIP задана для параметра Метод прореживания.

Таблица гистограммы, которая будет создана, если VIP_HISTOGRAM задана для параметра method.

Table
method
(Дополнительный)

Метод прореживания, применяемый к входному растру для выбора поднабора ячеек, которые будут экспортированы в класс мультиточечных объектов.

  • NO_THINПрореживание не применяется. Это значение по умолчанию
  • ZTOLERANCEЭкспортируются только точки, необходимые для сохранения поверхности в пределах заданного диапазона значений Z входного растра.
  • KERNELРастр будет разделен на листы равного размера, на основании настройки параметра Значение прореживания, и одна или две ячейки, соответствующие значению параметра Метод ядра будут экспортированы.
  • VIPДля создания 3D поверхности наилучшего соответствия будет использовано скользящее окно размером 3х3 ячейки. Каждой ячейке присваивается оценка значимости, основанная на абсолютном отклонении от этой поверхности. Гистограмма этих оценок используется для определения экспортируемых ячеек на основе установки параметра Значение прореживания.
  • VIP_HISTOGRAMБудет создана таблица, содержащая значения значимости и соответствующие количества точек, связанные с этими значениями.
String
kernel_method
(Дополнительный)

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

  • MINТочка создается в ячейке с наименьшим значением высоты в окрестности ядра. Это значение по умолчанию
  • MAXТочка создается в ячейке с наибольшим значением высоты в окрестности ядра.
  • MINMAXДве точки создаются в ячейках с наименьшим и наибольшим Z-значениями в окрестности ядра.
  • MEANТочка создается в ячейке, значение высоты которой находится ближе всего к среднему значению ячеек в окрестности ядра.
String
z_factor
(Дополнительный)

Коэффициент, на который будут умножаться z-значения. Этот способ обычно используется для конвертации линейных z-единиц для соответствия линейным единицам x,y. Значение по умолчанию равно 1, при нем значения высоты не изменяются. Этот параметр недоступен, если пространственная привязка входной поверхности имеет z-датум с указанными линейными единицами.

Double
thinning_value
(Дополнительный)

Значение прореживания, связанное со значением параметра method.

  • ZTolerance – максимально допустимая разница в единицах измерения z между входным растром и поверхностью, созданной по выходному классу мультиточечных объектов. По умолчанию z-допуск составляет 1/10 диапазона z входного растра.
  • KERNEL – число ячеек растра вдоль ребра каждого листа. Значение по умолчанию - 3, то есть растр будет разделен на окна размером 3х3 ячейки.
  • VVIP – процентильный ранг по гистограмме значимости. По умолчанию используется значение 5.0, это означает, что экспортируются ячейки с оценкой значимости в пределах верхних 5% гистограммы.
Double

Пример кода

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

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

arcpy.env.workspace = "C:/data"
arcpy.ddd.RasterToMultipoint("elevation.tif", out_vip_table="elev_VIP.dbf", 
                            method="VIP_HISTOGRAM", z_factor=1)
RasterToMultipoint, пример 2 (автономный скрипт)

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

'''*********************************************************************
Name: RasterToMultipoint Example
Description: This script demonstrates how to use
             the RasterToMultipoint tool to create multipoint datasets
             fot all IMG rasters in a target workspace.
**********************************************************************'''
# Import system modules
import arcpy

# Set default workspace
arcpy.env.workspace = "C:/data"
# Create the list of IMG rasters
rasterList = arcpy.ListRasters("*", "IMG")
# Loop the process for each raster
if rasterList:
    for raster in rasterList:
        # Set Local Variables
        # [:-4] strips the last 4 characters (.img) from the raster name
        outTbl = "VIP_" + raster[:-4] + ".dbf"
        method = "VIP_HISTOGRAM"
        zfactor = 1
        #Execute RasterToMultipoint
        arcpy.ddd.RasterToMultipoint(raster, "",outTbl, method, "", zfactor)
else:
    print("There are no IMG rasters in the " + env.workspace + " directory.")

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