Отсечение (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 для получения дополнительной информации о среде геообработки данного инструмента.

Синтаксис

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

Parameter	Объяснение	Тип данных
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

Значение отраженного сигнала

Name	Объяснение	Тип данных
out_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")

Environments

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

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

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