- этот инструмент создает таблицу или класс точечных объектов, содержащую значения ячеек растра или набора растров для определенных местоположений. Местоположения определяются ячейками растра, полигональными объектами, линейными объектами или набором точек.
Примечание:
Теперь этот инструмент доступен в Map Viewer, современный инструмент для создания карт в ArcGIS Enterprise. Более подробно см. в Извлечь по образцу(Map Viewer).
Для запуска этого инструмента организация должна быть настроена для аналитики растров.
Если вы не видите этот инструмент в Map Viewer Classic, свяжитесь с администратором организации. Возможно, ваш портал не настроен для анализа растров, или у вас может не быть прав, необходимых для запуска инструмента.
Схема рабочего процесса
Примеры
Примерами применения этого инструмента могут быть:
- Извлечь атрибуты местоположения вышки сотовой связи из нескольких растров, таких как землепользование, тип почвы, высота и расстояние до дороги.
- Извлечь температуру почвы на разных глубинах для заданного набора точек.
- Исходя из 30-летних ежемесячных данных о температуре морской поверхности, суммировать данные о местонахождении животных или в пределах домашних ареалов за данный период времени, когда тот или иной вид животных был под наблюдением.
Примечания по использованию
Значения ячеек будут извлекаться из всех входных растров в каждом местоположении. Будет создана таблица или класс точечных объектов со значениями ячеек для каждого входного растра. Дополнительные атрибуты из таблицы входного растра не будут включены в выходную таблицу.
В качестве входных данных могут быть заданы любые сочетания растров, в том числе одноканальные, многоканальные, многомерные или многовариантные. Структура выходной таблицы изменяется, когда входные растры являются многомерными. Если многоканальный растр указан как один из входных, то будут использоваться все его каналы. Чтобы обработать выбранные каналы входного многоканального растра, сначала создайте набор растровых данных, состоящий только из этих конкретных каналов. Затем укажите полученный набор в списке входных растров.
Входным местоположением могут быть растр или класс пространственных объектов.
- Растр – Пикселы с допустимыми значениями (не NoData) используются для извлечения значений этого пиксела изо всех входных растров, а центр этого пиксела используется для местоположений точек.
- Точка – Значения будут отбираться в каждом местоположении точек.
- Полилиния или полигон – Значения будут отбираться в центроиде полигона или полилинии. Если первый растр – многомерный, значения будут агрегироваться в зависимости от типа Статистики.
В выходную таблицу будет добавлено поле для хранения значений, указанных в параметре Указание поля уникального идентификатора. По умолчанию имя поля совпадает с именем входного набора данных местоположения. Рекомендуется использовать поле, содержащее уникальные значения, как идентификатор каждого местоположения для последующего анализа.
Местоположениям, которые извлекают значения из ячеек NoData во входном растре, в выходной таблице будет присвоено значение <null>.
Входные растры отбираются в их собственной пространственной привязке и разрешении. Если имеется несколько входных растров с различными пространственными привязками, входные местоположения проецируются на пространственную привязку каждого отдельного растра, из которой извлекаются значения. Среда анализа применяется к входным местоположениям, но входные растры не будут соответствовать среде анализа.
Пространственная привязка координат x,y в выходной таблице выборок или классе пространственных объектов такая же, что и у входного растра местоположений или точечных объектов, если только она не указана в параметре среды Выходная система координат. Если пространственная привязка входных местоположений неизвестна, пространственная привязка координат x,y также останется неизвестной. Если входное местоположение является классом точечных объектов без пространственного индекса, появится предупреждение. Чтобы повысить производительность инструмента для входных данных с большим количеством точек, создайте пространственный индекс.
Для выполнения анализа с мультиточечными объектами, сначала конвертируйте их в отдельные точечные объекты, перед тем, как использовать их в этом инструменте.
Параметр Указание информации о сборе данных о местоположениях будет использоваться для указания поднабора входного многомерного растра, используемого для выборки.
- При указании размера, начального значения и конечного значения обрабатываются срезы в пределах начального и конечного значений. Конечное значение по умолчанию – это максимальное значение размера. Для измерения времени укажите значение в стандартном формате. Для других измерений укажите значение в той же единице измерения, что и для входного растра.
- Когда заданы размер, начальное поле и конечное поле (начальное поле и конечное поле взяты из данных местоположения), значения из этих полей используются для указания подмножества входного растра при выборке значений в этом местоположении.
- Относительное значение или дни до и Относительное значение или дни после можно использовать для указания поднабора относительно начального значения, в котором значение до указывает начало поднабора, а значение после – конец поднабора. Значения времени задаются в днях, а другие значения измерений задаются в той же единице измерения, что и значения входного растра.
Параметр Выберите тип статистики агрегирует значения параметра Входного растра, заданного поднабором в параметре Указать информацию о сборе данных местоположений.
Если выбрана опция Значения образца в строках, извлеченные значения сохраняются в поле с тем же именем, что и переменная. Создаются дополнительные поля для хранения значений непространственных размерностей, с тем же именем, что и размерность. Если выбрано Значения образца в столбцах, извлеченные значения сохраняются в полях, имена которых соответствуют условию <variable_name>_<dimension_name>_<dimension_value> .
Если в многомерном растре есть несколько каналов, для каждого из них создается дополнительное поле, в котором хранится значение, извлеченное из этого канала.
Если параметр Указание способа пересчета задан как Ближайшее, тип поля в выходной таблице будет соответствовать типу растра. Если используется опция пересчета Билинейная или Кубическая, тип поля всегда будет иметь плавающую точку, чтобы поддерживать точность интерполированных значений.
По умолчанию в качестве выходных данных вы получаете Таблицу. Если в качестве Объектов выбран параметр Указание выходного типа, то на выходе будет класс точечных объектов с выборочными значениями в таблице атрибутов. Ниже приведены возможные типы местоположений с описанием того, как будут отбираться значения:
- Растр—Точки будут создаваться с использованием местоположения центра ячейки.
- Точка—Точка будет создана в каждом из местоположений точек.
- Полилиния или полигон—Точка будет создана в каждом центроиде полигона или полилинии.
Пространственная привязка выходного класса пространственных объектов такая же, что и у входного растра местоположений или точечных объектов, если только она не указана в параметре среды Выходная система координат.
Параметр среды Коэффициент параллельной обработки поддерживается, только если входные данные представлены многомерным растром.
Если объект задан в среде Маска, внутренний растр создается с использованием минимального размера ячейки входных растров. Во время извлечения внутренний растр маски снова пересчитывается до размера ячейки каждого входного растра.
Если отмечена опция Использовать текущий экстент карты, анализироваться будут только переменные или каналы слоя, видимые в текущем экстенте карты. Если опция отключена, будут анализироваться переменные или каналы всего слоя, даже если они находятся за пределами текущего экстента карты.
Параметры этого инструмента перечислены в следующей таблице:
| Параметр | Объяснение |
|---|---|
| Выбор слоя (слоев) изображений для извлечения по образцу | Одно изображение или список изображений, значения которых будут отобраны в качестве образцов на основании входных данных местоположений. Для отбора всех срезов из многомерного слоя изображений это должен быть единственный входной растр. |
| Выбор слоя местоположения | Данные, определяющие позиции, которые вы хотите отобрать. Входными данными о местоположении могут быть растр или класс объектов точек, полилиний или полигонов. |
| Указание поля уникального ID (дополнительно) | Поле, содержащее отличающиеся значения для каждого местоположения или объекта во входном растре местоположения или классе объектов. |
| Указание информации о сборе данных о местоположениях (необязательно) | Укажите время, глубину или другие собранные данные, связанные с местоположениями или объектами. Для каждого измерения существует три варианта указания информации о сборе данных, имеющей отношение к местоположениям или объектам:
Этот параметр доступен только в том случае, если параметр Выбрать слой изображений для образца является многомерным растром. |
| Указание поля или значения буферного расстояния (дополнительно) | Заданное расстояние вокруг объектов местоположений. Буферное расстояние задается в линейных единицах пространственной привязки объектов местоположений. Если объект использует географическую привязку, такими единицами будут градусы. Статистика будет рассчитываться в пределах этой буферной области. Этот параметр доступен только в том случае, если параметр Выбрать слой изображений для образца является многомерным растром. |
| Выбор типа статистики (дополнительно) | Тип вычисляемой статистики.
Этот параметр доступен только в том случае, если параметр Выбрать слой изображений для образца является многомерным растром, а параметры Выбор слоя местоположения являются полилиниями или полигонами, или задано Указание поля или значения буферного расстояния (дополнительно). |
| Значения процентиля (дополнительно) | Это значение может варьироваться от 0 до 100. Значение по умолчанию равно 90. Этот параметр доступен только в том случае, если параметр Выбрать тип статистики задан как Процентиль. |
| Указание способа пересчета (дополнительно) | Алгоритм передискретизации, используемый при отборе образцов на растре.
|
| Указание выходной компоновки (дополнительно) | Устанавливает, будут ли значения выборки отображаться в строках или столбцах выходной таблицы.
Этот параметр доступен, только когда параметр Выбрать слой изображений для образца является входным многомерным растром и содержит одну переменную и одно измерение, а каждый срез является одноканальным растром. |
| Указание выходного типа (дополнительно) | Устанавливает, будет ли создан класс точечных объектов со значениями выборки в таблице или только таблица со значениями выборки.
|
| Имя слоя результата | Имя слоя, который будет добавлен в Мои ресурсы и на карту. Имя слоя по умолчанию зависит от имени инструмента и имени входного слоя. Если имя слоя уже используется, появится запрос ввести новое имя. Вы можете указать имя папки в Моих ресурсах, где будет сохранен результат, с помощью ниспадающего списка Сохранить результат в. |
Параметры среды
Параметры среды анализа - это дополнительные параметры, которые влияют на результаты работы инструмента. Вы можете получить доступ к настройкам среды анализа инструмента, щелкнув значок шестеренки 
в верхней части панели инструментов.
Этот инструмент поддерживает следующие Параметры среды анализа:
- Выходная система координат - Задает систему координат выходного слоя.
- Экстент - указывает область, которая будет использоваться для анализа.
- Маска - указывает слой маски, в котором для анализа будут использоваться только ячейки, попадающие в область маски.
- Коэффициент параллельной обработки - управляет экземплярами ЦПУ или графического процессора для обработки растров.
Сходные инструменты и функции растра
Используйте инструмент Извлечь по образцу для создания таблицы или класса точечных объектов со значениями данных в заданных местоположениях, которые были извлечены из растра или набора растров. Другие инструменты могут применяться для решения похожих задач.
Инструменты анализа 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 
, summarize_raster_within или zonal_statistics_as_table из модуля arcgis.raster.analytics, или используйте zonal_statistics из модуля arcgis.raster.functions.gbl.