Извлечь по маске—Справка

Доступно с лицензией Spatial Analyst.

Краткая информация
Иллюстрация
Использование
Синтаксис
Пример кода
Параметры среды
Информация о лицензиях

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

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

Иллюстрация

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

При использовании инструмента Извлечь по маске будет получен тот же результат, что и при определении настройки среды Маска за исключением того, что входная маска используется только для текущего запуска инструмента, а настройка среды для маски будет использоваться для всех инструментов до тех пор, пока она не будет изменена или отключена.
Если в качестве входного указан многоканальный растр, на выходе будет создан новый многоканальный растр. Соответственно, будет анализироваться каждый канал входного многоканального растра.
Выходным форматом по умолчанию является растр базы геоданных. Если в качестве выходного формата указан Esri Grid stack, его название не должно начинаться с цифры, содержать пробелы и должно иметь длину не более девяти символов.
Если входные данные – это слой, созданный на основании многоканального растра, состоящего из более, чем трех каналов, в операции извлечения будут учитываться только те каналы, которые были загружены слоем (отображены символами). В результате выходной многоканальный растр может иметь лишь три канала – в соответствии с используемыми для входного слоя каналами.
Если входные данные маски – растр, значения ячеек входного растра, отличные от NoData, будут записаны в соответствующие ячейки выходного растра. Инструментами, которые могут создать растр маски, являются Условие, Критерий и ряд других инструментов в группе Извлечение.
Если в качестве маски установлен многоканальный растр, в операции будет использован только первый канал.
Если входной растр целочисленный, выходной растр будет также целочисленным. Если входной растр с плавающей точкой, выходной растр также будет с плавающей точкой.
См. раздел Параметры среды анализа и Spatial Analyst для получения дополнительной информации о среде геообработки данного инструмента.

Синтаксис

ExtractByMask (in_raster, in_mask_data)

Параметр	Объяснение	Тип данных
in_raster	Входной растр, ячейки которого извлекаются.	Raster Layer
in_mask_data	Маска, определяющая область извлечения. Он может быть растром или набором классов объектов. Если данные маски представляют собой растр, то ячейкам выходного растра, соответствующим ячейкам NoData растра маски, также будут присвоены значения NoData.	Raster Layer \| Feature Layer

Параметр

Объяснение

Тип данных

in_raster

Входной растр, ячейки которого извлекаются.

Raster Layer

in_mask_data

Маска, определяющая область извлечения.

Он может быть растром или набором классов объектов.

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

Raster Layer | Feature Layer

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

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

Пример кода

ExtractByMask, пример 1 (окно Python)

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

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outExtractByMask = ExtractByMask("elevation", "mask.shp")
outExtractByMask.save("C:/sapyexamples/output/maskextract")

ExtractByMask, пример 2 (автономный скрипт)

# Name: ExtractByMask_Ex_02.py
# Description: Extracts the cells of a raster that correspond with the areas
#    defined by a mask.
# Requirements: Spatial Analyst Extension

# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *

# Set environment settings
env.workspace = "C:/sapyexamples/data"

# Set local variables
inRaster = "elevation"
inMaskData = "mask.shp"

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Execute ExtractByMask
outExtractByMask = ExtractByMask(inRaster, inMaskData)

# Save the output 
outExtractByMask.save("C:/sapyexamples/output/extractmask")

ArcMap

Извлечь по маске