A universal function (or ufunc for short) is a function that operates on ndarrays
in an elementbyelement fashion, supporting array broadcasting, type casting, and several other standard features. That is, a ufunc is a “vectorized” wrapper for a function that takes a fixed number of specific inputs and produces a fixed number of specific outputs.
In NumPy, universal functions are instances of the numpy.ufunc
class. Many of the builtin functions are implemented in compiled C code. The basic ufuncs operate on scalars, but there is also a generalized kind for which the basic elements are subarrays (vectors, matrices, etc.), and broadcasting is done over other dimensions. One can also produce custom ufunc
instances using the frompyfunc
factory function.
Each universal function takes array inputs and produces array outputs by performing the core function elementwise on the inputs (where an element is generally a scalar, but can be a vector or higherorder subarray for generalized ufuncs). Standard broadcasting rules are applied so that inputs not sharing exactly the same shapes can still be usefully operated on. Broadcasting can be understood by four rules:
ndim
smaller than the input array of largest ndim
, have 1’s prepended to their shapes.Broadcasting is used throughout NumPy to decide how to handle disparately shaped arrays; for example, all arithmetic operations (+
, 
, *
, …) between ndarrays
broadcast the arrays before operation.
A set of arrays is called “broadcastable” to the same shape if the above rules produce a valid result, i.e., one of the following is true:
If a.shape
is (5,1), b.shape
is (1,6), c.shape
is (6,) and d.shape
is () so that d is a scalar, then a, b, c, and d are all broadcastable to dimension (5,6); and
a[:,0]
is broadcast to the other columns,b[0,:]
is broadcast to the other rows,c[:]
is broadcast to every row, and finally,The output of the ufunc (and its methods) is not necessarily an ndarray
, if all input arguments are not ndarrays
. Indeed, if any input defines an __array_ufunc__
method, control will be passed completely to that function, i.e., the ufunc is overridden.
If none of the inputs overrides the ufunc, then all output arrays will be passed to the __array_prepare__
and __array_wrap__
methods of the input (besides ndarrays
, and scalars) that defines it and has the highest __array_priority__
of any other input to the universal function. The default __array_priority__
of the ndarray is 0.0, and the default __array_priority__
of a subtype is 0.0. Matrices have __array_priority__
equal to 10.0.
All ufuncs can also take output arguments. If necessary, output will be cast to the datatype(s) of the provided output array(s). If a class with an __array__
method is used for the output, results will be written to the object returned by __array__
. Then, if the class also has an __array_prepare__
method, it is called so metadata may be determined based on the context of the ufunc (the context consisting of the ufunc itself, the arguments passed to the ufunc, and the ufunc domain.) The array object returned by __array_prepare__
is passed to the ufunc for computation. Finally, if the class also has an __array_wrap__
method, the returned ndarray
result will be passed to that method just before passing control back to the caller.
Internally, buffers are used for misaligned data, swapped data, and data that has to be converted from one data type to another. The size of internal buffers is settable on a perthread basis. There can be up to buffers of the specified size created to handle the data from all the inputs and outputs of a ufunc. The default size of a buffer is 10,000 elements. Whenever bufferbased calculation would be needed, but all input arrays are smaller than the buffer size, those misbehaved or incorrectlytyped arrays will be copied before the calculation proceeds. Adjusting the size of the buffer may therefore alter the speed at which ufunc calculations of various sorts are completed. A simple interface for setting this variable is accessible using the function
setbufsize (size)  Set the size of the buffer used in ufuncs. 
Universal functions can trip special floatingpoint status registers in your hardware (such as dividebyzero). If available on your platform, these registers will be regularly checked during calculation. Error handling is controlled on a perthread basis, and can be configured using the functions
seterr ([all, divide, over, under, invalid])  Set how floatingpoint errors are handled. 
seterrcall (func)  Set the floatingpoint error callback function or log object. 
Note
In NumPy 1.6.0, a type promotion API was created to encapsulate the mechanism for determining output types. See the functions result_type
, promote_types
, and min_scalar_type
for more details.
At the core of every ufunc is a onedimensional strided loop that implements the actual function for a specific type combination. When a ufunc is created, it is given a static list of inner loops and a corresponding list of type signatures over which the ufunc operates. The ufunc machinery uses this list to determine which inner loop to use for a particular case. You can inspect the .types
attribute for a particular ufunc to see which type combinations have a defined inner loop and which output type they produce (character codes are used in said output for brevity).
Casting must be done on one or more of the inputs whenever the ufunc does not have a core loop implementation for the input types provided. If an implementation for the input types cannot be found, then the algorithm searches for an implementation with a type signature to which all of the inputs can be cast “safely.” The first one it finds in its internal list of loops is selected and performed, after all necessary type casting. Recall that internal copies during ufuncs (even for casting) are limited to the size of an internal buffer (which is user settable).
Note
Universal functions in NumPy are flexible enough to have mixed type signatures. Thus, for example, a universal function could be defined that works with floatingpoint and integer values. See ldexp
for an example.
By the above description, the casting rules are essentially implemented by the question of when a data type can be cast “safely” to another data type. The answer to this question can be determined in Python with a function call: can_cast(fromtype, totype)
. The Figure below shows the results of this call for the 24 internally supported types on the author’s 64bit system. You can generate this table for your system with the code given in the Figure.
Figure
Code segment showing the “can cast safely” table for a 32bit system.
>>> def print_table(ntypes): ... print 'X', ... for char in ntypes: print char, ... print ... for row in ntypes: ... print row, ... for col in ntypes: ... print int(np.can_cast(row, col)), ... print >>> print_table(np.typecodes['All']) X ? b h i l q p B H I L Q P e f d g F D G S U V O M m ? 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 b 0 1 1 1 1 1 1 0 0 0 0 0 0 1 1 1 1 1 1 1 1 1 1 1 0 0 h 0 0 1 1 1 1 1 0 0 0 0 0 0 0 1 1 1 1 1 1 1 1 1 1 0 0 i 0 0 0 1 1 1 1 0 0 0 0 0 0 0 0 1 1 0 1 1 1 1 1 1 0 0 l 0 0 0 0 1 1 1 0 0 0 0 0 0 0 0 1 1 0 1 1 1 1 1 1 0 0 q 0 0 0 0 1 1 1 0 0 0 0 0 0 0 0 1 1 0 1 1 1 1 1 1 0 0 p 0 0 0 0 1 1 1 0 0 0 0 0 0 0 0 1 1 0 1 1 1 1 1 1 0 0 B 0 0 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 0 0 H 0 0 0 1 1 1 1 0 1 1 1 1 1 0 1 1 1 1 1 1 1 1 1 1 0 0 I 0 0 0 0 1 1 1 0 0 1 1 1 1 0 0 1 1 0 1 1 1 1 1 1 0 0 L 0 0 0 0 0 0 0 0 0 0 1 1 1 0 0 1 1 0 1 1 1 1 1 1 0 0 Q 0 0 0 0 0 0 0 0 0 0 1 1 1 0 0 1 1 0 1 1 1 1 1 1 0 0 P 0 0 0 0 0 0 0 0 0 0 1 1 1 0 0 1 1 0 1 1 1 1 1 1 0 0 e 0 0 0 0 0 0 0 0 0 0 0 0 0 1 1 1 1 1 1 1 1 1 1 1 0 0 f 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 1 1 1 1 1 1 1 1 1 0 0 d 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 1 0 1 1 1 1 1 1 0 0 g 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 0 0 1 1 1 1 1 0 0 F 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 1 1 1 1 1 1 0 0 D 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 1 1 1 1 1 0 0 G 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 1 1 1 1 0 0 S 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 1 1 1 0 0 U 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 1 1 0 0 V 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 1 0 0 O 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 1 0 0 M 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 0 m 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1
You should note that, while included in the table for completeness, the ‘S’, ‘U’, and ‘V’ types cannot be operated on by ufuncs. Also, note that on a 32bit system the integer types may have different sizes, resulting in a slightly altered table.
Mixed scalararray operations use a different set of casting rules that ensure that a scalar cannot “upcast” an array unless the scalar is of a fundamentally different kind of data (i.e., under a different hierarchy in the datatype hierarchy) than the array. This rule enables you to use scalar constants in your code (which, as Python types, are interpreted accordingly in ufuncs) without worrying about whether the precision of the scalar constant will cause upcasting on your large (small precision) array.
Classes (including ndarray subclasses) can override how ufuncs act on them by defining certain special methods. For details, see Standard array subclasses.
ufunc
All ufuncs take optional keyword arguments. Most of these represent advanced usage and will not typically be used.
out
New in version 1.6.
The first output can be provided as either a positional or a keyword parameter. Keyword ‘out’ arguments are incompatible with positional ones.
New in version 1.10.
The ‘out’ keyword argument is expected to be a tuple with one entry per output (which can be None
for arrays to be allocated by the ufunc). For ufuncs with a single output, passing a single array (instead of a tuple holding a single array) is also valid.
Passing a single array in the ‘out’ keyword argument to a ufunc with multiple outputs is deprecated, and will raise a warning in numpy 1.10, and an error in a future release.
If ‘out’ is None (the default), a uninitialized return array is created. The output array is then filled with the results of the ufunc in the places that the broadcast ‘where’ is True. If ‘where’ is the scalar True (the default), then this corresponds to the entire output being filled. Note that outputs not explicitly filled are left with their uninitialized values.
where
New in version 1.7.
Accepts a boolean array which is broadcast together with the operands. Values of True indicate to calculate the ufunc at that position, values of False indicate to leave the value in the output alone. This argument cannot be used for generalized ufuncs as those take nonscalar input.
Note that if an uninitialized return array is created, values of False will leave those values uninitialized.
axes
New in version 1.15.
A list of tuples with indices of axes a generalized ufunc should operate on. For instance, for a signature of (i,j),(j,k)>(i,k)
appropriate for matrix multiplication, the base elements are twodimensional matrices and these are taken to be stored in the two last axes of each argument. The corresponding axes keyword would be [(2, 1), (2, 1), (2, 1)]
. For simplicity, for generalized ufuncs that operate on 1dimensional arrays (vectors), a single integer is accepted instead of a singleelement tuple, and for generalized ufuncs for which all outputs are scalars, the output tuples can be omitted.
axis
New in version 1.15.
A single axis over which a generalized ufunc should operate. This is a shortcut for ufuncs that operate over a single, shared core dimension, equivalent to passing in axes
with entries of (axis,)
for each singlecoredimension argument and ()
for all others. For instance, for a signature (i),(i)>()
, it is equivalent to passing in axes=[(axis,), (axis,), ()]
.
keepdims
New in version 1.15.
If this is set to True
, axes which are reduced over will be left in the result as a dimension with size one, so that the result will broadcast correctly against the inputs. This option can only be used for generalized ufuncs that operate on inputs that all have the same number of core dimensions and with outputs that have no core dimensions , i.e., with signatures like (i),(i)>()
or (m,m)>()
. If used, the location of the dimensions in the output can be controlled with axes
and axis
.
casting
New in version 1.6.
May be ‘no’, ‘equiv’, ‘safe’, ‘same_kind’, or ‘unsafe’. See can_cast
for explanations of the parameter values.
Provides a policy for what kind of casting is permitted. For compatibility with previous versions of NumPy, this defaults to ‘unsafe’ for numpy < 1.7. In numpy 1.7 a transition to ‘same_kind’ was begun where ufuncs produce a DeprecationWarning for calls which are allowed under the ‘unsafe’ rules, but not under the ‘same_kind’ rules. From numpy 1.10 and onwards, the default is ‘same_kind’.
order
New in version 1.6.
Specifies the calculation iteration order/memory layout of the output array. Defaults to ‘K’. ‘C’ means the output should be Ccontiguous, ‘F’ means Fcontiguous, ‘A’ means Fcontiguous if the inputs are Fcontiguous and not also not Ccontiguous, Ccontiguous otherwise, and ‘K’ means to match the element ordering of the inputs as closely as possible.
dtype
New in version 1.6.
Overrides the dtype of the calculation and output arrays. Similar to signature.
subok
New in version 1.6.
Defaults to true. If set to false, the output will always be a strict array, not a subtype.
signature
Either a datatype, a tuple of datatypes, or a special signature string indicating the input and output types of a ufunc. This argument allows you to provide a specific signature for the 1d loop to use in the underlying calculation. If the loop specified does not exist for the ufunc, then a TypeError is raised. Normally, a suitable loop is found automatically by comparing the input types with what is available and searching for a loop with datatypes to which all inputs can be cast safely. This keyword argument lets you bypass that search and choose a particular loop. A list of available signatures is provided by the types attribute of the ufunc object. For backwards compatibility this argument can also be provided as sig, although the long form is preferred. Note that this should not be confused with the generalized ufunc signature that is stored in the signature attribute of the of the ufunc object.extobj
a list of length 1, 2, or 3 specifying the ufunc buffersize, the error mode integer, and the error callback function. Normally, these values are looked up in a threadspecific dictionary. Passing them here circumvents that look up and uses the lowlevel specification provided for the error mode. This may be useful, for example, as an optimization for calculations requiring many ufunc calls on small arrays in a loop.There are some informational attributes that universal functions possess. None of the attributes can be set.
__doc__  A docstring for each ufunc. The first part of the docstring is dynamically generated from the number of outputs, the name, and the number of inputs. The second part of the docstring is provided at creation time and stored with the ufunc. 
__name__  The name of the ufunc. 
ufunc.nin  The number of inputs. 
ufunc.nout  The number of outputs. 
ufunc.nargs  The number of arguments. 
ufunc.ntypes  The number of types. 
ufunc.types  Returns a list with types grouped input>output. 
ufunc.identity  The identity value. 
ufunc.signature  Definition of the core elements a generalized ufunc operates on. 
All ufuncs have four methods. However, these methods only make sense on scalar ufuncs that take two input arguments and return one output argument. Attempting to call these methods on other ufuncs will cause a ValueError
. The reducelike methods all take an axis keyword, a dtype keyword, and an out keyword, and the arrays must all have dimension >= 1. The axis keyword specifies the axis of the array over which the reduction will take place (with negative values counting backwards). Generally, it is an integer, though for ufunc.reduce
, it can also be a tuple of int
to reduce over several axes at once, or None
, to reduce over all axes. The dtype keyword allows you to manage a very common problem that arises when naively using ufunc.reduce
. Sometimes you may have an array of a certain data type and wish to add up all of its elements, but the result does not fit into the data type of the array. This commonly happens if you have an array of singlebyte integers. The dtype keyword allows you to alter the data type over which the reduction takes place (and therefore the type of the output). Thus, you can ensure that the output is a data type with precision large enough to handle your output. The responsibility of altering the reduce type is mostly up to you. There is one exception: if no dtype is given for a reduction on the “add” or “multiply” operations, then if the input type is an integer (or Boolean) datatype and smaller than the size of the int_
data type, it will be internally upcast to the int_
(or uint
) datatype. Finally, the out keyword allows you to provide an output array (for singleoutput ufuncs, which are currently the only ones supported; for future extension, however, a tuple with a single argument can be passed in). If out is given, the dtype argument is ignored.
Ufuncs also have a fifth method that allows in place operations to be performed using fancy indexing. No buffering is used on the dimensions where fancy indexing is used, so the fancy index can list an item more than once and the operation will be performed on the result of the previous operation for that item.
ufunc.reduce (a[, axis, dtype, out, …])  Reduces a ’s dimension by one, by applying ufunc along one axis. 
ufunc.accumulate (array[, axis, dtype, out])  Accumulate the result of applying the operator to all elements. 
ufunc.reduceat (a, indices[, axis, dtype, out])  Performs a (local) reduce with specified slices over a single axis. 
ufunc.outer (A, B, **kwargs)  Apply the ufunc op to all pairs (a, b) with a in A and b in B . 
ufunc.at (a, indices[, b])  Performs unbuffered in place operation on operand ‘a’ for elements specified by ‘indices’. 
Warning
A reducelike operation on an array with a datatype that has a range “too small” to handle the result will silently wrap. One should use dtype
to increase the size of the datatype over which reduction takes place.
There are currently more than 60 universal functions defined in numpy
on one or more types, covering a wide variety of operations. Some of these ufuncs are called automatically on arrays when the relevant infix notation is used (e.g., add(a, b)
is called internally when a + b
is written and a or b is an ndarray
). Nevertheless, you may still want to use the ufunc call in order to use the optional output argument(s) to place the output(s) in an object (or objects) of your choice.
Recall that each ufunc operates elementbyelement. Therefore, each scalar ufunc will be described as if acting on a set of scalar inputs to return a set of scalar outputs.
Note
The ufunc still returns its output(s) even if you use the optional output argument(s).
add (x1, x2, /[, out, where, casting, order, …])  Add arguments elementwise. 
subtract (x1, x2, /[, out, where, casting, …])  Subtract arguments, elementwise. 
multiply (x1, x2, /[, out, where, casting, …])  Multiply arguments elementwise. 
divide (x1, x2, /[, out, where, casting, …])  Returns a true division of the inputs, elementwise. 
logaddexp (x1, x2, /[, out, where, casting, …])  Logarithm of the sum of exponentiations of the inputs. 
logaddexp2 (x1, x2, /[, out, where, casting, …])  Logarithm of the sum of exponentiations of the inputs in base2. 
true_divide (x1, x2, /[, out, where, …])  Returns a true division of the inputs, elementwise. 
floor_divide (x1, x2, /[, out, where, …])  Return the largest integer smaller or equal to the division of the inputs. 
negative (x, /[, out, where, casting, order, …])  Numerical negative, elementwise. 
positive (x, /[, out, where, casting, order, …])  Numerical positive, elementwise. 
power (x1, x2, /[, out, where, casting, …])  First array elements raised to powers from second array, elementwise. 
remainder (x1, x2, /[, out, where, casting, …])  Return elementwise remainder of division. 
mod (x1, x2, /[, out, where, casting, order, …])  Return elementwise remainder of division. 
fmod (x1, x2, /[, out, where, casting, …])  Return the elementwise remainder of division. 
divmod (x1, x2[, out1, out2], / [[, out, …])  Return elementwise quotient and remainder simultaneously. 
absolute (x, /[, out, where, casting, order, …])  Calculate the absolute value elementwise. 
fabs (x, /[, out, where, casting, order, …])  Compute the absolute values elementwise. 
rint (x, /[, out, where, casting, order, …])  Round elements of the array to the nearest integer. 
sign (x, /[, out, where, casting, order, …])  Returns an elementwise indication of the sign of a number. 
heaviside (x1, x2, /[, out, where, casting, …])  Compute the Heaviside step function. 
conj (x, /[, out, where, casting, order, …])  Return the complex conjugate, elementwise. 
conjugate (x, /[, out, where, casting, …])  Return the complex conjugate, elementwise. 
exp (x, /[, out, where, casting, order, …])  Calculate the exponential of all elements in the input array. 
exp2 (x, /[, out, where, casting, order, …])  Calculate 2**p for all p in the input array. 
log (x, /[, out, where, casting, order, …])  Natural logarithm, elementwise. 
log2 (x, /[, out, where, casting, order, …])  Base2 logarithm of x . 
log10 (x, /[, out, where, casting, order, …])  Return the base 10 logarithm of the input array, elementwise. 
expm1 (x, /[, out, where, casting, order, …])  Calculate exp(x)  1 for all elements in the array. 
log1p (x, /[, out, where, casting, order, …])  Return the natural logarithm of one plus the input array, elementwise. 
sqrt (x, /[, out, where, casting, order, …])  Return the nonnegative squareroot of an array, elementwise. 
square (x, /[, out, where, casting, order, …])  Return the elementwise square of the input. 
cbrt (x, /[, out, where, casting, order, …])  Return the cuberoot of an array, elementwise. 
reciprocal (x, /[, out, where, casting, …])  Return the reciprocal of the argument, elementwise. 
gcd (x1, x2, /[, out, where, casting, order, …])  Returns the greatest common divisor of x1 and x2

lcm (x1, x2, /[, out, where, casting, order, …])  Returns the lowest common multiple of x1 and x2

Tip
The optional output arguments can be used to help you save memory for large calculations. If your arrays are large, complicated expressions can take longer than absolutely necessary due to the creation and (later) destruction of temporary calculation spaces. For example, the expression G = a * b + c
is equivalent to t1 = A * B; G = T1 + C; del t1
. It will be more quickly executed as G = A * B; add(G, C, G)
which is the same as G = A * B; G += C
.
All trigonometric functions use radians when an angle is called for. The ratio of degrees to radians is
sin (x, /[, out, where, casting, order, …])  Trigonometric sine, elementwise. 
cos (x, /[, out, where, casting, order, …])  Cosine elementwise. 
tan (x, /[, out, where, casting, order, …])  Compute tangent elementwise. 
arcsin (x, /[, out, where, casting, order, …])  Inverse sine, elementwise. 
arccos (x, /[, out, where, casting, order, …])  Trigonometric inverse cosine, elementwise. 
arctan (x, /[, out, where, casting, order, …])  Trigonometric inverse tangent, elementwise. 
arctan2 (x1, x2, /[, out, where, casting, …])  Elementwise arc tangent of x1/x2 choosing the quadrant correctly. 
hypot (x1, x2, /[, out, where, casting, …])  Given the “legs” of a right triangle, return its hypotenuse. 
sinh (x, /[, out, where, casting, order, …])  Hyperbolic sine, elementwise. 
cosh (x, /[, out, where, casting, order, …])  Hyperbolic cosine, elementwise. 
tanh (x, /[, out, where, casting, order, …])  Compute hyperbolic tangent elementwise. 
arcsinh (x, /[, out, where, casting, order, …])  Inverse hyperbolic sine elementwise. 
arccosh (x, /[, out, where, casting, order, …])  Inverse hyperbolic cosine, elementwise. 
arctanh (x, /[, out, where, casting, order, …])  Inverse hyperbolic tangent elementwise. 
deg2rad (x, /[, out, where, casting, order, …])  Convert angles from degrees to radians. 
rad2deg (x, /[, out, where, casting, order, …])  Convert angles from radians to degrees. 
These function all require integer arguments and they manipulate the bitpattern of those arguments.
bitwise_and (x1, x2, /[, out, where, …])  Compute the bitwise AND of two arrays elementwise. 
bitwise_or (x1, x2, /[, out, where, casting, …])  Compute the bitwise OR of two arrays elementwise. 
bitwise_xor (x1, x2, /[, out, where, …])  Compute the bitwise XOR of two arrays elementwise. 
invert (x, /[, out, where, casting, order, …])  Compute bitwise inversion, or bitwise NOT, elementwise. 
left_shift (x1, x2, /[, out, where, casting, …])  Shift the bits of an integer to the left. 
right_shift (x1, x2, /[, out, where, …])  Shift the bits of an integer to the right. 
greater (x1, x2, /[, out, where, casting, …])  Return the truth value of (x1 > x2) elementwise. 
greater_equal (x1, x2, /[, out, where, …])  Return the truth value of (x1 >= x2) elementwise. 
less (x1, x2, /[, out, where, casting, …])  Return the truth value of (x1 < x2) elementwise. 
less_equal (x1, x2, /[, out, where, casting, …])  Return the truth value of (x1 =< x2) elementwise. 
not_equal (x1, x2, /[, out, where, casting, …])  Return (x1 != x2) elementwise. 
equal (x1, x2, /[, out, where, casting, …])  Return (x1 == x2) elementwise. 
Warning
Do not use the Python keywords and
and or
to combine logical array expressions. These keywords will test the truth value of the entire array (not elementbyelement as you might expect). Use the bitwise operators & and  instead.
logical_and (x1, x2, /[, out, where, …])  Compute the truth value of x1 AND x2 elementwise. 
logical_or (x1, x2, /[, out, where, casting, …])  Compute the truth value of x1 OR x2 elementwise. 
logical_xor (x1, x2, /[, out, where, …])  Compute the truth value of x1 XOR x2, elementwise. 
logical_not (x, /[, out, where, casting, …])  Compute the truth value of NOT x elementwise. 
Warning
The bitwise operators & and  are the proper way to perform elementbyelement array comparisons. Be sure you understand the operator precedence: (a > 2) & (a < 5)
is the proper syntax because a > 2 & a < 5
will result in an error due to the fact that 2 & a
is evaluated first.
maximum (x1, x2, /[, out, where, casting, …])  Elementwise maximum of array elements. 
Tip
The Python function max()
will find the maximum over a onedimensional array, but it will do so using a slower sequence interface. The reduce method of the maximum ufunc is much faster. Also, the max()
method will not give answers you might expect for arrays with greater than one dimension. The reduce method of minimum also allows you to compute a total minimum over an array.
minimum (x1, x2, /[, out, where, casting, …])  Elementwise minimum of array elements. 
Warning
the behavior of maximum(a, b)
is different than that of max(a, b)
. As a ufunc, maximum(a, b)
performs an elementbyelement comparison of a
and b
and chooses each element of the result according to which element in the two arrays is larger. In contrast, max(a, b)
treats the objects a
and b
as a whole, looks at the (total) truth value of a > b
and uses it to return either a
or b
(as a whole). A similar difference exists between minimum(a, b)
and min(a, b)
.
fmax (x1, x2, /[, out, where, casting, …])  Elementwise maximum of array elements. 
fmin (x1, x2, /[, out, where, casting, …])  Elementwise minimum of array elements. 
Recall that all of these functions work elementbyelement over an array, returning an array output. The description details only a single operation.
isfinite (x, /[, out, where, casting, order, …])  Test elementwise for finiteness (not infinity or not Not a Number). 
isinf (x, /[, out, where, casting, order, …])  Test elementwise for positive or negative infinity. 
isnan (x, /[, out, where, casting, order, …])  Test elementwise for NaN and return result as a boolean array. 
isnat (x, /[, out, where, casting, order, …])  Test elementwise for NaT (not a time) and return result as a boolean array. 
fabs (x, /[, out, where, casting, order, …])  Compute the absolute values elementwise. 
signbit (x, /[, out, where, casting, order, …])  Returns elementwise True where signbit is set (less than zero). 
copysign (x1, x2, /[, out, where, casting, …])  Change the sign of x1 to that of x2, elementwise. 
nextafter (x1, x2, /[, out, where, casting, …])  Return the next floatingpoint value after x1 towards x2, elementwise. 
spacing (x, /[, out, where, casting, order, …])  Return the distance between x and the nearest adjacent number. 
modf (x[, out1, out2], / [[, out, where, …])  Return the fractional and integral parts of an array, elementwise. 
ldexp (x1, x2, /[, out, where, casting, …])  Returns x1 * 2**x2, elementwise. 
frexp (x[, out1, out2], / [[, out, where, …])  Decompose the elements of x into mantissa and twos exponent. 
fmod (x1, x2, /[, out, where, casting, …])  Return the elementwise remainder of division. 
floor (x, /[, out, where, casting, order, …])  Return the floor of the input, elementwise. 
ceil (x, /[, out, where, casting, order, …])  Return the ceiling of the input, elementwise. 
trunc (x, /[, out, where, casting, order, …])  Return the truncated value of the input, elementwise. 
© 2005–2019 NumPy Developers
Licensed under the 3clause BSD License.
https://docs.scipy.org/doc/numpy1.17.0/reference/ufuncs.html