Multi-Dimensional Array (ndarray)

dpnp.ndarray is the DPNP counterpart of NumPy numpy.ndarray.

For the basic concept of ndarrays, please refer to the NumPy documentation.

dpnp.ndarray	alias of dpnp_array
dpnp.dpnp_array.dpnp_array	Multi-dimensional array object.

Constructing arrays

New arrays can be constructed using the routines detailed in Array Creation Routines, and also by using the low-level dpnp.ndarray constructor:

dpnp.ndarray

alias of dpnp_array

Indexing arrays

Arrays can be indexed using an extended Python slicing syntax, array[selection].

See also

Indexing routines.

Array attributes

Array attributes reflect information that is intrinsic to the array itself. Generally, accessing an array through its attributes allows you to get and sometimes set intrinsic properties of the array without creating a new array. The exposed attributes are the core parts of an array and only some of them can be reset meaningfully without creating a new array. Information on each attribute is given below.

Memory layout

The following attributes contain information about the memory layout of the array:

dpnp.ndarray.flags	Return information about the memory layout of the array.
dpnp.ndarray.shape	Tuple of array dimensions.
dpnp.ndarray.strides	Returns memory displacement in array elements, upon unit change of respective index.
dpnp.ndarray.ndim	Return the number of dimensions of an array.
dpnp.ndarray.size	Number of elements in the array.
dpnp.ndarray.itemsize	Size of one array element in bytes.
dpnp.ndarray.nbytes	Total bytes consumed by the elements of the array.

Data type

See also

Available array data types

The data type object associated with the array can be found in the dtype attribute:

dpnp.ndarray.dtype

Returns NumPy's dtype corresponding to the type of the array elements.

Other attributes

dpnp.ndarray.T	View of the transposed array.
dpnp.ndarray.mT	View of the matrix transposed array.
dpnp.ndarray.real	The real part of the array.
dpnp.ndarray.imag	The imaginary part of the array.
dpnp.ndarray.flat	Return a flat iterator, or set a flattened version of self to value.

Array methods

An dpnp.ndarray object has many methods which operate on or with the array in some fashion, typically returning an array result. These methods are briefly explained below. (Each method's docstring has a more complete description.)

For the following methods there are also corresponding functions in dpnp: all, any, argmax, argmin, argpartition, argsort, choose, clip, compress, copy, cumprod, cumsum, diagonal, imag, max, mean, min, nonzero, partition, prod, put, ravel, real, repeat, reshape, round, searchsorted, sort, squeeze, std, sum, swapaxes, take, trace, transpose, var.

Array conversion

dpnp.ndarray.item	Copy an element of an array to a standard Python scalar and return it.
dpnp.ndarray.astype	Copy the array with data type casting.
dpnp.ndarray.copy	Return a copy of the array.
dpnp.ndarray.fill	Fill the array with a scalar value.

Shape manipulation

For reshape, resize, and transpose, the single tuple argument may be replaced with n integers which will be interpreted as an n-tuple.

dpnp.ndarray.reshape	Returns an array containing the same data with a new shape.
dpnp.ndarray.transpose	Returns a view of the array with axes transposed.
dpnp.ndarray.swapaxes	Interchange two axes of an array.
dpnp.ndarray.flatten	Return a copy of the array collapsed into one dimension.
dpnp.ndarray.ravel	Return a contiguous flattened array.
dpnp.ndarray.squeeze	Remove single-dimensional entries from the shape of an array.

Item selection and manipulation

For array methods that take an axis keyword, it defaults to None. If axis is None, then the array is treated as a 1-D array. Any other value for axis represents the dimension along which the operation should proceed.

dpnp.ndarray.take	Take elements from an array along an axis.
dpnp.ndarray.put	Puts values of an array into another array along a given axis.
dpnp.ndarray.repeat	Repeat elements of an array.
dpnp.ndarray.choose	Construct an array from an index array and a set of arrays to choose from.
dpnp.ndarray.sort	Sort an array in-place.
dpnp.ndarray.argsort	Return an ndarray of indices that sort the array along the specified axis.
dpnp.ndarray.partition	Return a partitioned copy of an array.
dpnp.ndarray.searchsorted	Find indices where elements of v should be inserted in a to maintain order.
dpnp.ndarray.nonzero	Return the indices of the elements that are non-zero.
dpnp.ndarray.diagonal	Return specified diagonals.

Calculation

dpnp.ndarray.max	Return the maximum along an axis.
dpnp.ndarray.argmax	Returns array of indices of the maximum values along the given axis.
dpnp.ndarray.min	Return the minimum along a given axis.
dpnp.ndarray.argmin	Return array of indices to the minimum values along the given axis.
dpnp.ndarray.clip	Clip (limit) the values in an array.
dpnp.ndarray.conj	Complex-conjugate all elements.
dpnp.ndarray.conjugate	Return the complex conjugate, element-wise.
dpnp.ndarray.round	Return array with each element rounded to the given number of decimals.
dpnp.ndarray.trace	Return the sum along diagonals of the array.
dpnp.ndarray.sum	Returns the sum along a given axis.
dpnp.ndarray.cumsum	Return the cumulative sum of the elements along the given axis.
dpnp.ndarray.mean	Returns the average of the array elements.
dpnp.ndarray.var	Returns the variance of the array elements, along given axis.
dpnp.ndarray.std	Returns the standard deviation of the array elements, along given axis.
dpnp.ndarray.prod	Returns the prod along a given axis.
dpnp.ndarray.cumprod	Return the cumulative product of the elements along the given axis.
dpnp.ndarray.all	Returns True if all elements evaluate to True.
dpnp.ndarray.any	Returns True if any of the elements of a evaluate to True.

Arithmetic, matrix multiplication, and comparison operations

Arithmetic and comparison operations on dpnp.ndarrays are defined as element-wise operations, and generally yield dpnp.ndarray objects as results.

Each of the arithmetic operations (+, -, *, /, //, %, divmod(), ** or pow(), <<, >>, &, ^, |, ~) and the comparisons (==, <, >, <=, >=, !=) is equivalent to the corresponding universal function (or ufunc for short) in DPNP. For more information, see the section on Universal Functions.

Comparison operators:

dpnp.ndarray.__lt__	Return self<value.
dpnp.ndarray.__le__	Return self<=value.
dpnp.ndarray.__gt__	Return self>value.
dpnp.ndarray.__ge__	Return self>=value.
dpnp.ndarray.__eq__	Return self==value.
dpnp.ndarray.__ne__	Return self!=value.

Truth value of an array (bool()):

dpnp.ndarray.__bool__()

True if self else False.

Note

Truth-value testing of an array invokes dpnp.ndarray.__bool__(), which raises an error if the number of elements in the array is not 1, because the truth value of such arrays is ambiguous. Use .any() and .all() instead to be clear about what is meant in such cases. (If you wish to check for whether an array is empty, use for example .size > 0.)

Unary operations:

dpnp.ndarray.__neg__	Return -self.
dpnp.ndarray.__pos__	Return +self.
dpnp.ndarray.__abs__	Return \|self\|.
dpnp.ndarray.__invert__	Return ~self.

Arithmetic:

dpnp.ndarray.__add__	Return self+value.
dpnp.ndarray.__sub__	Return self-value.
dpnp.ndarray.__mul__	Return self*value.
dpnp.ndarray.__truediv__	Return self/value.
dpnp.ndarray.__floordiv__	Return self//value.
dpnp.ndarray.__mod__	Return self%value.
dpnp.ndarray.__pow__	Return self**value.
dpnp.ndarray.__lshift__	Return self<<value.
dpnp.ndarray.__rshift__	Return self>>value.
dpnp.ndarray.__and__	Return self&value.
dpnp.ndarray.__or__	Return self|value.
dpnp.ndarray.__xor__	Return self^value.

Arithmetic, reflected:

dpnp.ndarray.__radd__	Return value+self.
dpnp.ndarray.__rsub__	Return value-self.
dpnp.ndarray.__rmul__	Return value*self.
dpnp.ndarray.__rtruediv__	Return value/self.
dpnp.ndarray.__rfloordiv__	Return value//self.
dpnp.ndarray.__rmod__	Return value%self.
dpnp.ndarray.__rpow__	Return value**self.
dpnp.ndarray.__rlshift__	Return value<<self.
dpnp.ndarray.__rrshift__	Return value>>self.
dpnp.ndarray.__rand__	Return value&self.
dpnp.ndarray.__ror__	Return value|self.
dpnp.ndarray.__rxor__	Return value^self.

Arithmetic, in-place:

dpnp.ndarray.__iadd__	Return self+=value.
dpnp.ndarray.__isub__	Return self-=value.
dpnp.ndarray.__imul__	Return self*=value.
dpnp.ndarray.__itruediv__	Return self/=value.
dpnp.ndarray.__ifloordiv__	Return self//=value.
dpnp.ndarray.__imod__	Return self%=value.
dpnp.ndarray.__ipow__	Return self**=value.
dpnp.ndarray.__ilshift__	Return self<<=value.
dpnp.ndarray.__irshift__	Return self>>=value.
dpnp.ndarray.__iand__	Return self&=value.
dpnp.ndarray.__ior__	Return self|=value.
dpnp.ndarray.__ixor__	Return self^=value.

Matrix Multiplication:

dpnp.ndarray.__matmul__(other)	Return self@value.
dpnp.ndarray.__rmatmul__(other)	Return value@self.
dpnp.ndarray.__imatmul__(other)	Return self@=value.

Special methods

For standard library functions:

dpnp.ndarray.__copy__

Used if copy.copy() is called on an array.

Basic customization:

dpnp.ndarray.__new__

Container customization: (see Indexing)

dpnp.ndarray.__len__	Return len(self).
dpnp.ndarray.__getitem__	Return self[key].
dpnp.ndarray.__setitem__	Set self[key] to value.

Conversion; the operations int(), float() and complex(). They work only on arrays that have one element in them and return the appropriate scalar.

dpnp.ndarray.__int__
dpnp.ndarray.__float__
dpnp.ndarray.__complex__

String representations:

dpnp.ndarray.__str__	Return str(self).
dpnp.ndarray.__repr__	Return repr(self).