ArcMap

Извлечь по образцу

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

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

Создает таблицу, содержащую значения ячеек растра или набора растров, для конкретных местоположений. Местоположения определяются ячейками растра или набором точек.

Входные растры могут быть двумерными или многомерными. Структура выходной таблицы изменяется, когда входные растры являются многомерными.

Более подробно о том, как работает инструмент Извлечь по образцу

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

  • Если входным местоположением является растр, набор ячеек состоит из всех ячеек, имеющих значение 0 или больше. Ячейки со значением NoData не включаются в набор местоположений. Растр местоположений может быть легко создан с использованием инструментов извлечения.

  • Местоположениям, которые выбирают ячейки NoData во входном растре или растрах, будет присвоено значение <null> в выходной таблице базы геоданных. При выводе в INFO или .dbf, им будет присвоено значение -9999, так как значение 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
(Дополнительный)

Алгоритм передискретизации, используемый при отборе образцов на растре.

  • NEAREST — Присвоение значений по методу Ближайшего соседа
  • BILINEAR — Билинейная интерполяция
  • CUBIC — Кубическая свертка
String
unique_id_field
(Дополнительный)

Поле, содержащее отличное значение для каждого местоположения или объекта во входном растре или среди точечных объектов местоположений.

Field
process_as_multidimensional
(Дополнительный)

Определяет, как обрабатываются входные растры.

  • ALL_SLICES — Образцы будут взяты для всех измерений (например, времени и глубины) многомерного растра.
  • CURRENT_SLICE —Образцы будут взяты из текущего среза многомерного растра. Используется по умолчанию.
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

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