Краткая информация
Конвертирует центры ячеек растра в 3D мультиточечные объекты, значения Z которых отражают значение ячейки растра.
Использование
Воспользуйтесь этим инструментом, если у вас имеются растровые данные высот и необходим доступ к функциям, предоставляемым триангуляционной поверхностью, например, загрузка мультиточечных объектов в TIN или набор данных terrain.
Если размер входного растра очень большой, рассмотрите возможность прореживания для уменьшения числа ячеек, экспортируемого в класс мультиточечных объектов.
- Метод прореживания Допуск Z (Z Tolerance) используется, когда важно сохранить точность по вертикали.
- Метод прореживания Плотность ядер (Kernel) используется, когда важно контролировать расстояние выборки по горизонтали.
- Используйте метод прореживания VIP, если полученные мультиточки предназначены, в основном, для визуализации. Этот метод является относительно быстрым, с его помощью выводится прогнозируемое количество точек и он удобен при выборе местных вершин и понижений. Однако он чувствителен к шуму и может игнорировать топографические объекты, экстент которых больше, чем область 3х3 ячейки.
- Используйте опцию Гистограмма VIP (VIP Histogram), как начальный шаг при применении метода VIP, т.к. при этом создается гистограмма значимости, позволяющая узнать, сколько точек будет выделяться при каждом следующем значении процентного соотношения.
Синтаксис
RasterToMultipoint_3d (in_raster, out_feature_class, {out_vip_table}, {method}, {kernel_method}, {z_factor})| Параметр | Объяснение | Тип данных |
in_raster | Обрабатываемый растр. | Raster Layer |
out_feature_class | Класс объектов, который будет получен в результате работы инструмента. | Feature Class |
out_vip_table (дополнительно) | Таблица гистограммы, которую необходимо создать, если гистограмма VIP задана для параметра Метод. | Table |
method (дополнительно) | Метод прореживания, применяемый к входному растру для выбора поднабора ячеек, которые будут экспортированы в класс мультиточечных объектов.
| String |
kernel_method (дополнительно) | Метод выборки, используемый в пределах каждой окрестности ядра, когда к входному растру применяется прореживание по методу Плотность ядер.
| String |
z_factor (дополнительно) | Коэффициент, на который будут умножаться Z-значения. Этот способ обычно используется для конвертации линейных Z-единиц для соответствия линейным единицам XY. Значение по умолчанию равно 1, при нем значения высоты не изменяются. | Double |
Пример кода
RasterToMultipoint, пример 1 (окно Python)
В следующем примере показано использование этого инструмента в окне Python.
import arcpy
from arcpy import env
arcpy.CheckOutExtension("3D")
env.workspace = "C:/data"
arcpy.RasterToMultipoint_3d("elevation.tif", "","elev_VIP.dbf", "VIP_HISTOGRAM", "", "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
from arcpy import env
import exceptions
try:
arcpy.CheckOutExtension("3D")
# Set default workspace
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:
"There are no IMG rasters in the " + env.workspace + " directory."
except Exception as e:
# Returns any other error messages
print e.message
Параметры среды
- Текущая рабочая область (Current Workspace)
- Выходная система координат (Output Coordinate System)
- Экстент (Extent)
- Географические преобразования (Geographic Transformations)
- Разрешение XY (XY Resolution)
- Допуск XY (XY Tolerance)
- Разрешение Z (Z Resolution)
- Допуск Z (Z Tolerance)
- Выходной XY домен (Output XY Domain)
- Выходной домен Z (Output Z Domain)
- Выходное ключевое слово CONFIG (Output CONFIG Keyword)
- Автоподтверждение (Auto Commit)
Информация о лицензировании
- ArcGIS for Desktop Basic: Требует 3D Analyst
- ArcGIS for Desktop Standard: Требует 3D Analyst
- ArcGIS for Desktop Advanced: Требует 3D Analyst