| Подпись | Описание | Тип данных |
Входные точечные объекты | Входные точечные объекты, определяющие местоположения, из которых вы хотите извлечь значения ячеек растра. | 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
Информация о лицензиях
- Basic: Обязательно Spatial Analyst
- Standard: Обязательно Spatial Analyst
- Advanced: Обязательно Spatial Analyst