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

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

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

Иллюстрация

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

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

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

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

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

Подпись

Объяснение

Тип данных

Входной растр

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

Raster Layer

Экстент

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

Текущий экстент отображения — Экстент будет основан на активной карте или сцене.
Нарисовать экстент - Экстент будет основан на прямоугольнике, нарисованном на карте или в сцене.
Экстент слоя — Экстент будет основан на активном слое карты. Выберите доступный слой или воспользуйтесь опцией Экстент данных во всех слоях. У каждого слоя карте есть следующие опции:
- Все объекты - Экстент всех объектов.
- Выбранные объекты - используйте экстент выбранных объектов.
- Отображаемые объекты - Экстент отображаемых объектов.
Обзор — Экстент будет основан на наборе данных.
Буфер обмена - Экстент может быть скопирован в буфер обмена и вставлен из него.
- Копировать экстент - Копирует координаты экстента и систему координат в буфер обмена.
- Вставить экстент - Вставляет экстент и систему координат из буфера обмена. Если буфер обмена не содержит систему координат, экстент будет использовать систему координат карты.
Сбросить экстент — Экстент будет сброшен до значения по умолчанию.

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

Координаты задаются в тех же единицах карты, что и входной растр.

Extent

Область извлечения

(Дополнительный)

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

Внутри–Ячейки, расположенные внутри входного прямоугольника должны быть выбраны и записаны в выходной растр. Все ячейки за пределами входного прямоугольника будут иметь значения NoData в выходном растре.
Снаружи–Ячейки, расположенные внутри или снаружи входного прямоугольника должны быть выбраны и записаны в выходной растр. Все ячейки внутри входного прямоугольника будут иметь значения NoData в выходном растре.

String

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

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

ExtractByRectangle(in_raster, rectangle, {extraction_area})

Имя Объяснение Тип данных

Имя	Объяснение	Тип данных
in_raster	Входной растр, ячейки которого извлекаются.	Raster Layer
rectangle [extent,...]	Прямоугольник, определяющий область извлечения. `MAXOF` – Будет использоваться максимальный экстент всех входных данных. `MINOF` – Будет использоваться минимальная область, которая является общей для всех входных данных. `DISPLAY` — Экстент равен видимому отображению. Имя слоя — Будет использоваться экстент указанного слоя. `Extent` Объект — будет использоваться экстент указанного объекта. Строка координат, разделенная пробелами – Будет использоваться экстент указанной строки. Координаты выражаются в порядке x-мин, y-мин, x-макс, y-макс. Координаты задаются в тех же единицах карты, что и входной растр.	Extent
extraction_area (Дополнительный)	Определяет, будут ли ячейки, расположенные внутри или снаружи входного прямоугольника должны быть выбраны и записаны в выходной растр. `INSIDE`–Ячейки, расположенные внутри входного прямоугольника должны быть выбраны и записаны в выходной растр. Все ячейки за пределами входного прямоугольника будут иметь значения NoData в выходном растре. `OUTSIDE`–Ячейки, расположенные внутри или снаружи входного прямоугольника должны быть выбраны и записаны в выходной растр. Все ячейки внутри входного прямоугольника будут иметь значения NoData в выходном растре.	String

in_raster

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

Raster Layer

rectangle [extent,...]

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

MAXOF – Будет использоваться максимальный экстент всех входных данных.
MINOF – Будет использоваться минимальная область, которая является общей для всех входных данных.
DISPLAY — Экстент равен видимому отображению.
Имя слоя — Будет использоваться экстент указанного слоя.
Extent Объект — будет использоваться экстент указанного объекта.
Строка координат, разделенная пробелами – Будет использоваться экстент указанной строки. Координаты выражаются в порядке x-мин, y-мин, x-макс, y-макс.

Координаты задаются в тех же единицах карты, что и входной растр.

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)

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

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

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

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

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

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

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

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

Иллюстрация

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

Параметры

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

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

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

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