Извлечь по образцу (Map Viewer Classic)

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

Примечание:

Теперь этот инструмент доступен в Map Viewer, современный инструмент для создания карт в ArcGIS Online. Более подробно см. в Извлечь по образцу(Map Viewer).

Если вы не видите этот инструмент в Map Viewer Classic, свяжитесь с администратором организации. Ваша учетная запись должна иметь тип пользователя Professional или Professional Plus и права на выполнение анализа изображений

Схема рабочего процесса

Примерный рабочий процесс

Примеры

Примерами применения этого инструмента могут быть:

  • Извлечь атрибуты местоположения вышки сотовой связи из нескольких растров, таких как землепользование, тип почвы, высота и расстояние до дороги.
  • Извлечь температуру почвы на разных глубинах для заданного набора точек.
  • Исходя из 30-летних ежемесячных данных о температуре морской поверхности, суммировать данные о местонахождении животных или в пределах домашних ареалов за данный период времени, когда тот или иной вид животных был под наблюдением.

Примечания по использованию

Значения ячеек будут извлекаться из всех входных растров в каждом местоположении. Будет создана таблица или класс точечных объектов со значениями ячеек для каждого входного растра. Дополнительные атрибуты из таблицы входного растра не будут включены в выходную таблицу.

В качестве входных данных могут быть заданы любые сочетания растров, в том числе одноканальные, многоканальные, многомерные или многовариантные. Структура выходной таблицы изменяется, когда входные растры являются многомерными. Если многоканальный растр указан как один из входных, то будут использоваться все его каналы. Чтобы обработать выбранные каналы входного многоканального растра, сначала создайте набор растровых данных, состоящий только из этих конкретных каналов. Затем укажите полученный набор в списке входных растров.

Входным местоположением могут быть растр или класс пространственных объектов.

  • Растр – Пикселы с допустимыми значениями (не NoData) используются для извлечения значений этого пиксела изо всех входных растров, а центр этого пиксела используется для местоположений точек.
  • Точка – Значения будут отбираться в каждом местоположении точек.
  • Полилиния или полигон – Значения будут отбираться в центроиде полигона или полилинии. Если первый растр – многомерный, значения будут агрегироваться в зависимости от типа Статистики.

В выходную таблицу будет добавлено поле для хранения значений, указанных в параметре Указание поля уникального идентификатора. По умолчанию имя поля совпадает с именем входного набора данных местоположения. Рекомендуется использовать поле, содержащее уникальные значения, как идентификатор каждого местоположения для последующего анализа.

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

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

Пространственная привязка координат x,y в выходной таблице выборок или классе пространственных объектов такая же, что и у входного растра местоположений или точечных объектов, если только она не указана в параметре среды Выходная система координат. Если пространственная привязка входных местоположений неизвестна, пространственная привязка координат x,y также останется неизвестной. Если входное местоположение является классом точечных объектов без пространственного индекса, появится предупреждение. Чтобы повысить производительность инструмента для входных данных с большим количеством точек, создайте пространственный индекс.

Для выполнения анализа с мультиточечными объектами, сначала конвертируйте их в отдельные точечные объекты, перед тем, как использовать их в этом инструменте.

Параметр Указание информации о сборе данных о местоположениях будет использоваться для указания поднабора входного многомерного растра, используемого для выборки.

  • При указании размера, начального значения и конечного значения обрабатываются срезы в пределах начального и конечного значений. Конечное значение по умолчанию – это максимальное значение размера. Для измерения времени укажите значение в стандартном формате. Для других измерений укажите значение в той же единице измерения, что и для входного растра.
  • Когда заданы размер, начальное поле и конечное поле (начальное поле и конечное поле взяты из данных местоположения), значения из этих полей используются для указания подмножества входного растра при выборке значений в этом местоположении.
  • Относительное значение или дни до и Относительное значение или дни после можно использовать для указания поднабора относительно начального значения, в котором значение до указывает начало поднабора, а значение после – конец поднабора. Значения времени задаются в днях, а другие значения измерений задаются в той же единице измерения, что и значения входного растра.

Параметр Выберите тип статистики агрегирует значения параметра Входного растра, заданного поднабором в параметре Указать информацию о сборе данных местоположений.

Если выбрана опция Значения образца в строках, извлеченные значения сохраняются в поле с тем же именем, что и переменная. Создаются дополнительные поля для хранения значений непространственных размерностей, с тем же именем, что и размерность. Если выбрано Значения образца в столбцах, извлеченные значения сохраняются в полях, имена которых соответствуют условию <variable_name>_<dimension_name>_<dimension_value> .

Если в многомерном растре есть несколько каналов, для каждого из них создается дополнительное поле, в котором хранится значение, извлеченное из этого канала.

Если параметр Указание способа пересчета задан как Ближайшее, тип поля в выходной таблице будет соответствовать типу растра. Если используется опция пересчета Билинейная или Кубическая, тип поля всегда будет иметь плавающую точку, чтобы поддерживать точность интерполированных значений.

По умолчанию в качестве выходных данных вы получаете Таблицу. Если в качестве Объектов выбран параметр Указание выходного типа, то на выходе будет класс точечных объектов с выборочными значениями в таблице атрибутов. Ниже приведены возможные типы местоположений с описанием того, как будут отбираться значения:

  • Растр—Точки будут создаваться с использованием местоположения центра ячейки.
  • Точка—Точка будет создана в каждом из местоположений точек.
  • Полилиния или полигон—Точка будет создана в каждом центроиде полигона или полилинии.

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

Параметр среды Коэффициент параллельной обработки поддерживается, только если входные данные представлены многомерным растром.

Если объект задан в среде Маска, внутренний растр создается с использованием минимального размера ячейки входных растров. Во время извлечения внутренний растр маски снова пересчитывается до размера ячейки каждого входного растра.

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

Параметры этого инструмента перечислены в следующей таблице:

ПараметрОбъяснение
Выбор слоя (слоев) изображений для извлечения по образцу

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

Для отбора всех срезов из многомерного слоя изображений это должен быть единственный входной растр.

Выбор слоя местоположения

Данные, определяющие позиции, которые вы хотите отобрать.

Входными данными о местоположении могут быть растр или класс объектов точек, полилиний или полигонов.

Указание поля уникального ID (дополнительно)

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

Указание информации о сборе данных о местоположениях (необязательно)

Укажите время, глубину или другие собранные данные, связанные с местоположениями или объектами.

Для каждого измерения существует три варианта указания информации о сборе данных, имеющей отношение к местоположениям или объектам:

  • Отдельное поле или значение – Когда выбрана эта опция, необходимо указывать следующую информацию:
    • Поле или значение измерения – выберите поле или значение измерений из данных о местоположении, или введите конкретное значение измерения.
  • Отдельное поле или значение с относительными значениями – Если выбрана эта опция, то необходимо указать приведенную ниже информацию, чтобы определить диапазон, для которого будет рассчитываться статистика для переменных:
    • Поле или значение измерения – выберите поле или значения измерений из данных о местоположении.
    • Относительное значение до – укажите неотрицательное число, используемое для вычитания из Поле или значения измерения, чтобы определить начало диапазона значений измерения. Это значение представляет собой число дней, если измерением является время.
    • Относительное значение после – укажите неотрицательное число, используемое для добавления к Поле или значения измерения, чтобы определить конец диапазона значений измерения. Это значение представляет собой число дней, если измерением является время.
  • Начальное и конечное поля или значения – Если выбрана эта опция, то необходимо указать приведенную ниже информацию, чтобы определить диапазон, для которого будет рассчитываться статистика для переменных:
    • Начальное поле или значения – выберите поле значений измерений из данных о местоположении, или введите конкретное значение измерения, чтобы задать начало диапазона значений измерения.
    • Начальное поле или значения – выберите поле значений измерений из данных о местоположении или введите конкретное значение измерения, чтобы задать конец диапазона значений измерения.

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

Указание поля или значения буферного расстояния (дополнительно)

Заданное расстояние вокруг объектов местоположений. Буферное расстояние задается в линейных единицах пространственной привязки объектов местоположений. Если объект использует географическую привязку, такими единицами будут градусы.

Статистика будет рассчитываться в пределах этой буферной области.

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

Выбор типа статистики (дополнительно)

Тип вычисляемой статистики.

  • Минимум – Находит минимальное значение в заданном диапазоне.
  • Максимум – Находит максимальное значение в заданном диапазоне.
  • Медианное – Находит медианное значение в заданном диапазоне.
  • Среднее – Вычисляет среднее значение для заданного диапазона.
  • Сумма – Вычисляет сумму переменных в пределах заданного диапазона.
  • Большинство – Находит значение, которое встречается чаще всего.
  • Меньшинство – Находит значение, которое встречается реже всего.
  • Среднеквадратическое отклонение – Вычисляет среднеквадратическое отклонение.
  • Процентиль – Вычисляет заданный процентиль в пределах заданного диапазона.

Этот параметр доступен только в том случае, если параметр Выбрать слой изображений для образца является многомерным растром, а параметры Выбор слоя местоположения являются полилиниями или полигонами, или задано Указание поля или значения буферного расстояния (дополнительно).

Значения процентиля (дополнительно)

Это значение может варьироваться от 0 до 100. Значение по умолчанию равно 90.

Этот параметр доступен только в том случае, если параметр Выбрать тип статистики задан как Процентиль.

Указание способа пересчета (дополнительно)

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

  • Ближайшего соседа – Метод Ближайший сосед, который использует значение ближайшей ячейки, чтобы определить значение для ячейки выходного растра при пересчете. Используется по умолчанию.
  • Билинейная интерполяция – Метод Билинейная интерполяция, который определяет новое значение ячейки на основании средневзвешенного расстояния до четырех ближайших центров ячеек.
  • Кубическая свертка – Метод Кубическая свертка, который определяет новое значение ячейки на основании построения сглаживающей кривой через центры 16-ти ближайших ячеек.
Указание выходной компоновки (дополнительно)

Устанавливает, будут ли значения выборки отображаться в строках или столбцах выходной таблицы.

  • Значения выборки отображаются в отдельных строках – Отобранные значения будут отображаться в отдельных строках выходной таблицы. Используется по умолчанию.
  • Значения выборки отображаются в столбце – Отобранные значения будут отображаться в отдельных столбцах выходной таблицы.

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

Указание выходного типа (дополнительно)

Устанавливает, будет ли создан класс точечных объектов со значениями выборки в таблице или только таблица со значениями выборки.

  • Таблица – Создает таблицу со значениями выборки. Используется по умолчанию.
  • Пространственные объекты – Создает класс точечных объектов со значениями выборки в таблице. Если параметрами Выбор слоя местоположения являются полилинии или полигоны, то каждая точка на выходе будет центроидом любой геометрии входных объектов местоположения.
Имя слоя результата

Имя слоя, который будет добавлен в Мои ресурсы и на карту. Имя слоя по умолчанию зависит от имени инструмента и имени входного слоя. Если имя слоя уже используется, появится запрос ввести новое имя.

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

Подсказка:

Щелкните Показать кредиты до запуска анализа, чтобы узнать, сколько сервисных кредитов будет потрачено.

Параметры среды

Параметры среды анализа - это дополнительные параметры, которые влияют на результаты работы инструмента. Вы можете получить доступ к настройкам среды анализа инструмента, щелкнув кнопку шестеренки сред анализа Analysis Environments в верхней части панели инструментов.

Этот инструмент поддерживает следующие Параметры среды анализа:

  • Экстент - указывает область, которая будет использоваться для анализа.
  • Маска - указывает слой маски, в котором для анализа будут использоваться только ячейки, попадающие в область маски.

Сходные инструменты и функции растра

Используйте инструмент Извлечь по образцу для создания таблицы или класса точечных объектов со значениями данных в заданных местоположениях, которые были извлечены из растра или набора растров. Другие инструменты могут применяться для решения похожих задач.

Инструменты анализа Map Viewer Classic и функции растра

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

Инструменты анализа ArcGIS Pro и функции растра

Инструменты геообработки Извлечь по образцу, Зональная статистика и Зональная статистика в таблицу доступны в наборах инструментов Image Analyst и Spatial Analyst.Image Analyst

Инструменты Суммировать растр в пределах и Зональная статистика в таблицу доступны в наборе инструментов Анализ растров.

Зональная статистика также доступна как функция растра.

Ресурсы для разработчиков ArcGIS Enterprise

Если вы работаете в ArcGIS REST API, используйте задачи Sample, Summarize Raster Within или Zonal Statistics As Table.

Если вы работаете в ArcGIS API for Python, используйте sample веб-сайт ArcGIS for Python API, summarize_raster_within веб-сайт ArcGIS for Python API или zonal_statistics_as_table веб-сайт ArcGIS for Python API из модуля arcgis.raster.analytics, или используйте zonal_statistics веб-сайт ArcGIS for Python API из модуля arcgis.raster.functions.gbl.