numpy.ma.atleast_1d — NumPy v1.13 Manual (original) (raw)

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])]