Доступно с лицензией Spatial Analyst.
Краткая информация
Извлекает значения ячеек растра в местах, соответствующих классу точечных объектов, одного или нескольких растров и сохраняет значения в таблицу атрибутов класса точечных объектов.
Использование
Все поля из входного класса точечных объектов должны быть включены в выходной класс точечных объектов.
В выходной класс объектов будет добавлено новое поле с именем RASTERVALU.
Если к многоканальному растру применяется команда Извлечь значения в точки, то поле RASTERVALU заполнят значения из последнего канала входного растра. Чтобы извлечь значения из нескольких растров или из набора многоканальных растровых данных, используйте инструмент Извлечь мультизначения в точки.
В поле RASTERVALU атрибутивной таблицы ячейкам растра со значениями NoData будет дано значение -9999.
-
Опция интерполяции определяет порядок получения значений из растра. По умолчанию используется значение центра создаваемой ячейки. Для получения значения центра ячейки будет использоваться билинейная интерполяция.
Если тип входного растра – с плавающей точкой, результирующий выходной точечный набор данных будет содержать атрибуты входных векторных данных и значения ячеек, вычисленные с использованием интерполяции, или без нее.
При добавлении атрибутов из входного растра, если выходной набор точечных данных в формате шейп-файла, входной растр не должен содержать атрибутивные поля, имена которых не более чем 10 символов в длину. Если имена полей длиннее, то поля будут переименованы до запуска инструмента.
Наборы мультиточечных данных не поддерживаются в качестве входных.
См. раздел Среда анализа и 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 |
Пример кода
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")
Параметры среды
- Автоподтверждение (Auto Commit)
- Текущая рабочая область (Current Workspace)
- Выходное значение Z по умолчанию (Default Output Z Value)
- Экстент (Extent)
- Географические преобразования (Geographic Transformations)
- Маска (Mask)
- Разрешение M (M Resolution)
- Допуск M (M Tolerance)
- Сохранять пространственный индекс (Maintain Spatial Index)
- Выходное ключевое слово CONFIG (Output CONFIG Keyword)
- Выходная система координат (Output Coordinate System)
- Выходные данные содержат значения M (Output has M values)
- Выходные данные содержат Z значения (Output has Z values)
- Выходной домен M (Output M Domain)
- Выходной XY домен (Output XY Domain)
- Выходной домен Z (Output Z Domain)
- Стандартизированные имена полей (Qualified Field Names)
- Временная рабочая область (Scratch Workspace)
- Растр привязки (Snap Raster)
- Перенос описаний доменов полей (Transfer Field Domain Descriptions)
- Разрешение XY (XY Resolution)
- Допуск XY (XY Tolerance)
- Разрешение Z (Z Resolution)
- Допуск Z (Z Tolerance)