Инструмент Извлечь мультизначения в точки (Extract Multi Values to Points) (Spatial Analyst)
Резюме
Извлекает значения ячеек в местоположениях, заданных в классе точечных объектов, из одного или нескольких растров и записывает значения в таблицу атрибутов класса точечных объектов.
Использование
-
В качестве входных данных могут быть заданы любые комбинации растров (одноканальные или многоканальные).
-
Значение ячейки будет извлечено для каждого входного растра, а новое поле, содержащее значения ячеек для каждого входного растра, присоединяются к входному классу точечных объектов.
-
Имена выходных полей создаются из имени входного растра по умолчанию. В противном случае вы можете задать уникальное имя для каждого поля для хранения значений растра.
-
Если входные данные – многоканальный растр, поле будет добавлено для всех каналов с префиксом b1_, b2_, …bn, добавляемым к имени выходного поля, содержащего число каналов.
-
Опция Интерполяция определяет, каким образом будут получены значения из входного растра. По умолчанию используется значение той ячейки, ближе к центру которой расположена входная точка. При использовании интерполяции, для расчета значения будет использована билинейная интерполяция, и значение будет расчитано с учетом значений соседних ячеек.
-
Форматы шейп-файлов имеют ограничения длины поля – 10 символов. Выходные поля, присоединяемые к входному шейп-файлу, будут обрезаны и станут уникальными по умолчанию. Если имена длинные или очень похожие, это может затруднить различение между входными данными. В этом случае предлагается конвертировать пространственные объекты в файловую базу геоданных.
-
Ячейкам со значением NoData в растре значений будет дано нулевое значение (NULL). Для шейп-файлов, NULL не поддерживается, и будет дано значение 0 (нуль).
Наборы данных, состоящие из мультиточек, не поддерживаются в качестве входных данных.
Внимание:Этот инструмент изменяет входные значения. Более подробно о стратегиях предотвращения нежелательного изменения данных см. в разделе Инструменты без выходных данных.
Синтаксис
| Параметр | Объяснение | Тип данных |
in_point_features |
Входные точечные объекты, к которым вы хотите добавить значения растра. | Feature Layer |
in_rasters [[Raster, {Output Field Name}],...] |
Значения входного растра (или растров), которые вы хотите извлечь на основе местоположения входного точечного объекта. Дополнительно, вы можете указать имя для поля для хранения значения растра. По умолчанию будет создано уникальное имя поля на основе имени входного набора растровых данных. | Value Table |
bilinear_interpolate_values (дополнительно) |
Определяет, будет или нет использоваться интерполяция.
| Boolean |
Пример кода
Значения ячеек извлекаются из нескольких растров в атрибуты класса точечных объектов шейп-файлов.
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")
Значения ячеек извлекаются из нескольких растров в атрибуты класса точечных объектов шейп-файлов, используя интерполяцию.
# 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")