numpy.ma.atleast_1d

numpy.ma.atleast_1d(*arys) = <numpy.ma.extras._fromnxfunction_allargs instance>

Convert inputs to arrays with at least one dimension.

Scalar inputs are converted to 1-dimensional arrays, whilst higher-dimensional inputs are preserved.

Parameters:

arys1, arys2, ... : array_like

One or more input arrays.

Returns:

ret : ndarray

An array, or list of arrays, each with a.ndim >= 1. Copies are made only if necessary.

Notes

The function is applied to both the _data and the _mask, if any.

Examples

>>> np.atleast_1d(1.0)
array([ 1.])

>>> x = np.arange(9.0).reshape(3,3)
>>> np.atleast_1d(x)
array([[ 0.,  1.,  2.],
       [ 3.,  4.,  5.],
       [ 6.,  7.,  8.]])
>>> np.atleast_1d(x) is x
True

>>> np.atleast_1d(1, [3, 4])
[array([1]), array([3, 4])]