Доступно с лицензией Spatial Analyst.
Краткая информация
Извлекает ячейки растра, соответствующие площади, ограниченной маской.
Иллюстрация
Использование
Если в качестве входного указан многоканальный растр, на выходе будет создан новый многоканальный растр. Соответственно, будет анализироваться каждый канал входного многоканального растра.
Если в качестве маски установлен многоканальный растр, в операции будет использован только первый канал.
Если в параметрах среды задана Маска, при использовании инструмента Извлечь по маске в выходном растре будут находится значения ячеек только для области, которая находится в пределах пересечения маски среды и входных данных по маске.
См. раздел Параметры среды анализа и Spatial Analyst для получения дополнительной информации о среде геообработки данного инструмента.
Синтаксис
ExtractByMask (in_raster, in_mask_data)
| Параметр | Объяснение | Тип данных |
in_raster | Входной растр, ячейки которого извлекаются. | Raster Layer |
in_mask_data | Маска, определяющая область извлечения. Он может быть растром или набором классов объектов. Если данные маски представляют собой растр, то ячейкам выходного растра, соответствующим ячейкам NoData растра маски, также будут присвоены значения 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")
Параметры среды
Информация о лицензиях
- ArcGIS Desktop Basic: Требует Spatial Analyst
- ArcGIS Desktop Standard: Требует Spatial Analyst
- ArcGIS Desktop Advanced: Требует Spatial Analyst