nums.numpy.empty

nums.numpy.empty(shape, dtype=<class 'float'>)

Return a new array of given shape and type, without initializing entries.

This docstring was copied from numpy.empty.

Some inconsistencies with the NumS version may exist.

Parameters

• shape (int or tuple of int) – Shape of the empty array, e.g., (2, 3) or 2.

• dtype (data-type, optional) – Desired output data-type for the array, e.g, int. Default is float.

Returns

out – Array of uninitialized (arbitrary) data of the given shape and dtype.

Return type

BlockArray

See also

empty_like

Return an empty array with shape and type of input.

ones

Return a new array setting values to one.

zeros

Return a new array setting values to zero.

full

Return a new array of given shape filled with value.

Notes

empty, unlike zeros, does not set the array values to zero, and may therefore be marginally faster. On the other hand, it requires the user to manually set all the values in the array, and should be used with caution.

Examples

The doctests shown below are copied from NumPy. They won’t show the correct result until you operate get().

>>> nps.empty([2, 2]).get()  
array([[ -9.74499359e+001,   6.69583040e-309],
       [  2.13182611e-314,   3.06959433e-309]])         #uninitialized

>>> nps.empty([2, 2], dtype=int).get()  
array([[-1073741821, -1067949133],
       [  496041986,    19249760]])                     #uninitialized