Доступно с лицензией Spatial Analyst.
Краткая информация
Создает таблицу, содержащую значения ячеек растра или набора растров, для конкретных местоположений. Местоположения определяются ячейками растра или набором точек.
Входные растры могут быть двумерными или многомерными. Структура выходной таблицы изменяется, когда входные растры являются многомерными.
Более подробно о том, как работает инструмент Извлечь по образцу
Использование
Если входным местоположением является растр, набор ячеек состоит из всех ячеек, имеющих значение 0 или больше. Ячейки со значением NoData не включаются в набор местоположений. Растр местоположений может быть легко создан с использованием инструментов 'Извлечь по...'.
Местоположениям, которые выбирают ячейки NoData во входном растре или растрах, будет присвоено значение <null> в выходной таблице базы геоданных. При выводе в INFO или .dbf, им будет присвоено значение 0 (ноль), так как понятие null не поддерживается.
Если предоставлен более чем один многомерный растр, то все они должны обладать одними и теми же именами измерений.
Растровые слои NetCDF являются единственным поддерживаемым типом многомерных растров.
Если входные растры представляют собой смесь двумерных и многомерных растров, то будут отобраны значения только текущего среза любого многомерного растра.
Если входные растры являются двумерными, то типом поля для отобранных значений в выходной таблице всегда будет число с плавающей точкой. Это позволяет обеспечить соответствующий уровень точности при выборе для метода передискретизации опций билинейной интерполяции или кубической свертки.
Если входное местоположение является растром, для получения наилучших результатов размер ячеек и регистрация входных растров и растра местоположений должны совпадать.
Выходные данные инструмента – таблица.
Наборы мультиточечных данных не поддерживаются в качестве входных.
См. раздел Среда анализа и Spatial Analyst для получения дополнительной информации о среде геообработки данного инструмента.
Синтаксис
Sample (in_rasters, in_location_data, out_table, {resampling_type}, {unique_id_field}, {process_as_multidimensional})
Параметр | Объяснение | Тип данных |
in_rasters [in_raster,...] | Перечень растров, значения которых будут отобраны в качестве образцов на основании входных данных местоположений. | Raster Layer |
in_location_data | Данные, определяющие позиции, в которых вы хотите отобрать образец. Эти данные могут быть представлены растром или точечным набором классов объектов. | Raster Layer | Feature Layer |
out_table | Выходная таблица, в которой содержатся значения отобранных в качестве образцов ячеек. Формат таблицы определяется выходным местоположением и путем к ней. По умолчанию выходными данными будет таблица базы геоданных. Если путь указывает не на базу геоданных, формат будет определяется расширением. Если выбрано расширение .dbf, данные будут в формате dBASE. Если расширение не указано, это будет таблица INFO. | Table |
resampling_type (дополнительно) | Алгоритм передискретизации, используемый при отборе образцов на растре.
| String |
unique_id_field (дополнительно) | Поле, содержащее отличное значение для каждого местоположения или объекта во входном растре или среди точечных объектов местоположений. | Field |
process_as_multidimensional (дополнительно) | Определяет, как обрабатываются входные растры.
| Boolean |
Пример кода
Sample, пример 1 (окно Python)
Извлекает значения ячеек из нескольких растров в таблицу, основанную на входных местоположениях.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
Sample(["elevation", "costraster"], "observers.shp",
"c:/sapyexamples/output/samptable","NEAREST")
Sample, пример 2 (автономный скрипт)
Извлекает значения ячеек из нескольких растров в таблицу, основанную на входных местоположениях.
# Name: Sample_Ex_02.py
# Description: Creates a table that shows the values of cells from
# a raster, or set of rasters, for defined locations.
# The locations are defined by raster cells or by 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
inRasters = ["elevation",
"costraster"]
locations = "observers.shp"
outTable = "c:/sapyexamples/output/samptable02"
sampMethod = "NEAREST"
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute Sample
Sample(inRasters, locations, outTable, sampMethod)