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

Доступно с лицензией 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")