Доступно с лицензией Spatial Analyst.
Краткая информация
Создает таблицу, содержащую значения ячеек растра или набора растров, для конкретных местоположений. Местоположения определяются ячейками растра или набором точек.
Входные растры могут быть двумерными или многомерными. Структура выходной таблицы изменяется, когда входные растры являются многомерными.
Более подробно о том, как работает инструмент Извлечь по образцу
Использование
В качестве входных данных могут быть заданы любые комбинации растров (одноканальные или многоканальные).
Значение ячейки будет извлечено по каждому входному растру. Будет создана таблица со значениями ячеек каждого входного растра.
Дополнительные атрибуты из таблицы входного растра, если есть, не будут перенесены в входную таблицу.
Если многоканальный растр указан как один из входных для параметра Входной растр (in_rasters в Python), будут обработаны все каналы.
Чтобы обработать выбранные каналы входного многоканального растра, сначала создайте новый набор растровых данных, состоящий только из необходимых каналов, с помощью инструмента Объединить каналы. Затем укажите полученный набор в списке входных растров.
Если в качестве входного задан многомерный растр, а опция Обработать как многомерный (ALL_SLICES для параметра process_as_multidimensional в Python) не включена, будет обработан только текущий фрагмент многомерного растра.
Чтобы извлечь значения из всех фрагментов входного многомерного набора данных, включите опцию Обработать как многомерный.
В данный момент для многомерной обработки этим инструментом поддерживаются следующие растры: растровые слои netCDF и многомерные наборы данных мозаики. Сервисы изображений многомерных данных в текущий момент не поддерживаются.
Если входным местоположением является растр, набор ячеек состоит из всех ячеек, имеющих значение 0 или больше. Ячейки со значением NoData не включаются в набор местоположений. Растр местоположений может быть легко создан с использованием инструментов извлечения.
Если входное местоположение является растром, для получения наилучших результатов размер ячеек и регистрация входных растров и растра местоположений должны совпадать.
Местоположениям, которые выбирают ячейки NoData во входном растре или растрах, будет присвоено значение <null> в выходной таблице базы геоданных. При выводе в INFO или .dbf, им будет присвоено значение -9999, так как значение null не поддерживается.
Если входные растры являются двумерными, то типом поля для отобранных значений в выходной таблице всегда будет число с плавающей точкой. Это позволяет обеспечить соответствующий уровень точности при выборе для метода передискретизации опций билинейной интерполяции или кубической свертки.
Наборы мультиточечных данных не поддерживаются в качестве входных.
См. раздел Параметры среды анализа и 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)
Параметры среды
Информация о лицензиях
- ArcGIS Desktop Basic: Требует Spatial Analyst
- ArcGIS Desktop Standard: Требует Spatial Analyst
- ArcGIS Desktop Advanced: Требует Spatial Analyst