Доступно с лицензией Spatial Analyst.
Краткая информация
Извлекает значения ячеек в местах, соответствующих классу точечных объектов, одного или нескольких растров и сохраняет значения в таблицу атрибутов класса точечных объектов.
Использование
В качестве входных данных могут быть заданы любые комбинации растров (одноканальные или многоканальные).
Значение ячейки будет извлечено для каждого входного растра, а новое поле, содержащее значения ячеек для каждого входного растра, присоединяются к входному классу точечных объектов.
Имена выходных полей по умолчанию создаются по имени входного растра; иначе вы можете указать уникальное имя для каждого поля, хранящего значения растра.
Если входные данные – многоканальный растр, поле будет добавлено для всех каналов с префиксом b1_, b2_, …bn, добавляемым к имени выходного поля, содержащего число каналов.
Опция интерполяции определяет порядок получения значений из растра. По умолчанию используется значение центра создаваемой ячейки. Для получения значения центра ячейки будет использоваться билинейная интерполяция.
Форматы шейп-файлов имеют ограничения длины поля – максимум 10 символов. Выходные поля, присоединяемые к входному шейп-файлу, будут обрезаны и станут уникальными по умолчанию. Если имена длинные или очень похожие, это может затруднить различение между входными данными. В этом случае предлагается конвертировать входные объекты в файловую базу геоданных, а затем использовать их в качестве входных данных.
Ячейкам со значением NoData в растре значений будет дано значение NULL. Для шейп-файлов значение NULL не поддерживается, и будет дано значение 0 (ноль).
Наборы мультиточечных данных не поддерживаются в качестве входных.
См. раздел Среда анализа и Spatial Analyst для получения дополнительной информации о среде геообработки данного инструмента.
Синтаксис
ExtractMultiValuesToPoints (in_point_features, in_rasters, {bilinear_interpolate_values})| Параметр | Объяснение | Тип данных |
in_point_features | Входные точечные объекты, к которым вы хотите добавить значения растра. | Feature Layer |
in_rasters [[Raster, {Output Field Name}],...] | Значения входного растра (или растров), которые вы хотите извлечь на основе местоположения входного точечного объекта. Дополнительно, вы можете указать имя для поля для хранения значения растра. По умолчанию будет создано уникальное имя поля на основе имени входного набора растровых данных. | Value Table |
bilinear_interpolate_values (дополнительно) | Определяет, будет ли использоваться интерполяция.
| Boolean |
Пример кода
ExtractMultiValuesToPoints Пример 1 (окно Python)
Значения ячеек извлекаются из нескольких растров в атрибуты класса точечных объектов шейп-файлов.
import arcpy
from arcpy.sa import *
from arcpy import env
env.workspace = "c:/sapyexamples/data"
ExtractMultiValuesToPoints("observers.shp", [["elevation", "ELEV"],
["costraster", "COST"], ["flowdir", "DIR"]], "NONE")
ExtractMultiValuesToPoints, пример 2 (автономный скрипт)
Значения ячеек извлекаются из нескольких растров в атрибуты класса точечных объектов шейп-файлов, используя интерполяцию.
# Name: ExtractMultiValuesToPoints_Ex_02.py
# Description: Extracts the cells of multiple rasters as attributes in
# an output point feature class. This example takes a multiband IMG
# and two GRID files as input.
# Requirements: Spatial Analyst Extension
# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *
# Set environment settings
env.workspace = "C:/sapyexamples/data"
# Set local variables
inPointFeatures = "poi.shp"
inRasterList = [["doqq.img", "doqqval"], ["redstd", "focalstd"],
["redmin", "focalmin"]]
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute ExtractValuesToPoints
ExtractMultiValuesToPoints(inPointFeatures, inRasterList, "BILINEAR")