Отсечение (Spatial Analyst)

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

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

Заменяет ячейки растра в соответствии с маской из значений их ближайшего соседа.

Более подробно о том, как работает инструмент Отсечение

Иллюстрация

OutRas = Nibble(InRas1, Mask_Ras)

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

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

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

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

  Ячейки NoData во входном растре, которые не попадают под маску, не будут заменяться. У ячеек останется значение NoData, независимо от настроек двух параметров NoData.

• Этот инструмент поддерживает параллельную обработку. Если ваш компьютер имеет несколько процессоров или процессор с несколькими ядрами, то его производительность будет более высокой, особенно на больших наборах данных. Раздел справки Параллельная обработка и Spatial Analyst содержит более подробные сведения об этой возможности и способах ее настройки.

  При использовании параллельной обработки будут записаны временные данные для управления обрабатываемыми фрагментами данных. Расположение папки временных файлов по умолчанию будет на вашем локальном диске C. Вы можете управлять расположением этой папки, настроив Переменную системной среды с именем TempFolders и указав путь к папке, которая будет использоваться (например, E:\RasterCache). При наличии прав администратора на вашем компьютере, вы также можете использовать ключ реестра (например, [HKEY_CURRENT_USER\SOFTWARE\ESRI\ArcGISPro\Raster]).

  По умолчанию, этот инструмент использует половину доступных ядер. Если размер входных данных меньше, чем 5000 на 5000 ячеек, может использоваться меньшее число ядер. Можно задавать число используемых инструментом ядер в среде Коэффициент параллельной обработки.

• См. раздел Параметры среды анализа и Spatial Analyst для получения дополнительной информации о среде геообработки данного инструмента.

Параметры

Диалог

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

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

Подпись	Описание	Тип данных
Выходной растр	Выходной растр с замененными ячейками. Идентифицированные входные ячейки будут заменены значениями ближайших к ним соседей. Если in_raster целочисленный, выходной растр будет также целочисленным. Если используется растр с плавающей точкой, выходной растр также будет с плавающей точкой.	Raster

Python

Nibble(in_raster, in_mask_raster, {nibble_values}, {nibble_nodata}, {in_zone_raster})

Имя	Описание	Тип данных
in_raster	Входной растр с маскированными местоположениями, которые будут заменены значением их ближайшего соседа. Тип входного растра может быть целочисленным или с плавающей точкой.	Raster Layer
in_mask_raster	Растр, определяющий местоположения во входном растре, которые будут заменены. Ячейки со значением NoData считаются находящимися в маскированной области. В выходном растре такие местоположения будут заменены значением ближайшего соседа, согласно значению in_raster. Растр маски может быть целочисленным или с плавающей точкой.	Raster Layer
nibble_values (Дополнительный)	Определяет, могут ли ячейки NoData во входном растре заменять ячейки в маскированных областях, если они являются ближайшими соседями. ALL_VALUES—Как NoData, так и значения данных, могут заменять ячейки в области маскирования. Это значит, что значения NoData во входном растре могут заменять области, определяемые в маске, если они являются ближайшими соседями. Это значение по умолчанию DATA_ONLY—Ячейки в области маскирования.могут быть заменены только значениями данных. Значения NoData во входном растре не могут заменять области, определяемые в маске, даже если они являются ближайшими соседями.	Boolean
nibble_nodata (Дополнительный)	Указывает, будут ли сохранены или заменены ячейки NoData во входном растре, которые находятся в пределах области маскирования. PRESERVE_NODATA—Ячейки NoData во входном растре, которые находятся в пределах области маски, остаются (как NoData) в выходных данных. Это значение по умолчанию PROCESS_NODATA—Ячейки NoData во входном растре, которые находятся в пределах области маски, могут быть заменены значением ближайшего соседа, находящегося за пределами области маски.	Boolean
in_zone_raster (Дополнительный)	Входной растр зон. Для каждой зоны, входные ячейки, находящиеся в пределах маски, будут заменяться значениями ближайших ячеек из той же самой зоны. Зона – это все ячейки растра, которые имеют одно значение, не зависимо от того, являются ли они непрерывными или нет. Входной слой зон определяет форму, значения и местоположения зон. Растр зон может быть целочисленным или с плавающей точкой.	Raster Layer

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

Имя	Описание	Тип данных
out_raster	Выходной растр с замененными ячейками. Идентифицированные входные ячейки будут заменены значениями ближайших к ним соседей. Если in_raster целочисленный, выходной растр будет также целочисленным. Если используется растр с плавающей точкой, выходной растр также будет с плавающей точкой.	Raster

Пример кода

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

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

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
nibbleOut = Nibble("land", "snow", "DATA_ONLY")
nibbleOut.save("C:/sapyexamples/output/nibbleout")

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

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

# Name: Nibble_Ex_02.py
# Description: Replaces cells of a raster corresponding to a mask 
#              with the values of the nearest neighbors.
# 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 = "land"
inMask = "snow"

# Execute Nibble
nibbleOut = Nibble(inRaster, inMask, "ALL_VALUES")

# Save the output 
nibbleOut.save("C:/sapyexamples/output/outnibble")

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

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