^ (Boolean XOr) operator

Spatial Analyst のライセンスで利用可能。

Image Analyst ライセンスで利用できます。

概要

Performs a Boolean Exclusive Or operation on the cell values of two input rasters.

Boolean XOr illustration
OutRas = Raster("InRas1") ^ Raster("InRas2")

ディスカッション

The ^ operator will perform a Boolean XOr operation when one or more input (operand) is a raster. If both inputs (operands) are numbers, then the ^ operator will perform a Bitwise XOr operation. For more information on how to work with operators, see Working with operators.

複数の演算子が式に使用されている場合、それらは必ずしも左から右への順に実行されるわけではありません。優先順位値が最も高い演算子が最初に実行されます。演算子の優先順位に関する詳細については、「演算子の優先順位のテーブル」をご参照ください。実行順序の制御には、括弧が使用できます。

ブール (~&^|) 演算子には、関係 (<<=>>===!=) 演算子よりも高い優先度があります。したがって、ブール演算子が関係演算子と同じ式に使用されている場合、ブール演算子が最初に実行されます。実行の順序を変更するには、括弧を使用します。

複数の関係および (または) ブール演算子が 1 つの式で連続して使用されているときは、場合によっては実行されない可能性があります。このような問題を避けるために、式に適切な括弧を使用して、演算の実行順序を明示的に定義します。詳細については、「複雑なステートメントのルール」をご参照ください。

ブール型の評価を実行するには、2 つの入力値が必要です。

この演算子では、入力の順序は結果に影響しません。

入力値が浮動小数点数値の場合は、ブール演算を実行する前に値を切り捨てて整数値に変換されます。出力値は、必ず整数になります。

Another way to perform the Boolean XOr operation is a ^= b, which is an alternative way to write a = a ^ b.

両方の入力がシングル バンド ラスターの場合、または入力の片方が定数の場合は、出力はシングル バンド ラスターになります。

両方の入力がマルチバンド ラスターの場合、または入力の片方が定数の場合は、出力はマルチバンド ラスターになります。それぞれのマルチバンド入力で、バンドの数は同一の必要があります。

演算子は、1 つの入力に含まれる各バンドについて、他の入力に含まれる対応バンドに対して演算を実行します。入力の 1 つがマルチバンド ラスターで、もう 1 つの入力が定数の場合、演算子はマルチバンド入力に含まれる各バンドについて、定数値との演算を実行します。

構文

in_raster_or_constant1 ^ in_raster_or_constant2
オペランド説明データ タイプ
in_raster_or_constant1

The first input to use in the Boolean XOr operation.

入力値の 1 つがラスターで、もう 1 つがスカラーである場合は、入力ラスターの各セルに実行される評価を持った出力ラスターが作成されます。

Raster Layer | Constant
in_raster_or_constant2

The second input to use in the Boolean XOr operation.

入力値の 1 つがラスターで、もう 1 つがスカラーである場合は、入力ラスターの各セルに実行される評価を持った出力ラスターが作成されます。

Raster Layer | Constant

戻り値

名前説明データ タイプ
out_raster

出力ラスター オブジェクト。

出力値は 0 または 1 です。

Raster

コードのサンプル

^ (Boolean XOr) example 1 (Python window)

This sample performs a Boolean XOr operation on two input rasters.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outBooleanXOr = Raster("degs") ^ Raster("negs")
outBooleanXOr.save("C:/sapyexamples/output/outboolxor.tif")
^ (Boolean XOr) example 2 (stand-alone script)

This sample performs a Boolean XOr operation on two input rasters.

# Name: Op_BooleanOr_Ex_02.py
# Description: Performs a Boolean Or operation on the cell values of
#              two input rasters
# 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 BooleanOr
outBooleanOr = inRaster1 | inRaster2

# Save the output 
outBooleanOr.save("C:/sapyexamples/output/outboolor")

関連トピック