Извлечь по прямоугольнику—Справка

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

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

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

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

Иллюстрация

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

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

Синтаксис

ExtractByRectangle (in_raster, rectangle, {extraction_area})

Параметр	Объяснение	Тип данных
in_raster	Входной растр, ячейки которого извлекаются.	Raster Layer
rectangle extent	Прямоугольник, определяющий область извлечения. Экстент используется для определения координат. Форма объекта: Extent(XMin, YMin, XMax, YMax) , где XMin иYMin определяют левый нижний угол области извлечения, а XMax и YMax – правый верхний угол. Координаты задаются в тех же единицах карты, что и входной растр.	Extent
extraction_area (Дополнительный)	Определяет, будут ли извлечены ячейки внутри или снаружи прямоугольника. INSIDE — Ключевое слово, определяющее, что ячейки, расположенные внутри входного прямоугольника должны быть выбраны и записаны в выходной растр. Все ячейки за пределами входного прямоугольника будут иметь значения NoData в выходном растре. OUTSIDE — Ключевое слово, определяющее, что ячейки, расположенные вне входного прямоугольника должны быть выбраны и записаны в выходной растр. Все ячейки внутри входного прямоугольника будут иметь значения NoData в выходном растре.	String

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

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

Пример кода

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

В этом примере извлекаются ячейки вне прямоугольного экстента в новый растр.

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")

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

В этом примере извлекаются ячейки внутри прямоугольного экстента в новый растр.

# 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)

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

# Execute ExtractByRectangle
rectExtract = ExtractByRectangle(inRaster, inRectangle, "INSIDE")

# Save the output 
rectExtract.save("c:/sapyexamples/output/extrect02")

ArcMap

Извлечь по прямоугольнику