| Подпись | Описание | Тип данных |
Входные растры | Растры, значения которых будут отобраны в качестве образцов на основании исходных данных местоположений. Параметр Обработать как многомерный доступен только в том случае, если входные данные представляют собой один многомерный растр. | Raster Layer |
Входной растр или объекты местоположений | Данные, определяющие места, где будет получена выборка. Входными данными может быть растр или класс пространственных объектов. | Raster Layer; Feature Layer |
Выходная таблица или класс объектов | Выходная таблица или класс объектов, содержащие выборочные значения ячеек. Выходной формат определяется выходным местоположением и путем. По умолчанию выходными данными будет таблица базы геоданных или класс объектов базы геоданных в рабочей области базы геоданных, таблица dBASE или класс объектов шейп-файла в рабочей области-папке. Тип выходных данных для создания таблицы или класса объектов определяется параметром Построение класса объектов. | Table; Point feature class |
Методы изменения разрешения (Дополнительный) | Алгоритм пересчета, который будет использоваться для выборки растра, определяющий, как значения будут получены из растра.
| String |
Поле уникального ID (Дополнительный) | Поле, содержащее отличное значение для каждого местоположения или объекта во входном растре или среди объектов местоположений. | Field |
Обработать как многомерный (Дополнительный) | Задает способ обработки входных растров. Этот параметр доступен только в том случае, если входные данные представляют собой один многомерный растр.
| Boolean |
Информация о получении данных местоположения (Дополнительный) | Определяет время, глубину или другие сведения, связанные с пространственными объектами. Поддерживаются только следующие комбинации:
Относительное значение или дней до и Относительное значение или дней после поддерживают только неотрицательные значения. Статистика будет рассчитываться с помощью параметра Тип статистики для переменных в пределах этого диапазона измерений. | Value Table |
Тип статистики (Дополнительный) | Задает вычисляемый тип статистики.
| String |
Значение процентиля (Дополнительный) | Это значение может варьироваться от 0 до 100. Значение по умолчанию равно 90. | Double |
Поле или значение буферного расстояния (Дополнительный) | Расстояние вокруг объектов местоположений. Буферное расстояние указывается в линейной единице пространственной привязки объекта местоположения. Если объект использует географическую привязку, такими единицами будут градусы. Статистика будет рассчитываться в пределах этой буферной области. | Double; Field |
Компоновка по столбцам (Дополнительный) | Устанавливает, будут ли значения выборки отображаться в строках или столбцах выходной таблицы.
| Boolean |
Построение класса объектов (Дополнительный) | Устанавливает, будет ли создан класс точечных объектов со значениями выборки в таблице атрибутов или будет построена таблица со значениями выборки.
| Boolean |
Краткая информация
Создает таблицу или класс точечных объектов, содержащую(-ий) значения ячеек растра или набора растров, для конкретных местоположений. Местоположения определяются ячейками растра, точками, полилиниями или полигонами.
Более подробно о том, как работает инструмент Извлечь по образцу
Использование
Значения ячеек будут извлекаться из всех Входных растров(in_rasters в Python) в каждом местоположении. Будет создана таблица или класс точечных объектов со значениями ячеек в полях для каждого входного растра.
Дополнительные атрибуты из таблицы входного растра, если есть, не будут включены в входную таблицу.
В качестве Входных растров могут быть заданы любые комбинации растров (одноканальных или многоканальных). Структура выходной таблицы автоматически изменяется, если входные растры являются многомерными.
Если многоканальный растр задан в качестве одного из Входных растров, то будут использоваться все его каналы.
В качестве значений параметра Входное местоположение растра или объектов (in_location_data в Python) можно использовать следующие:
- Растр – Ячейки с допустимыми значениями (не NoData) будут использоваться для извлечения значений ячеек изо всех входных растров, а центр этой ячейки будет использован для местоположений точек.
- Точка – Значения будут отбираться в каждом местоположении точек.
- Полилиния или полигон — среднее значение всех ячеек, пересекающих каждую полилинию или полигон, будет вычисляться, если входными данными является двумерный растр или несколько растров. Можно указать другие типы статистики, если входным является многомерный растр, который обрабатывается как многомерный.
Местоположениям, которые извлекают значения из ячеек NoData во входном растре, в выходной таблице будет присвоено значение <null>. Для шейп-файлов, поскольку они не поддерживают значения null, значения NoData в таблице содержат значения -9999.
Входные растры отбираются в их собственной пространственной привязке и разрешении. Если имеется несколько входных растров с различными пространственными привязками, входные местоположения сначала проецируются в систему координат каждого отдельного растра. А затем извлекаются значения. Это означает, что, хотя входные растры не будут учитывать никакие настройки среды анализа, ко входным местоположениям будут применены соответствующие настройки.
По умолчанию пространственная привязка координат x,y в параметре Выходная таблица или класс объектов (out_table в Python) будет такой же, как у значений параметра Входное местоположение растра или объектов, если в параметре среды Выходная система координат не будет выбрана другая. Если пространственная привязка входных местоположений неизвестна, пространственная привязка координат x,y также останется неизвестной.
Пространственная привязка координат x,y сообщается в конце работы инструмента, в виде сообщения геообработки.
Если Входное местоположение растра или объектов является классом точечных объектов без пространственного индекса, появится предупреждение. Чтобы повысить производительность инструмента для входных данных с большим количеством точек, создайте пространственный индекс. Дополнительные сведения см. в разделе Добавить пространственный индекс.
Инструмент не сможет работать с мультиточечными объектами. Для выполнения анализа с мультиточечными объектами, сначала конвертируйте их в отдельные точечные объекты, перед тем, как использовать их в инструменте извлечения. Для получения подробной информации см. Обработка мультиточечных данных.
Если для параметра Методы изменения разрешения задано Ближайшее (resampling_type = "NEAREST" в Python), тип поля в выходной таблице будет соответствовать типу растра. Если используется опция пересчета Билинейная или Кубическая, тип поля всегда будет иметь плавающую точку, чтобы поддерживать точность интерполированных значений.
В выходную таблицу будет добавлено поле для хранения значений, указанных в параметре Поле уникального идентификатора (unique_id_field в Python). По умолчанию имя поля совпадает с именем входного набора данных местоположения. Рекомендуется использовать поле, содержащее уникальные значения, как идентификатор каждого местоположения для последующего анализа.
Если параметр Обработать как многомерный отключен (process_as_multidimensional = "CURRENT_SLICE" в Python), будут применяться следующие условия:
- Если входные данные представляют собой многомерный растр, будет выбран только текущий срез.
- Если входные данные представляют собой растр с несколькими переменными, будет выбрана только текущая переменная.
Если параметр Обработать как многомерный отмечен (process_as_multidimensional = "ALL_SLICES" в Python), будут применяться следующие условия:
- Если входные данные представляют собой многомерный растр, будут выбраны все срезы.
- Если входные данные представляют собой растр с несколькими переменными, будут выбраны все переменные.
- Если входные данные представляют собой многомерный растр с несколькими переменными, будут выбраны все срезы всех переменных. У всех переменных должны быть одинаковые измерения.
Если параметр Обработать как многомерный отмечен (process_as_multidimensional = "ALL_SLICES" в Python), будет применен один из следующих сценариев:
Параметр Информация о получении данных местоположения (acquisition_definition в Python) будет использоваться для указания поднабора входного многомерного растра, используемого для выборки.
При указании измерения, начального значения и конечного значения обрабатываются срезы в пределах начального и конечного значений. Конечное значение по умолчанию – это максимальное значение измерения. Для измерения времени укажите значение в стандартном формате. Для других измерений укажите значение в той же единице измерения, что и для входного растра.
Когда задано измерение, начальное поле и конечное поле (начальное поле и конечное поле взяты из данных местоположения), значения из этих полей используются для указания подмножества входного растра при выборке значений в этом местоположении.
Значения Относительное значение или дней до и Относительное значение или дней после можно использовать для указания поднабора относительно начального значения, в котором значение до указывает начало поднабора, а значение после – конец поднабора. Значения времени задаются в днях, а другие значения измерений задаются в той же единице измерения, что и значения входного растра.
Параметр Тип статистики (statistics_typeв Python) агрегирует значения параметра Входной растр, заданного поднабором в параметре Информация о получении данных местоположения.
Если параметр Компоновка столбца выключен (layout = "ROW_WISE" в Python), извлеченные значения сохраняются в поле с тем же именем, что и переменная. Создаются дополнительные поля для хранения значений не пространственных измерений, с тем же именем, что и измерение.
Если параметр Компоновка столбца выключен (layout = "COLUMN_WISE" в Python), извлеченные значения сохраняются в полях с именами, соответствующими соглашению <variable_name>_<dimension_name>_<dimension_value>. Обратите внимание, что параметр Компоновка столбца поддерживается, когда многомерный растр содержит только одну переменную, переменная имеет только одно измерение, а каждый срез имеет один канал. В противном случае будет сгенерировано сообщение об ошибке.
Если в многомерном растре есть несколько каналов, для каждого из них создается дополнительное поле, в котором хранится значение, извлеченное из этого канала.
Местоположениям, извлекающим значения из ячеек NoData, будет присвоено значение NoData из входного многомерного растра.
Многомерный растр может быть растровым слоем netCDF, многомерным растровым слоем, набором многомерных данных мозаики, многомерным CRF, сервисом многомерных изображений или файлом netCDF. Вы не можете перейти к файлу netCDF в диалоговом окне инструмента, но можете указать путь к файлу.
Если параметр Построение класса объектов отмечен (generate_feature_class = "FEATURE_CLASS" в Python), выходные данные представляют собой класс точечных объектов со значениями выборки в таблице атрибутов. Ниже приведены возможные типы местоположений с описанием того, как будут отбираться значения:
- Растр—Точки будут создаваться с использованием местоположения центра ячейки.
- Точка—Точка будет создана в каждом из местоположений точек.
- Полилиния или полигон—Точка будет создана в каждом центроиде полигона или полилинии.
Пространственная привязка выходного класса пространственных объектов такая же, что и у Входного местоположения растра или объектов, если только она не указана в параметре среды Выходная система координат.
Параметр среды Коэффициент параллельной обработки поддерживается, только когда параметр Обработать как многомерный включен.
Если объект задан в среде Маска, внутренний растр создается с использованием минимального размера ячейки входных растров. Во время извлечения внутренний растр маски снова пересчитывается до размера ячейки каждого входного растра.
См. раздел Параметры среды анализа и Spatial Analyst для получения дополнительной информации о среде геообработки данного инструмента.
Параметры
Sample(in_rasters, in_location_data, out_table, {resampling_type}, {unique_id_field}, {process_as_multidimensional}, {acquisition_definition}, {statistics_type}, {percentile_value}, {buffer_distance}, {layout}, {generate_feature_class})| Имя | Описание | Тип данных |
in_rasters [in_raster,...] | Растры, значения которых будут отобраны в качестве образцов на основании исходных данных местоположений. Параметр process_as_multidimensional поддерживается только в том случае, если входные данные представляют собой один многомерный растр. | Raster Layer |
in_location_data | Данные, определяющие места, где будет получена выборка. Входными данными может быть растр или класс пространственных объектов. | Raster Layer; Feature Layer |
out_table | Выходная таблица или класс объектов, содержащие выборочные значения ячеек. Выходной формат определяется выходным местоположением и путем. По умолчанию выходными данными будет таблица базы геоданных или класс объектов базы геоданных в рабочей области базы геоданных, таблица dBASE или класс объектов шейп-файла в рабочей области-папке. Тип выходных данных для создания таблицы или класса объектов определяется параметром generate_feature_class. | Table; Point feature class |
resampling_type (Дополнительный) | Алгоритм пересчета, который будет использоваться для выборки растра, определяющий, как значения будут получены из растра.
| String |
unique_id_field (Дополнительный) | Поле, содержащее отличное значение для каждого местоположения или объекта во входном растре или среди объектов местоположений. | Field |
process_as_multidimensional (Дополнительный) | Задает способ обработки входных растров. Этот параметр доступен только в том случае, если входные данные представляют собой один многомерный растр.
| Boolean |
acquisition_definition [acquisition_definition,...] (Дополнительный) | Определяет время, глубину или другие сведения, связанные с пространственными объектами. Поддерживаются только следующие комбинации:
Relative value or days before и Relative value or days after поддерживают только неотрицательные значения. Статистика будет рассчитываться с помощью параметра statistics_type для переменных в пределах этого диапазона измерений. | Value Table |
statistics_type (Дополнительный) | Задает вычисляемый тип статистики.
| String |
percentile_value (Дополнительный) | Процентиль для вычисления, если параметр Тип статистики задан как Процентиль. Процентиль для вычисления, если параметр statistics_type задан как PERCENTILE. Это значение может варьироваться от 0 до 100. Значение по умолчанию равно 90. | Double |
buffer_distance (Дополнительный) | Расстояние вокруг объектов местоположений. Буферное расстояние указывается в линейной единице пространственной привязки объекта местоположения. Если объект использует географическую привязку, такими единицами будут градусы. Статистика будет рассчитываться в пределах этой буферной области. | Double; Field |
layout (Дополнительный) | Устанавливает, будут ли значения выборки отображаться в строках или столбцах выходной таблицы.
| Boolean |
generate_feature_class (Дополнительный) | Устанавливает, будет ли создан класс точечных объектов со значениями выборки в таблице атрибутов или будет построена таблица со значениями выборки.
| Boolean |
Пример кода
Извлекает значения ячеек из нескольких растров в таблицу, основанную на входных местоположениях.
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 feature class that shows the values of cells from
# rasters, for defined locations.
# The locations are defined by a set of points.
# Sampling method is Bilinear.
# Requirements: Spatial Analyst Extension
# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Set the analysis environments
env.workspace = "C:/sapyexamples/data"
# Set local variables
inRasters = ["elevation",
"costraster"]
locations = "observers.shp"
outFeatureClass = "c:/sapyexamples/output/samptable02.shp"
sampMethod = "BILINEAR"
generate_feature_class = "FEATURE_CLASS"
# Execute Sample
Sample(inRasters, locations, outFeatureClass, sampMethod, "", "", "", "", "", "", "", generate_feature_class)Извлекает значения ячеек из нескольких растров в таблицу, основанную на входных местоположениях.
# Name: Sample_Ex_03.py
# Description: Creates a table that shows the temperature values from
# a multidimensional raster, for defined locations.
# The locations are defined 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 = "temperature_1990_2019.nc"
locations = "observers.shp"
outTable = "C:/sapyexamples/output/samptable_03"
sampMethod = ""
uniqueIDField = "FID"
process_as_multidimensional = True
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute Sample
# the temperature value at each slice in temperature_1990_2019.nc will be extracted for each point
Sample(inRasters, locations, outTable, sampMethod, uniqueIDField, process_as_multidimensional)Извлекает значения ячеек из нескольких растров в таблицу, основанную на входных местоположениях.
# Name: Sample_Ex_04.py
# Description: Creates a table that shows, for each polygon, the maximum temperature value within the period [1999-01-01T00:00:00 , 2019-01-01-T00:00:00]
# Requirements: Spatial Analyst Extension
# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Set environment settings
env.workspace = "C:/sapyexamples/data"
# Set local variables
inRasters = "temperature_1990_2019.nc"
locations = "observers_polygons.shp"
outTable = "C:/sapyexamples/output/samptable_04.dbf"
sampMethod = "BILINEAR"
uniqueIDField = "OBSERVATIONID"
process_as_multidimensional = True
# StdTime in acquisition_definition is the name of the dimension in inRasters that are related with time
# 1999-01-01T00:00:00 in acquisition_definition is the start time of the period
# 2019-01-01-T00:00:00 in acquisition_definition is the end time of the period
acquisition_definition = "StdTime 1999-01-01T00:00:00 2019-01-01-T00:00:00"
statistic_method = "MAXIMUM"
# Execute Sample
# for each polygon in locations, the maximum temperature value within the period [1999-01-01T00:00:00 , 2019-01-01-T00:00:00] will be extracted
Sample(inRasters, locations, outTable, sampMethod, uniqueIDField, process_as_multidimensional, acquisition_definition, statistic_method)