Извлечь значения в точки (Extract Values to Points) (Spatial Analyst)
Резюме
Извлекает значения ячеек растра на основе набора точечных объектов и записывает значения в таблицу атрибутов выходного класса объектов.
Использование
Все поля из входного класса точечных объектов должны быть включены в выходной класс точечных объектов.
-
В выходной класс объектов будет добавлено новое поле с именем RASTERVALU.
Примечание:Это поле уже не может существовать в таблице атрибутов входных объектов. Если оно существует, появится сообщение об ошибке. Если необходимо сохранить исходную информацию, то до выполнения команды Извлечь значения в точки (Extract Values to Points) можно добавить в таблицу атрибутов новое поле, (например, RASVAL1), рассчитать для него значения, а затем удалить исходное поле RASTERVALUE.
-
Если к многоканальному растру применяется команда Извлечь значения в точки (Extract Values to Points), то поле RASTERVALU заполнят значения из последнего канала входного растра. Чтобы извлечь значения из нескольких растров или из набора многоканальных растровых данных, используйте инструмент Извлечь мультизначения в точки (Extract Multi Values to Points).
-
В поле RASTERVALU атрибутивной таблицы, ячейкам растра со значениями NoData будет назначено значение -9999.
-
Опция Интерполяция определяет, каким образом будут получены значения из входного растра. По умолчанию используется значение той ячейки, ближе к центру которой расположена входная точка. При использовании интерполяции, для расчета значения будет использована билинейная интерполяция, и значение будет расчитано с учетом значений соседних ячеек.
-
Если тип входного растра – с плавающей точкой, результирующий выходной точечный набор данных будет содержать атрибуты входных векторных данных и значения ячеек, вычисленные с использованием интерполяции, или без нее.
-
При добавлении атрибутов из входного растра, если выходной набор точечных данных в формате шейп-файла, входной растр не должен содержать атрибутивные поля, имена которых не более чем 10 символов в длину. Если имена полей длиннее, то поля будут переименованы до запуска инструмента.
Наборы данных, состоящие из мультиточек, не поддерживаются в качестве входных данных.
Синтаксис
| Параметр | Объяснение | Тип данных |
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"
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute ExtractValuesToPoints
ExtractValuesToPoints(inPointFeatures, inRaster, outPointFeatures,
"INTERPOLATE", "VALUE_ONLY")