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

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

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

Инструмент Извлечь мультизначения в точки предоставляет улучшенную функциональность или производительность.

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

  • Все поля из входного класса точечных объектов будут перенесены в выходной класс точечных объектов.

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

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

    Однако настройки среды анализа применяются ко входным местоположениям.

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

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

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

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

    Чтобы обработать другой канал, укажите его.

    Чтобы извлечь значения из нескольких растров или из набора многоканальных растровых данных, используйте инструмент Извлечь мультизначения в точки.

  • Опция интерполяции определяет порядок получения значений из растра. Опция по умолчанию позволяет извлечь значение ячейки во входных местоположениях. Чтобы извлечь интерполированное значение с помощью билинейного метода, поставьте отметку Интерполировать значения в точках (interpolate_values в Python).

  • Чтобы добавить все атрибуты из таблицы входного растра, включите опцию Присоединяет все атрибуты входного растра к выходным точечным объектам (ALL для параметра add_attributes в Python). Атрибуты будут перенесены в выходные точечные объекты без изменений, с сохранением значений. В зависимости от природы записываемого параметра, для некоторых атрибутивных значений может потребоваться пересчет.

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

  • Если в параметре среды Маска задан объект, он будет конвертирован в растр, размер ячейки и выравнивание берутся из Входного растра.

  • См. раздел Параметры среды анализа и Spatial Analyst для получения дополнительной информации о среде геообработки данного инструмента.

Параметры

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

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

Feature Layer
Входной растр

Набор растровых данных, значения которого будут извлечены.

Тип растра должен быть целочисленным или с плавающей точкой.

Raster Layer
Выходные точечные объекты

Выходной точечный набор данных, содержащий извлеченные значения растра.

Feature Class
Интерполировать значения в точки
(Дополнительный)

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

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

Определяет, будут ли атрибуты растра записаны в выходной точечный набор данных.

  • Не отмечено – Только значения ячеек входного растра добавляются к атрибутам точек. Используется по умолчанию.
  • Отмечено – Все поля входного растра (кроме поля Count) будут присоединены к атрибутам точечных объектов.
Boolean

ExtractValuesToPoints(in_point_features, in_raster, out_point_features, {interpolate_values}, {add_attributes})
ИмяОписаниеТип данных
in_point_features

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

Feature Layer
in_raster

Набор растровых данных, значения которого будут извлечены.

Тип растра должен быть целочисленным или с плавающей точкой.

Raster Layer
out_point_features

Выходной точечный набор данных, содержащий извлеченные значения растра.

Feature Class
interpolate_values
(Дополнительный)

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

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

Определяет, будут ли атрибуты растра записаны в выходной точечный набор данных.

  • VALUE_ONLYТолько значения ячеек входного растра добавляются к атрибутам точек. Используется по умолчанию.
  • ALLВсе поля входного растра (кроме поля Count) будут присоединены к атрибутам точечных объектов.
Boolean

Пример кода

ExtractValuesToPoints Пример 1 (окно Python)

В этом примере извлекаются значения ячеек из растра на основе местоположений, определенных точечным шейп-файлом, и создается выходной класс точечных объектов этих значений.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
ExtractValuesToPoints("rec_sites.shp", "elevation",
                      "C:/sapyexamples/output/outValPnts","INTERPOLATE",
                      "VALUE_ONLY")
ExtractValuesToPoints, пример 2 (автономный скрипт)

В этом примере извлекаются значения ячеек из растра на основе местоположений, определенных точечным шейп-файлом, и создается выходной точечный шейп-файл этих значений.

# Name: ExtractValuesToPoints_Ex_02.py
# Description: Extracts the cells of a raster based on a set of points.
# 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 = "rec_sites.shp"
inRaster = "elevation"
outPointFeatures = "C:/sapyexamples/output/extractvaluespts.shp"

# Execute ExtractValuesToPoints
ExtractValuesToPoints(inPointFeatures, inRaster, outPointFeatures,
                      "INTERPOLATE", "VALUE_ONLY")

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