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

Выходной растр, к которому было применено отсечение.

Идентифицированные входные ячейки будут заменены значениями ближайших к ним соседей.

Если 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")

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

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

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