Доступно с лицензией Spatial Analyst.
Сводка
Извлекает ячейки растра с использованием прямоугольника путем задания его экстента.
Иллюстрация
Использование
Дополнительные атрибуты входного растра, если имеются, будут перенесены в атрибутивную таблицу выходного растра без изменений. В зависимости от записываемого параметра, для некоторых атрибутивных значений может потребоваться пересчет.
Если для параметра Входной растр (in_raster в Python) указан многоканальный растр, будет обработаны все каналы.
Чтобы обработать выбранные каналы входного многоканального растра, сначала создайте новый набор растровых данных, состоящий только из необходимых каналов, с помощью инструмента Объединить каналы. Затем используйте полученный результат как Входной растр (in_raster в Python).
Выходным форматом по умолчанию является растр базы геоданных. Если в качестве выходного формата указан Esri Grid stack, название стека не должно начинаться с цифры, содержать пробелы и должно иметь длину не более девяти символов.
Для определения, попадает ячейка в прямоугольник или за пределы прямоугольника, используется центр ячейки. Если центр ячейки в попадает в область, определенную контуром прямоугольника, ячейка считается полностью в пределах прямоугольника, даже если часть ячейки попадает за пределы этого прямоугольника.
Не выбранным ячейкам присваивается значение NoData.
Если входной растр целочисленный, выходной растр будет также целочисленным. Если входной растр с плавающей точкой, выходной растр также будет с плавающей точкой.
См. раздел Среда анализа и Spatial Analyst для получения дополнительной информации о среде геообработки данного инструмента.
Синтаксис
ExtractByRectangle(in_raster, rectangle, {extraction_area})| Parameter | Объяснение | Тип данных |
in_raster | Входной растр, ячейки которого извлекаются. | Raster Layer |
rectangle extent | Прямоугольник, определяющий область извлечения. Экстент используется для определения координат. Форма объекта:
Координаты задаются в тех же единицах карты, что и входной растр. | Extent |
extraction_area (Дополнительный) | Определяет, будут ли извлечены ячейки внутри или снаружи прямоугольника.
| String |
Значение отраженного сигнала
| Name | Объяснение | Тип данных |
| out_raster | Выходной растр, содержащий значения ячеек, извлеченные из входного растра. | Raster |
Пример кода
В этом примере извлекаются ячейки вне прямоугольного экстента в новый растр.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
rectExtract = ExtractByRectangle("elevation",
Extent(477625, 213900, 486400, 224200),
"OUTSIDE")
rectExtract.save("c:/sapyexamples/output/extrect")В этом примере извлекаются ячейки внутри прямоугольного экстента в новый растр.
# Name: ExtractByRectangle_Ex_02.py
# Description:
# 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"
inRectangle = Extent(477625, 213900, 486400, 224200)
# Execute ExtractByRectangle
rectExtract = ExtractByRectangle(inRaster, inRectangle, "INSIDE")
# Save the output
rectExtract.save("c:/sapyexamples/output/extrect02")Environments
Информация о лицензиях
- Basic: Требуется Spatial Analyst
- Standard: Требуется Spatial Analyst
- Advanced: Требуется Spatial Analyst