Остаток (Spatial Analyst)

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

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

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

Находит остаток (по модулю) первого растра при делении на второй растр по принципу ячейка-за-ячейкой.

Иллюстрация

OutRas = Mod(InRas1, InRas2)

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

• Порядок входных данных имеет значение для этого инструмента.

• Инструмент Остаток предполагает, что оба входных набора данных являются целочисленными. Если один из наборов не является целочисленным, эти данные будут преобразованы в целые числа посредством округления. Выходные значения всегда целочисленные.

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

• Если второе входное значение (делитель) больше, чем первое входное значение (делимое), выходные данные будет иметь то же значение, что и первые. Например, если вы собираетесь разделить значение 8 на значение 10, вычисление деления целых чисел выдаст входное значение 8 в качестве остатка.

• Если оба входных растра одноканальные либо одни из входных данных представлены константой, выходной растр будет одноканальным.

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

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

• В ArcPy если все входные данные являются многомерными растрами с одинаковым количеством переменных, инструмент выполнит операцию для всех срезов с одинаковым значением измерения, а на выходе будет многомерный растр. Переменные во входных данных должны иметь одинаковую размерность или общую размерность, но никаких нетипичных измерений.

  Если в обоих входных наборах данных есть одна переменная, но разные названия, задайте переменную геообработки matchMultidimensionalVariable как False, чтобы выполнить операцию.

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

• В Алгебре карт эквивалентным символом для этого оператора является "%" (ссылка).

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

Параметры

Диалог

Подпись	Описание	Тип данных
Входной растр или постоянное значение 1	Входные данные числителя. В качестве входных данных для этого параметра может использоваться число, при условии, что для другого параметра задан растр. Чтобы задать число для двух входных данных, необходимо сперва указать экстент и размер ячейки в параметрах среды.	Raster Layer; Constant
Входной растр или постоянное значение 2	Входные данные знаменателя. В качестве входных данных для этого параметра может использоваться число, при условии, что для другого параметра задан растр. Чтобы задать число для двух входных данных, необходимо сперва указать экстент и размер ячейки в параметрах среды.	Raster Layer; Constant

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

Подпись	Описание	Тип данных
Выходной растр	Выходной растр. Значениями ячеек является остаток от деления значений первых входных данных на вторые.	Raster

Python

Mod(in_raster_or_constant1, in_raster_or_constant2)

Имя	Описание	Тип данных
in_raster_or_constant1	Входные данные числителя. В качестве входных данных для этого параметра может использоваться число, при условии, что для другого параметра задан растр. Чтобы задать число для двух входных данных, необходимо сперва указать экстент и размер ячейки в параметрах среды.	Raster Layer; Constant
in_raster_or_constant2	Входные данные знаменателя. В качестве входных данных для этого параметра может использоваться число, при условии, что для другого параметра задан растр. Чтобы задать число для двух входных данных, необходимо сперва указать экстент и размер ячейки в параметрах среды.	Raster Layer; Constant

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

Имя	Описание	Тип данных
out_raster	Выходной растр. Значениями ячеек является остаток от деления значений первых входных данных на вторые.	Raster

Пример кода

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

В этом примере выдается значение остатка (модуля) деления ячеек в первом растре на ячейки во втором.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outMod = Mod("degs", "negs")
outMod.save("C:/sapyexamples/output/outmod.tif")

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

В этом примере выдается значение остатка (модуля) деления ячеек в первом растре на ячейки во втором.

# Name: Mod_Ex_02.py
# Description: Finds the remainder of the first raster when divided by
#              the second raster on a cell-by-cell basis
# 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
inRaster1 = "degs"
inRaster2 = "negs"

# Execute Mod
outMod = Mod(inRaster1, inRaster2)

# Save the output 
outMod.save("C:/sapyexamples/output/outmod")

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

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

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

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

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