Конвертирует центры ячеек растра в 3D мультиточечные объекты, значения Z которых отражают значение ячейки растра.
Использование
Воспользуйтесь этим инструментом, если у вас имеются растровые данные высот и необходим доступ к функциям, предоставляемым триангуляционной поверхностью, например, загрузка мультиточечных объектов в TIN или набор данных terrain.
Если размер Входного растра очень большой, рассмотрите возможность указания Метода прореживания для уменьшения числа ячеек, экспортируемого в класс мультиточечных объектов. Можно выбрать следующие опции:
Допуск Z—прореживание ячеек с сохранением точности по вертикали.
Ядро—прореживание ячеек с контролем расстояния выборки по горизонтали.
VIP—используйте этот метод, если полученные мультиточки предназначены, в основном, для визуализации. Этот метод является относительно быстрым, с его помощью выводится прогнозируемое количество точек и идентифицируются локальные вершины и понижения. Однако он чувствителен к шуму и может игнорировать топографические объекты, экстент которых больше, чем область 3х3 ячейки.
Гистограмма VIP—используйте эту опцию как начальный шаг при применении метода VIP, т.к. при этом создается гистограмма значимости, позволяющая узнать, сколько точек будет выбираться при каждом следующем значении процентного соотношения.
Таблица гистограммы, которая будет создана, если Гистограмма VIP задана для параметра Метод прореживания.
Таблица гистограммы, которая будет создана, если VIP_HISTOGRAM задана для параметра method.
Table
Метод прореживания
(Дополнительный)
Метод прореживания, применяемый к входному растру для выбора поднабора ячеек, которые будут экспортированы в класс мультиточечных объектов.
No Thinning–No thinning will be applied. This is the default.
Z Tolerance–Only the cells that are required for maintaining a surface within a specified z-range of the input raster will be exported.
Kernel–The raster will be divided into equal-sized tiles based on the Thinning Value parameter value, and one or two cells that meet the Kernel Method parameter value will be exported.
VIP–A roving 3-cell-by-3-cell window will be used to create a three-dimensional best fit plane. Each cell is given a significance score based on its absolute deviation from this plane. A histogram of these scores is then used to determine the cells that will be exported based on the Thinning Value parameter value.
VIP Histogram–A table will be created containing the significance values and the corresponding number of points associated with those values.
String
Метод ядер
(Дополнительный)
Указывает метод выборки, используемый в пределах каждой окрестности ядра, когда к входному растру применяется прореживание по методу керн-функции.
Minimum–A point will be created at the cell with the smallest elevation value found in the kernel neighborhood. This is the default.
Maximum–A point will be created at the cell with the largest elevation value found in the kernel neighborhood.
Minimum and Maximum–Two points will be created at the cells with the smallest and largest z-values found in the kernel neighborhood.
Closest to Mean–A point will be created at the cell whose elevation value is closest to the average of the cells in the kernel neighborhood.
String
Коэффициент Z
(Дополнительный)
Коэффициент, на который будут умножаться z-значения. Этот способ обычно используется при конвертации линейных z-единиц для соответствия линейным единицам x,y. Значение по умолчанию равно 1, при нем значения высоты не изменяются. Этот параметр не доступен, если пространственная привязка входной поверхности имеет z-датум с заданными линейными единицами измерения.
Double
Значение прореживания
(Дополнительный)
Значение прореживания, связанное со значением параметра Метод прореживания.
Допуск Z—максимально допустимая разница в единицах измерения z между входным растром и поверхностью, созданной по выходному классу мультиточечных объектов. По умолчанию z-допуск составляет 1/10 диапазона z входного растра.
Плотность ядер—число ячеек растра вдоль ребра каждого листа. Значение по умолчанию - 3, то есть растр будет разделен на окна размером 3х3 ячейки.
VIP—процентильный ранг по гистограмме значимости. По умолчанию используется значение 5.0, это означает, что экспортируются ячейки с оценкой значимости в пределах верхних 5% гистограммы.
Таблица гистограммы, которая будет создана, если Гистограмма VIP задана для параметра Метод прореживания.
Таблица гистограммы, которая будет создана, если VIP_HISTOGRAM задана для параметра method.
Table
method
(Дополнительный)
Метод прореживания, применяемый к входному растру для выбора поднабора ячеек, которые будут экспортированы в класс мультиточечных объектов.
NO_THIN–No thinning will be applied. This is the default.
ZTOLERANCE–Only the cells that are required for maintaining a surface within a specified z-range of the input raster will be exported.
KERNEL–The raster will be divided into equal-sized tiles based on the Thinning Value parameter value, and one or two cells that meet the Kernel Method parameter value will be exported.
VIP–A roving 3-cell-by-3-cell window will be used to create a three-dimensional best fit plane. Each cell is given a significance score based on its absolute deviation from this plane. A histogram of these scores is then used to determine the cells that will be exported based on the Thinning Value parameter value.
VIP_HISTOGRAM–A table will be created containing the significance values and the corresponding number of points associated with those values.
String
kernel_method
(Дополнительный)
Указывает метод выборки, используемый в пределах каждой окрестности ядра, когда к входному растру применяется прореживание по методу керн-функции.
MIN–A point will be created at the cell with the smallest elevation value found in the kernel neighborhood. This is the default.
MAX–A point will be created at the cell with the largest elevation value found in the kernel neighborhood.
MINMAX–Two points will be created at the cells with the smallest and largest z-values found in the kernel neighborhood.
MEAN–A point will be created at the cell whose elevation value is closest to the average of the cells in the kernel neighborhood.
String
z_factor
(Дополнительный)
Коэффициент, на который будут умножаться z-значения. Этот способ обычно используется при конвертации линейных z-единиц для соответствия линейным единицам x,y. Значение по умолчанию равно 1, при нем значения высоты не изменяются. Этот параметр не доступен, если пространственная привязка входной поверхности имеет z-датум с заданными линейными единицами измерения.
Double
thinning_value
(Дополнительный)
Значение прореживания, связанное со значением параметра method.
ZTolerance—Максимально допустимая разница в единицах измерения z между входным растром и поверхностью, созданной по выходному классу мультиточечных объектов. По умолчанию z-допуск составляет 1/10 диапазона z входного растра.
KERNEL—Число ячеек растра вдоль ребра каждого листа. Значение по умолчанию - 3, то есть растр будет разделен на окна размером 3х3 ячейки.
VIP—Процентильный ранг по гистограмме значимости. По умолчанию используется значение 5.0, это означает, что экспортируются ячейки с оценкой значимости в пределах верхних 5% гистограммы.
Double
Пример кода
RasterToMultipoint, пример 1 (окно Python)
В следующем примере показано использование этого инструмента в окне Python:
В следующем примере показано использование этого инструмента в автономном скрипте 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
# Run RasterToMultipoint
arcpy.ddd.RasterToMultipoint(raster, "", outTbl, method, "", zfactor)
else:
print("There are no IMG rasters in the " + arcpy.env.workspace + " directory.")