Подпись | Описание | Тип данных |
Входной растр | Растр, который будет обрабатываться. | Raster Layer; Mosaic Layer |
Выходной класс объектов | Класс объектов, который будет создан. | Feature Class |
Выходная таблица VIP (Дополнительный) | Таблица гистограммы, которая будет создана, если Гистограмма VIP задана для параметра Метод прореживания. Таблица гистограммы, которая будет создана, если VIP_HISTOGRAM задана для параметра method. | Table |
Метод прореживания (Дополнительный) | Метод прореживания, применяемый к входному растру для выбора поднабора ячеек, которые будут экспортированы в класс мультиточечных объектов.
| String |
Метод ядер (Дополнительный) | Указывает метод выборки, используемый в пределах каждой окрестности ядра, когда к входному растру применяется прореживание по методу керн-функции.
| String |
Коэффициент Z (Дополнительный) | Коэффициент, на который будут умножаться z-значения. Этот способ обычно используется для конвертации линейных z-единиц для соответствия линейным единицам x,y. Значение по умолчанию равно 1, при нем значения высоты не изменяются. Этот параметр недоступен, если пространственная привязка входной поверхности имеет z-датум с указанными линейными единицами. | Double |
Значение прореживания (Дополнительный) | Значение прореживания, связанное со значением параметра Метод прореживания.
| Double |
Краткая информация
Конвертирует центры ячеек растра в 3D мультиточечные объекты, значения Z которых отражают значение ячейки растра.
Использование
Воспользуйтесь этим инструментом, если у вас имеются растровые данные высот и необходим доступ к функциям, предоставляемым триангуляционной поверхностью, например, загрузка мультиточечных объектов в TIN или набор данных terrain.
Если размер Входного растра очень большой, рассмотрите возможность указания Метода прореживания для уменьшения числа ячеек, экспортируемого в класс мультиточечных объектов. Можно выбрать следующие опции:
- Допуск Z — прореживание ячеек с сохранением точности по вертикали.
- Ядро — прореживание ячеек с контролем расстояния выборки по горизонтали.
- VIP - используйте этот метод, если полученные мультиточки предназначены, в основном, для визуализации. Этот метод является относительно быстрым, с его помощью выводится прогнозируемое количество точек и идентифицируются локальные вершины и понижения. Однако он чувствителен к шуму и может игнорировать топографические объекты, экстент которых больше, чем область 3х3 ячейки.
- Гистограмма VIP - используйте эту опцию как начальный шаг при применении метода VIP, т.к. при этом создается гистограмма значимости, позволяющая узнать, сколько точек будет выбираться при каждом следующем значении процентного соотношения.
Параметры
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 (Дополнительный) | Метод прореживания, применяемый к входному растру для выбора поднабора ячеек, которые будут экспортированы в класс мультиточечных объектов.
| String |
kernel_method (Дополнительный) | Указывает метод выборки, используемый в пределах каждой окрестности ядра, когда к входному растру применяется прореживание по методу керн-функции.
| String |
z_factor (Дополнительный) | Коэффициент, на который будут умножаться z-значения. Этот способ обычно используется для конвертации линейных z-единиц для соответствия линейным единицам x,y. Значение по умолчанию равно 1, при нем значения высоты не изменяются. Этот параметр недоступен, если пространственная привязка входной поверхности имеет z-датум с указанными линейными единицами. | Double |
thinning_value (Дополнительный) | Значение прореживания, связанное со значением параметра method.
| Double |
Пример кода
В следующем примере показано использование этого инструмента в окне Python.
arcpy.env.workspace = "C:/data"
arcpy.ddd.RasterToMultipoint("elevation.tif", out_vip_table="elev_VIP.dbf",
method="VIP_HISTOGRAM", z_factor=1)
В следующем примере показано использование этого инструмента как автономного скрипта 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.")