ArcMap

Извлечь значения в точки

Доступно с лицензией Spatial Analyst.

Краткая информация

Извлекает значения ячеек растра в местах, соответствующих классу точечных объектов, одного или нескольких растров и сохраняет значения в таблицу атрибутов класса точечных объектов.

Использование

  • Все поля из входного класса точечных объектов будут перенесены в выходной класс точечных объектов.

  • В выходной класс объектов будет добавлено новое поле с именем RASTERVALU.

  • Чтобы добавить атрибуты из таблицы входного растра, включите опцию Присоединяет все атрибуты входного растра к выходным точечным объектам (ALL для параметра add_attributes в Python). Атрибуты будут перенесены в выходные точечные объекты без изменений, с сохранением значений. В зависимости от природы записываемого параметра, для некоторых атрибутивных значений может потребоваться пересчет.

  • Формат шейп-файла имеет ограничение на максимальную длину имени поля в 10 символов. В результате, имена всех полей, присоединяемых к атрибутивной таблице выходного шейп-файла, будут по умолчанию сокращены и сделаны уникальными. Если имена длинные или похожие, это может затруднить различение таких полей. В этом случае предлагается использовать формат файловой базы геоданных.

  • Если для параметра Входной растр (in_raster в Python) указан многоканальный растр, будет использован только первый канал.

    Чтобы обработать другой канал, укажите его.

    Чтобы извлечь значения из нескольких растров или из набора многоканальных растровых данных, используйте инструмент Извлечь мультизначения в точки .

  • Местоположениям, которые выбирают ячейки NoData во входном растре, будет присвоено значение <null> в выходной таблице базы геоданных. При выводе в шейп-файлах им будет присвоено значение -9999, так как значение null такими данными не поддерживается.

  • Опция интерполяции определяет порядок получения значений из растра. По умолчанию используется значение центра создаваемой ячейки. Для получения значения центра ячейки будет использоваться билинейная интерполяция.

  • Наборы мультиточечных данных не поддерживаются в качестве входных.

  • См. раздел Параметры среды анализа и 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
(Дополнительный)

Определяет, будет ли использоваться интерполяция.

  • NONE — Интерполяция не применяется, используется значение центра ячейки. Используется по умолчанию.
  • INTERPOLATE — Извлекаемое значение вычисляется с использованием значений смежных ячеек с применением билинейной интерполяции. Значения NoData игнорируются при интерполяции, за исключением тех случаев, когда все смежные ячейки содержат значения NoData.
Boolean
add_attributes
(Дополнительный)

Определяет, будут ли атрибуты растра записаны в выходной точечный набор данных.

  • VALUE_ONLY — Только значения ячеек входного растра добавляются к атрибутам точек. Используется по умолчанию.
  • ALL — Все поля входного растра (кроме поля Count) будут присоединены к атрибутам точечных объектов.
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")

Параметры среды

Информация о лицензиях

  • ArcGIS Desktop Basic: Требует Spatial Analyst
  • ArcGIS Desktop Standard: Требует Spatial Analyst
  • ArcGIS Desktop Advanced: Требует Spatial Analyst

Связанные разделы