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

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

Выходные данные - это размещенный векторный слой или размещенный слой таблицы.

Примеры

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

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

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

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

Входные слои

Группа Входные слои включает в себя следующие параметры:

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

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

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

Настройки образца

Группа Настройки образца включает в себя следующие параметры:

• Метод изменения разрешения — задает алгоритм пересчета, который используется в ходе процесса отбора образцов. Параметр включает следующие опции:
  • Ближайшего соседа – Метод Ближайший сосед, который использует значение ближайшей ячейки, чтобы определить значение для ячейки выходного растра при пересчете. Используется по умолчанию.
  • Билинейная интерполяция – Метод Билинейная интерполяция, который определяет новое значение ячейки на основании средневзвешенного расстояния до четырех ближайших центров ячеек.
  • Кубическая свертка – Метод Кубическая свертка, который определяет новое значение ячейки на основании построения сглаживающей кривой через центры 16-ти ближайших ячеек.
• Поле уникального ID — задает поле в слое, которое содержит разные значения для каждого местоположения или входного объекта.
• Обработать как многомерный — указывает, включают ли входные слои изображений многомерные данные.
• Информация о получении данных местоположения — задает время, глубину или другие данные получения, связанные с ячейками или пространственными объектами местоположений. Этот параметр доступен, если включена опция Обработать как многомерный, он включает следующие вложенные параметры:
  • Измерение — задает измерение входного многомерного слоя.
  • Поле начала или значение — задает поле, которое будет использоваться в качестве начала временного диапазона для многомерного входного слоя, или вводит определенное значение измерения.
  • Поле окончания или значение — задает поле, которое будет использоваться в качестве окончания временного диапазона для многомерного входного слоя, или вводит определенное значение измерения.
  • Относительное значение или дней до — задает неотрицательное число, используемое для добавления в поле Измерение, или значение, чтобы определить начало диапазона значений измерения.
  • Относительное значение или дней после — неотрицательное число, используемое для добавления в поле Измерение или значение, чтобы определить окончание диапазона значений измерения.
• Тип статистики — задает вычисляемый тип статистики. Этот параметр доступен, если включена опция Обработать как многомерный. Тип статистики включает в себя следующие опции:
  • Минимум – Находит минимальное значение в заданном диапазоне.
  • Максимум – Находит максимальное значение в заданном диапазоне.
  • Медианное – Находит медианное значение в заданном диапазоне.
  • Среднее – Вычисляет среднее значение для заданного диапазона.
  • Сумма – Вычисляет сумму переменных в пределах заданного диапазона.
  • Большинство – Находит значение, которое встречается чаще всего.
  • Меньшинство – Находит значение, которое встречается реже всего.
  • Среднеквадратическое отклонение – Вычисляет среднеквадратическое отклонение.
  • Процентиль – Вычисляет заданный процентиль в пределах заданного диапазона.
• Значение процентиля — указывает процентиль, который будет использоваться при извлечении образцов. Этот параметр доступен, если включена опция Обработать как многомерный, и Процентиль выбран в качестве Типа статистики.

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

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

Слой результата

Группа Слой результата включает в себя следующие параметры:

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

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

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

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

• Выходная система координат
• Экстент обработки

  Примечание:

  Экстент обработки по умолчанию в Map Viewer - это Полный экстент. Это значение по умолчанию отличается от Map Viewer Classic, в котором по умолчанию включен параметр Использовать текущий экстент карты.

• Маска
• Коэффициент параллельной обработки

Выходные данные

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

• Векторный слой со значениями пикселов из исходных слоев изображений для каждого входного местоположения в таблице атрибутов. Векторный слой создается, если параметр Тип выходных данных задан как Объекты. Векторный слой будет включать следующие поля:
  • X— указывает горизонтальную координату входной точки.
  • Y— указывает вертикальную координату входной точки.
  • Поля, содержащие значения для каждого канала растра или исходного растра (имя канала растра должно быть включено в имя поля).

    Примечание:

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

• Слой таблицы со значениями пикселов из исходных слоев изображений для каждого входного местоположения в таблице атрибутов. Слой таблицы создается, если параметр Тип выходных данных задан как Таблица. Слой таблицы будет включать следующие столбцы:
  • X— указывает горизонтальную координату входной точки.
  • Y— указывает вертикальную координату входной точки.
  • Столбцы, содержащие значения для каждого канала растра или исходного растра (имя канала растра должно быть включено в имя столбца).

Требования к использованию

Для этого инструмента требуются следующие лицензии и конфигурации:

• Тип пользователя Creator или GIS Professional
• Роль Издатель или Администратор или эквивалентная пользовательская роль
• Доступно, если организация настроена для анализа растров с лицензией премиум

Ресурсы

Для дополнительной информации см. следующие ссылки:

• Извлечь по образцу в ArcGIS REST API
• sample в ArcGIS API for Python
• Извлечь по образцу в ArcGIS Pro