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

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

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

Примеры

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

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

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

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

Входной слой

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

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

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

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

    Количество объектов зависит от дополнительных факторов, таких как критерии фильтрации и экстент анализа.

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

    Количество объектов зависит от дополнительных факторов, таких как критерии фильтрации и экстент анализа.

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

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

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

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

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

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

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

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

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

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

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

• Выходная система координат
• Географические преобразования
• Экстент обработки

  Примечание:

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

• Маска

Кредиты

Этот инструмент расходует кредиты.

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

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

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

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

    Примечание:

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

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

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

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

• Тип пользователя Professional или Professional Plus
• Роль Издатель, Посредник или Администратор, или эквивалентная пользовательская роль с правами доступа Imagery Analysis

Ресурсы

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

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