Извлечь по маске (Инструменты Spatial Analyst)

Краткая информация

Извлекает ячейки растра, соответствующие площади, ограниченной маской.

Иллюстрация

OutRas = ExtractByMask(InRas1, InMsk1, "INSIDE")

Использование

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

• Если для параметра Входной растр (in_raster в Python) указан многоканальный растр, будет обработаны все каналы.

  Чтобы обработать выбранные каналы многоканального растра, сначала создайте набор растровых данных, состоящий только из необходимых каналов, с помощью инструмента Объединить каналы. Затем используйте результат в качестве Входного растра (in_raster в Python).

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

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

• Если Входной растр (in_raster в Python) и растровые данные Входные растровые или векторные данные маски (in_mask_data в Python) имеют одинаковый размер ячейки и ячейки выровнены, они будут непосредственно использованы в инструменте. Они не будут пересчитываться при выполнении инструмента.

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

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

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

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

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

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

• Значение по умолчанию Экстент анализа вычисляется на основе пересечения значений Входной растр и Входные векторные или растровые данные маски.

• Если экстент анализа не указан явно в качестве значения параметра, он будет получен из настроек среды анализа.

• См. Параметры среды анализа и Spatial Analyst для получения дополнительной информации о параметрах среды геообработки, применимых к этому инструменту.

Параметры

• Dialog
• Python

Подпись	Объяснение	Тип данных
Входной растр	Входной растр, ячейки которого извлекаются.	Raster Layer
Входные векторные или растровые данные маски	Входные данные маски, определяющие местоположения точек для извлечения. Он может быть растром или набором классов объектов. Если данные маски представляют собой растр, то ячейкам выходного растра, соответствующим ячейкам NoData растра маски, также будут присвоены значения NoData. Если входная маска представляет собой векторные данные, ячейки входного растра, центр которых попадает внутрь заданной геометрии объекта, будут включены в выходные данные, а ячейки, центр которых находится вне объекта, получат значение NoData.	Raster Layer; Feature Layer
Область извлечения (Дополнительный)	Определяет, будут ли ячейки, расположенные внутри или снаружи местоположений, определенных входной маской, выбраны и записаны в выходной растр. Внутри–Ячейки входной маски будут выбраны и записаны в выходной растр. Все ячейки, которые за пределами маски, будут иметь значения NoData в выходном растре. Эта опция используется по умолчанию. Снаружи–Ячейки за пределами входной маски будут выбраны и записаны в выходной растр. Все ячейки, покрытые маской, получат NoData.	String
Экстент анализа (Дополнительный)	Экстент, определяющий область извлечения. По умолчанию экстент вычисляется на основе пересечения значений Входной растр и Входные векторные или растровые данные маски. Обработка будет выполняться до границ по x и y, и ячейками вне этого экстента будет присвоено значение NoData. Координаты задаются в тех же единицах карты, что и входной растр, если иное не задано параметрах среды анализа. Текущий экстент отображения — Экстент будет основан на активной карте или сцене. Нарисовать экстент - Экстент будет основан на прямоугольнике, нарисованном на карте или в сцене. Экстент слоя — Экстент будет основан на активном слое карты. Выберите доступный слой или воспользуйтесь опцией Экстент данных во всех слоях. У каждого слоя карте есть следующие опции: Все объекты - Экстент всех объектов. Выбранные объекты - используйте экстент выбранных объектов. Отображаемые объекты - Экстент отображаемых объектов. Обзор — Экстент будет основан на наборе данных. Буфер обмена - Экстент может быть скопирован в буфер обмена и вставлен из него. Копировать экстент - Копирует координаты экстента и систему координат в буфер обмена. Вставить экстент - Вставляет экстент и систему координат из буфера обмена. Если буфер обмена не содержит систему координат, экстент будет использовать систему координат карты. Сбросить экстент — Экстент будет сброшен до значения по умолчанию. Если координаты заданы вручную, они должны быть числовыми значениями в системе координат активной карты. На карте могут использоваться единицы отображения, отличные от введенных координат. Используйте знак отрицательного значения для координат юга и запада.	Extent

Возвращаемое значение

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

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

Автоподтверждение, Размер ячейки, Метод проецирования размера ячейки, Сжатие, Текущая рабочая область, Экстент, Географические преобразования, Маска, Выходное ключевое слово конфигурации, Выходная система координат, Временная рабочая область, Растр привязки, Размер листа

Информация о лицензировании

• Basic: Требуется Spatial Analyst
• Standard: Требуется Spatial Analyst
• Advanced: Требуется Spatial Analyst

Связанные разделы

• Обзор группы инструментов Извлечение
• Поиск инструмента геообработки