Graph Mode Syntax - Operators

Arithmetic operators and assignment operators support the Number and Tensor operations, as well as the Tensor operations of different dtype.

Unary Arithmetic Operators

Unary Arithmetic Operator	Supported Type
+	Number, Tensor, taking positive values.
-	Number, Tensor, COOTensor, CSRTensor, taking negative values.
~	Tensor with bool data type, members take negation one by one.

Notes:

• In native python, the ~ operator get the bitwise inversion of its integer argument; in MindSpore, the ~ redefined to get logic not for Tensor(Bool).

Binary Arithmetic Operators

Binary Arithmetic Operator	Supported Type
+	Number + Number, String + String, Number + Tensor, Tensor + Number, Tuple + Tensor, Tensor + Tuple, List + Tensor, Tensor+List, List+List, Tensor + Tensor, Tuple + Tuple, COOTensor + Tensor, Tensor + COOTensor, COOTensor + COOTensor, CSRTensor + CSRTensor.
-	Number - Number, Tensor - Tensor, Number -Tensor, Tensor - Number, Tuple -Tensor, Tensor -Tuple, List -Tensor, Tensor -List, COOTensor - Tensor, Tensor - COOTensor, COOTensor - COOTensor, CSRTensor - CSRTensor.
*	Number * Number, Tensor * Tensor, Number * Tensor, Tensor * Number, List * Number, Number * List, Tuple * Number, Number * Tuple, Tuple * Tensor, Tensor * Tuple, List *Tensor, Tensor * List, COOTensor * Tensor, Tensor * COOTensor, CSRTensor * Tensor, Tensor * CSRTensor.
/	Number / Number, Tensor / Tensor, Number / Tensor, Tensor / Number, Tuple / Tensor, Tensor / Tuple, List / Tensor, Tensor / List, COOTensor / Tensor, CSRTensor / Tensor.
%	Number % Number, Tensor % Tensor, Number % Tensor, Tensor % Number, Tuple % Tensor, Tensor % Tuple, List % Tensor, Tensor % List.
**	Number ** Number, Tensor ** Tensor, Number ** Tensor, Tensor ** Number, Tuple ** Tensor, Tensor ** Tuple, List ** Tensor, Tensor ** List.
//	Number // Number, Tensor // Tensor, Number // Tensor, Tensor // Number, Tuple // Tensor, Tensor // Tuple, List // Tensor, Tensor // List.
&	Number & Number, Tensor & Tensor, Number & Tensor, Tensor & Number.
∣	Number | Number, Tensor | Tensor, Number | Tensor, Tensor | Number.
^	Number ^ Number, Tensor ^ Tensor, Number ^ Tensor, Tensor ^ Number.
<<	Number << Number.
>>	Number >> Number.
@	Tensor @ Tensor.

Restrictions:

• If all operands are number type, operations between float64 and int32 are not supported. Operators including +, -, *, /, %, **, // all support left and right operands to be bool value.

• If either operand is tensor type, left and right operands can't both be bool value.

• The * operation on list/tuple and number means that list/tuple is copied from number and then concatenated. The data type inside list can be any data type supported by the graph mode, and multi-layer nesting is also supported. The data type in tuple must be number, string, none, and multi-layer nesting is also supported.

Assignment Operators

Assignment Operator	Supported Type,
=	All Built-in Python Types that MindSpore supported and MindSpore User-defined Data Types.
+=	Number += Number, String += String, Number += Tensor, Tensor += Number, Tuple += Tensor, Tensor += Tuple, List += Tensor, Tensor += List, List += List, Tensor += Tensor, Tuple += Tuple.
-=	Number -= Number, Tensor -= Tensor, Number -= Tensor, Tensor -= Number, Tuple -= Tensor, Tensor -= Tuple, List -= Tensor, Tensor -= List.
*=	Number *= Number, Tensor *= Tensor, Number *= Tensor, Tensor *= Number, List *= Number, Number *= List, Tuple *= Number, Number *= Tuple, Tuple *= Tensor, Tensor *= Tuple, List *= Tensor, Tensor *= List.
/=	Number /= Number, Tensor /= Tensor, Number /= Tensor, Tensor /= Number, Tuple /= Tensor, Tensor /= Tuple, List /= Tensor, Tensor /= List.
%=	Number %= Number, Tensor %= Tensor, Number %= Tensor, Tensor %= Number, Tuple %= Tensor, Tensor %= Tuple, List %= Tensor, Tensor %= List.
**=	Number **= Number, Tensor **= Tensor, Number **= Tensor, Tensor **= Number, Tuple **= Tensor, Tensor **= Tuple, List **= Tensor, Tensor **= List.
//=	Number //= Number, Tensor //= Tensor, Number //= Tensor, Tensor //= Number, Tuple //= Tensor, Tensor //= Tuple, List //= Tensor, Tensor //= List.
&=	Number &= Number, Tensor &= Tensor, Number &= Tensor, Tensor &= Number.
∣=	Number |= Number, Tensor |= Tensor, Number |= Tensor, Tensor |= Number.
^=	Number ^= Number, Tensor ^= Tensor, Number ^= Tensor, Tensor ^= Number.
<<=	Number <<= Number.
>>=	Number >>= Number.
@=	Tensor @= Tensor.

Constraints:

• If all operands of AugAssign are number type, value of Number can't be bool.

• If all operands of AugAssign are number type, operations between float64 and int32 are not supported.

• If either operand of AugAssign is tensor type, left and right operands can't both be bool value.

• The *= operation on list/tuple and number means that list/tuple is copied from number and then concatenated, and the elements of the object within list/tuple can contain any of the types supported by the intentional pattern, and multiple levels of nesting are also supported.

Logical Operators

Logical Operator	Supported Type
and	String, Number, Tuple, List , Dict, None, Scalar, Tensor.
or	String, Number, Tuple, List , Dict, None, Scalar, Tensor.
not	Number, tuple, List and Tensor with only one element.

Restrictions:

• The left operand of operator and or or must be able to be converted to boolean value. For example, left operand can not be Tensor with multiple elements. If the left operand of and or or is variable Tensor, the right operand must also be single-element Tensor with the same type. Otherwise, there is no requirement for right operand.

Compare Operators

Compare Operator	Supported Type
in	Number in Tuple, String in Tuple, Tensor in Tuple, Number in List, String in List, Tensor in List, and String in Dictionary.
not in	Same as in.
is	The value can only be None, True, or False.
is not	The value can only be None, True, or False.
<	Number < Number, Number < Tensor, Tensor < Tensor, Tensor < Number.
<=	Number <= Number, Number <= Tensor, Tensor <= Tensor, Tensor <= Number.
>	Number > Number, Number > Tensor, Tensor > Tensor, Tensor > Number.
>=	Number >= Number, Number >= Tensor, Tensor >= Tensor, Tensor >= Number.
!=	Number != Number , Number != Tensor, Tensor != Tensor, Tensor != Number, mstype != mstype, String != String, Tuple ! = Tuple, List != List.
==	Number == Number, Number == Tensor, Tensor == Tensor, Tensor == Number, mstype == mstype, String == String, Tuple == Tuple, List == List.

Restrictions:

• For operators <, <=, >, >=, !=, if all operators are of number type, value of Number can't be bool.

• For operators <, <=, >, >=, !=, ==, if all operands are of number type, operations between float64 and int32 are not supported.

• For operators <, <=, >, >=, !=, ==, if either operand is of tensor type, left and right operands can't both be bool value.

• For operator ==, if all operands are of number type, support both number have bool value, not support only one number has bool value.

• For operators !=, ==, all supported types but mstype can compare with none.