Извлечь мультизначения в точки (Spatial Analyst)

Доступно с лицензией 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 для получения дополнительной информации о среде геообработки данного инструмента.

Параметры

ПодписьОписаниеТип данных
Входные точечные объекты

Входные точечные объекты, к которым вы хотите добавить значения растра.

Feature Layer
Входные растры

Значения входного растра (или растров), которые вы хотите извлечь на основе местоположения входного точечного объекта.

Дополнительно, вы можете указать имя для поля для хранения значения растра. По умолчанию будет создано уникальное имя поля на основе имени входного набора растровых данных.

Extract Values
Билинейная интерполяция значений в местоположениях точек
(Дополнительный)

Определяет, будет ли использоваться интерполяция.

  • Не отмечено – интерполяция не применяется, используется значение центра ячейки. Используется по умолчанию.
  • Отмечено – извлекаемое значение вычисляется с использованием значений смежных ячеек с применением билинейной интерполяции. Значения NoData игнорируются при интерполяции, за исключением тех случаев, когда все смежные ячейки содержат значения NoData.
Boolean

Производные выходные данные

ПодписьОписаниеТип данных
Обновленные точечные объекты

Обновленные точечные объекты.

Класс пространственных объектов

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
(Дополнительный)

Определяет, будет ли использоваться интерполяция.

  • NONE Интерполяция не применяется, используется значение центра ячейки. Используется по умолчанию.
  • BILINEAR Извлекаемое значение вычисляется с использованием значений смежных ячеек с применением билинейной интерполяции. Значения NoData игнорируются при интерполяции, за исключением тех случаев, когда все смежные ячейки содержат значения NoData.
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"]]

# Execute ExtractValuesToPoints
ExtractMultiValuesToPoints(inPointFeatures, inRasterList, "BILINEAR")

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

  • Basic: Обязательно Spatial Analyst
  • Standard: Обязательно Spatial Analyst
  • Advanced: Обязательно Spatial Analyst

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