Доступно с лицензией 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})| Parameter | Объяснение | Тип данных |
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")Environments
Информация о лицензиях
- Basic: Требуется Spatial Analyst
- Standard: Требуется Spatial Analyst
- Advanced: Требуется Spatial Analyst