Извлечь значения в точки (Инструменты 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 (Дополнительный)	Определяет, будет ли использоваться интерполяция. `INTERPOLATE`–Извлекаемое значение вычисляется с использованием значений смежных ячеек с применением билинейной интерполяции. Значения NoData игнорируются при интерполяции, за исключением тех случаев, когда все смежные ячейки содержат значения NoData. `NONE`–Интерполяция не применяется, используется значение центра ячейки. Используется по умолчанию.	Boolean
add_attributes (Дополнительный)	Определяет, будут ли атрибуты растра записаны в выходной точечный набор данных. `ALL`–Все поля входного растра (кроме поля `Count`) будут присоединены к атрибутам точечных объектов. `VALUE_ONLY`–Только значения ячеек входного растра добавляются к атрибутам точек. Используется по умолчанию.	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"

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

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

Автоподтверждение, Текущая рабочая область, Выходное Z-значение по умолчанию, Экстент, Географические преобразования, Маска, Разрешение M, Допуск M, Выходное ключевое слово конфигурации, Выходная система координат, Наличие выходных значений M, Выходные данные содержат Z значения, Выходной M домен, Выходной XY домен, Выходной Z домен, Поддержка полноценных имен полей, Временная рабочая область, Перенос описаний доменов полей, Разрешение XY, Допуск XY, Разрешение Z, Допуск Z

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