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

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

Сводка
Использование
Синтаксис
Пример кода
Параметры среды
Информация о лицензиях

Сводка

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

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

Все поля из входного класса точечных объектов будут перенесены в выходной класс точечных объектов.
К выходным данным добавляется новое поле RASTERVALU для хранения извлеченных значений. Если поле с этим именем уже существует в таблице атрибутов входных объектов, инструмент не сможет выполнить операцию.
Входной растр не будет пересчитан с учетом параметров среды анализа. Вместо этого, значения ячеек извлекаются из входного растра со своим оригинальным разрешением и пространственной привязкой с помощью проецирования входных местоположений в пространственную привязку растра, из которого извлекаются значения.
Однако к входным местоположениям применяются параметры среды анализа.
Местоположениям, которые извлекают значения из ячеек NoData во входном растре, в выходной таблице будет присвоено значение <null>. Для шейп-файлов, поскольку поля null не поддерживаются, ячейки NoData записываются в таблицу со значениями -9999.
Формат шейп-файла имеет ограничение на максимальную длину имени поля в 10 символов. В результате, имена всех полей, присоединяемых к атрибутивной таблице выходного шейп-файла, будут по умолчанию сокращены и сделаны уникальными. Если имена длинные или похожие, это может затруднить различение таких полей. В этом случае предлагается использовать формат файловой базы геоданных.
Инструмент не сможет работать с мультиточечными объектами. Для выполнения анализа с мультиточечными объектами, сначала конвертируйте их в точечные объекты, перед запуском инструмента извлечения. Дополнительные сведения см. в разделе, касающемся обработки мультиточечных данных.
Если для параметра Входной растр (in_raster в Python) указан многоканальный растр, будет использован только первый канал.
Чтобы обработать другой канал, укажите его.
Чтобы извлечь значения из нескольких растров или из набора многоканальных растровых данных, используйте инструмент Извлечь мультизначения в точки .
Опция интерполяции определяет порядок получения значений из растра. По умолчанию извлекаются точные значения ячеек во входных местоположениях. Для извлечения интерполированных значений, используя билинейную интерполяцию, используйте опцию Интерполировать значения в точки (interpolate_values в Python).
Чтобы добавить все атрибуты из таблицы входного растра, включите опцию Присоединять все атрибуты входного растра к выходным точечным объектам (ALL для параметра add_attributes в Python). Атрибуты будут перенесены в выходные точечные объекты без изменений, с сохранением значений. Имейте в виду, что в зависимости от природы записываемого параметра, для некоторых атрибутивных значений может потребоваться пересчет.
Если параметр среды Выходная система координат задан явным образом, пространственная привязка выходного класса объектов извлекается из входных точечных объектов. Однако если выходные данные записываются в набор классов объектов, с или без заданного параметра среды Выходная система координат, выходная пространственная привязка будет такой же, как и у набора классов объектов.
Если параметр среды Маска является объектом, он будет внутренне конвертирован в растр, размер ячейки и выравнивание берутся из входного растра.
См. раздел Среда анализа и Spatial Analyst для получения дополнительной информации о среде геообработки данного инструмента.

Синтаксис

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"

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

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

Сводка

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

Синтаксис

Пример кода

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

ExtractValuesToPoints, пример 2 (автономный скрипт)

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

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

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