| Подпись | Описание | Тип данных |
Входные точечные объекты | Входные точечные объекты, определяющие местоположения, из которых вы хотите извлечь значения ячеек растра. | Feature Layer |
Входной растр | Набор растровых данных, значения которого будут извлечены. Тип растра должен быть целочисленным или с плавающей точкой. | Raster Layer |
Выходные точечные объекты | Выходной точечный набор данных, содержащий извлеченные значения растра. | Feature Class |
Интерполировать значения в точки (Дополнительный) | Определяет, будет ли использоваться интерполяция.
| Boolean |
Присоединяет все атрибуты входного растра выходным точечным объектам (Дополнительный) | Определяет, будут ли атрибуты растра записаны в выходной точечный набор данных.
| Boolean |
Доступно с лицензией 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 (Дополнительный) | Определяет, будет ли использоваться интерполяция.
| Boolean |
add_attributes (Дополнительный) | Определяет, будут ли атрибуты растра записаны в выходной точечный набор данных.
| Boolean |
Пример кода
В этом примере извлекаются значения ячеек из растра на основе местоположений, определенных точечным шейп-файлом, и создается выходной класс точечных объектов этих значений.
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")В этом примере извлекаются значения ячеек из растра на основе местоположений, определенных точечным шейп-файлом, и создается выходной точечный шейп-файл этих значений.
# 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")Параметры среды
Автоматическое подтверждение, Текущая рабочая область, Выходное значение Z по умолчанию, Экстент, Географические преобразования, Маска, Разрешение M, Допуск M, Сохранять пространственный индекс, Выходное ключевое слово CONFIG, Выходная система координат, Выходные данные имеют M-значения, Выходные данные имеют Z-значения, Выходной домен M, Выходной XY домен, Выходной домен Z, Полноценные имена полей, Временная рабочая область, Передать описания доменов полей, Разрешение XY, Допуск XY, Разрешение Z, Допуск Z