maximum¶
- maximum(x1: array, x2: array, /) array ¶
Computes the maximum value for each element
x1_i
of the input arrayx1
relative to the respective elementx2_i
of the input arrayx2
.- Parameters:
x1 (array) – first input array. Should have a real-valued data type.
x2 (array) – second input array. Must be compatible with
x1
(see Broadcasting). Should have a real-valued data type.
- Returns:
out (array) – an array containing the element-wise maximum values. The returned array must have a data type determined by Type Promotion Rules.
Notes
The order of signed zeros is unspecified and thus implementation-defined. When choosing between
-0
or+0
as a maximum value, specification-compliant libraries may choose to return either value.For backward compatibility, conforming implementations may support complex numbers; however, inequality comparison of complex numbers is unspecified and thus implementation-defined (see Complex Number Ordering).
Special Cases
For floating-point operands,
If either
x1_i
orx2_i
isNaN
, the result isNaN
.
New in version 2023.12.