Отсечение (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]).

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

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

Параметры

Диалог

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

Особые случаи

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

• Basic: Обязательно Spatial Analyst
• Standard: Обязательно Spatial Analyst
• Advanced: Обязательно Spatial Analyst