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

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")

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

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

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