Инструмент Образец (Sample) (Spatial Analyst)
Краткая информация
Создает таблицу, которая содержит значения ячеек растра, или набора растров, для определенных местоположений. Местоположения определяются ячейками растра или набором точек.
Более подробно о том, как работает инструмент Образец (Sample)
Использование
-
Если входным местоположением является растр, набор ячеек состоит из всех ячеек, имеющих значение 0 или больше. Ячейки со значением NoData не включаются в набор местоположений. Растр местоположений может быть легко создан с использованием инструментов 'Извлечь по...'.
-
Местоположениям, имеющим ячейки со значением NoData в входном растре или растрах, будет присвоено значение <null> в таблице выходной базы геоданных. Поскольку для выходных данных в формате INFO или .dbf концепция пустых значений (null) не поддерживается, им будет присвоено значение 0 (нуль).
-
Типом поля для опорных значений в выходной таблице всегда является число с плавающей точкой. Это требуется для уверенности, что необходимое значение точности будет достигнуто, если в качестве метода пересчета будут выбраны опции билинейной интерполяции или кубической свертки.
-
Если в качестве входных данных местоположений используется растр, для наилучших результатов размер ячеек и регистрация (система координат) входных растров и растра местоположений должны совпадать.
-
Выходные данные инструмента – таблица.
Наборы данных, состоящие из мультиточек, не поддерживаются в качестве входных данных.
Синтаксис
| Параметр | Объяснение | Тип данных |
in_rasters [in_raster,...] |
Перечень растров, значения которых будут отобраны в качестве образцов на основании входных данных местоположений. | Raster Layer |
in_location_data |
Данные, определяющие позиции, в которых вы хотите отобрать образец. Эти данные могут быть представлены растром или точечным набором классов объектов. | Raster Layer | Feature Layer |
out_table |
Выходная таблица, в которой содержатся значения отобранных в качестве образцов ячеек. Формат таблицы определяется выходным местоположением и путем. Если не указано расширение, будет создана таблица INFO. Если местоположение находится в базе геоданных, выходная таблица будет создана именно с этим типом (например, файловая БГД или база геоданных ArcSDE). Если имя имеет расширение .dbf, выходные данные будут созданы в формате dBASE. | Table |
resampling_type (дополнительно) |
Алгоритм передискретизации, используемый при отборе образцов на растре.
| String |
Пример кода
Извлекает значения ячеек из нескольких растров в таблицу, основанную на входных местоположениях.
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")
Извлекает значения ячеек из нескольких растров в таблицу, основанную на входных местоположениях.
# 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)