% (Modulo) operator

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

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

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

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

Иллюстрация

Иллюстрация Остаток от деления
OutRas = Raster("InRas1") % Raster("InRas2")

Обсуждение

При использовании оператора с растровым входом результат будет растром. Но если все входные значения — числа, результат будет числом.

Если в выражении используется несколько операторов, они не обязательно выполняются слева направо. Оператор с высшим значением приоритета будет выполнен первым. Более подробно см. в таблице приоритета операторов в разделе Работа с операторами в Алгебре карт. Порядок выполнения можно изменить с помощью скобок.

Для этого оператора важен порядок входных данных.

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

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

Другой способ выполнить вычитание – a %= b, что иным способом может быть записано как a = a % b.

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

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

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

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

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

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

Параметры

ОперандОписаниеТип данных
in_raster_or_constant1

Входные данные числителя.

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

Raster Layer | Constant
in_raster_or_constant2

Входные данные знаменателя.

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

Raster Layer | Constant

Пример кода

% (Остаток от деления) Пример 1 (окно Python)

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

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outMod = Raster("degs") % Raster("negs")
outMod.save("C:/sapyexamples/output/outmod.tif")
% (Остаток от деления), пример 2 (автономный скрипт)

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

# Name: Op_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 = Raster("degs")
inRaster2 = Raster("negs")

# Execute Mod
outMod = inRaster1 % inRaster2

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

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