ArcMap

Растр в мультиточки

Сводка

Конвертирует центры ячеек растра в 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})
ПараметрОбъяснениеТип данных
in_raster

Обрабатываемый растр.

Raster Layer; Mosaic Layer
out_feature_class

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

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

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

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

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

  • NO_THIN —Прореживание не применяется. Используется по умолчанию.
  • ZTOLERANCE <value> —Экспортируются точки, необходимые для сохранения поверхности с соответствующим Z-диапазоном входного растра. Соответствующие значения отражают максимально допустимую разницу в единицах измерения z между входным растром и поверхностью, созданной по выходному классу мультиточечных объектов. При выборе этого метода, значение прореживания по умолчанию составляет одну десятую z-диапазона входного растра.
  • KERNEL <value> —Делит растр на равные листы, в соответствии с значением прореживания, затем выбирает одну или две ячейки, которые соответствуют критериям выбранного метода ядер. По умолчанию используется значение 3, это значит, что растр будет разделен на окна размером 3х3 ячейки.
  • VIP <value> —Включает плавающее окно размером 3х3 ячейки, которое используется для создания 3-мерной поверхности наилучшего соответствия. Каждой ячейке присваивается оценка значимости, основанная на абсолютном отклонении от этой поверхности. Гистограмма этих оценок затем используется при определении ячеек, которые следует экспортировать. Соответствующее значение отражает процентильный ранг по гистограмме значимости. По умолчанию используется значение 5.0, это означает, что экспортируются ячейки с оценкой значимости в пределах верхних 5% гистограммы.
  • VIP_HISTOGRAM —Создает таблицу для просмотра фактических значений значимости и соответствующего количества точек, связанных с этими значениями.
String
kernel_method
(Дополнительный)

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

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

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

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

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

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

  • Basic: Требуется 3D Analyst
  • Standard: Требуется 3D Analyst
  • Advanced: Требуется 3D Analyst

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