Доступно с лицензией Spatial Analyst.
Краткая информация
Извлекает значения ячеек в местах, соответствующих классу точечных объектов, одного или нескольких растров и сохраняет значения в таблицу атрибутов класса точечных объектов.
Использование
Это инструмент изменяет входные точечные объекты и может сменить внутренний ID объекта, которым может быть ObjectID, FID или OID. Рекомендуется, чтобы поле ID уже было в таблице атрибутов перед началом анализа.
Значения ячеек будут извлекаться из всех входных растров в каждом местоположении. Новое поле, содержащее значения ячеек каждого входного растра, будет присоединено к входному классу точечных объектов.
Дополнительные атрибуты из таблицы входного растра, если есть, не присоединяются к входным точечным объектам.
Входные растры не будут пересчитываться с учетом параметра среды. Вместо этого, значения ячеек извлекаются из всех входных растров со своим оригинальным разрешением и пространственной привязкой с помощью проекции входных местоположений в пространственную привязку растра, по которому извлекаются значения.
Однако параметр среды анализа применяется ко входным местоположениям.
Местоположениям, которые извлекают значения из ячеек NoData во входном растре, в выходной таблице будет присвоено значение <null>. Для шейп-файлов, поскольку поля null не поддерживаются, ячейки NoData записываются в таблицу со значениями -9999.
Формат шейп-файла имеет ограничение на максимальную длину имени поля в 10 символов. В результате, имена всех полей, присоединяемых к атрибутивной таблице входного шейп-файла, будут по умолчанию сокращены и сделаны уникальными. Если имена длинные или похожие, это может затруднить различение таких полей. В этом случае предлагается скопировать входной шейп-файл в файловую базу геоданных, а затем использовать для анализа класс объектов.
Если Входные точечные объекты (in_point_features в Python) заданы с помощью слоя событий XY, базовая таблица событий обновляется напрямую. Инструмент не сможет работать, если базовая таблица имеет атрибут только для чтения.
Инструмент не сможет работать с мультиточечными объектами. Для выполнения анализа с мультиточечными объектами, сначала конвертируйте их в точечные объекты, перед запуском инструмента извлечения. Дополнительные сведения см. в разделе, касающемся обработки мультиточечных данных.
В качестве Входных растров (in_rasters в Python) могут быть заданы любые комбинации растров (одноканальные или многоканальные).
Если многоканальный растр указан как один из входных для параметра Входной растр (in_rasters в Python), будут обработаны все каналы.
Чтобы обработать выбранные каналы входного многоканального растра, сначала создайте новый набор растровых данных, состоящий только из необходимых каналов, с помощью инструмента Объединить каналы. Затем укажите полученный набор в списке входных растров.
Если входные данные – многоканальный растр, для всех каналов будет добавлено поле с префиксом b1_, b2_, …bn, добавляемым к имени выходного поля, содержащего число каналов.
Имена выходных полей по умолчанию создаются по имени входного растра; иначе вы можете указать уникальное имя для каждого поля, хранящего значения растра.
Опция интерполяции определяет порядок получения значений из растра. По умолчанию извлекаются точные значения ячеек во входных местоположениях. Для извлечения интерполированных значений, используя билинейную интерполяцию, используйте опцию Билинейная интерполяция значений в местоположениях точек. В Python следует задать параметру bilinear_interpolate_values значение BILINEAR.
Если объект указан в параметре среды Маска, внутренний растр создается с использованием минимального размера ячейки входных растров. Во время извлечения, внутрениий растр маски снова пересчитывается в размер ячейки входного растра.
См. раздел Среда анализа и Spatial Analyst для получения дополнительной информации о среде геообработки данного инструмента.
Синтаксис
ExtractMultiValuesToPoints(in_point_features, in_rasters, {bilinear_interpolate_values})| Параметр | Объяснение | Тип данных |
in_point_features | Входные точечные объекты, к которым вы хотите добавить значения растра. | Feature Layer |
in_rasters [Raster, {Output Field Name}] | Значения входного растра (или растров), которые вы хотите извлечь на основе местоположения входного точечного объекта. Дополнительно, вы можете указать имя для поля для хранения значения растра. По умолчанию будет создано уникальное имя поля на основе имени входного набора растровых данных. | Extract Values |
bilinear_interpolate_values (Дополнительный) | Определяет, будет ли использоваться интерполяция.
| Boolean |
Производные выходные данные
| Имя | Объяснение | Тип данных |
| out_point_features | Обновленные точечные объекты. | Класс пространственных объектов |
Пример кода
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")
Параметры среды
Информация о лицензиях
- Basic: Требуется Spatial Analyst
- Standard: Требуется Spatial Analyst
- Advanced: Требуется Spatial Analyst