ArcMap

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

Доступно с лицензией Spatial Analyst.

Краткая информация

Извлекает значения ячеек в местах, соответствующих классу точечных объектов, одного или нескольких растров и сохраняет значения в таблицу атрибутов класса точечных объектов.

Использование

  • Этот инструмент может изменять номер ID входных точек во время работы. Поэтому рекомендуется использовать в атрибутивной таблице поле уникального идентификатора в явном виде, вместо ссылки на поле Object ID, предлагаемой исходным набором данных (это может быть FID, OID или ObjectID, в зависимости от формата). Самый простой способ – это добавить новое целочисленное поле и вычислить в нем это значение. Это гарантирует, что вы сможете связать полученные результаты с исходными данными.

  • В качестве входных данных могут быть заданы любые комбинации растров (одноканальные или многоканальные).

  • Значение ячейки будет извлечено по каждому входному растру. Новое поле, содержащее значения ячеек каждого входного растра, будет присоединено к входному классу точечных объектов.

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

  • Если многоканальный растр указан как один из входных для параметра Входной растр (in_rasters в Python), будут обработаны все каналы.

    Чтобы обработать выбранные каналы входного многоканального растра, сначала создайте новый набор растровых данных, состоящий только из необходимых каналов, с помощью инструмента Объединить каналы. Затем укажите полученный набор в списке входных растров.

  • Имена выходных полей по умолчанию создаются по имени входного растра; иначе вы можете указать уникальное имя для каждого поля, хранящего значения растра.

  • Если входные данные – многоканальный растр, для всех каналов будет добавлено поле с префиксом b1_, b2_, …bn, добавляемым к имени выходного поля, содержащего число каналов.

  • Опция интерполяции определяет порядок получения значений из растра. По умолчанию используется значение центра создаваемой ячейки. Для получения значения центра ячейки будет использоваться билинейная интерполяция.

  • Форматы шейп-файлов имеют ограничения длины поля – максимум 10 символов. Выходные поля, присоединяемые к входному шейп-файлу, будут обрезаны и станут уникальными по умолчанию. Если имена длинные или очень похожие, это может затруднить различение между входными данными. В этом случае предлагается конвертировать входные объекты в файловую базу геоданных, а затем использовать их в качестве входных данных.

  • Местоположениям, задающим ячейки NoData входного растра или растров, будут присвоено значение <null>, если входные точеные объекты находятся в базе геоданных. Если входные данные представляют собой шейп-файл, для которого значение null не поддерживается, будет присвоено значение -9999.

  • Наборы мультиточечных данных не поддерживаются в качестве входных.

  • См. раздел Параметры среды анализа и 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
(Дополнительный)

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

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

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

NameОбъяснениеТип данных
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")

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

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

  • ArcGIS Desktop Basic: Требует Spatial Analyst
  • ArcGIS Desktop Standard: Требует Spatial Analyst
  • ArcGIS Desktop Advanced: Требует Spatial Analyst

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