xorbits.numpy.atleast_1d#

xorbits.numpy.atleast_1d(*tensors)[source]#

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 (array_like) – One or more input arrays.

  • arys2 (array_like) – One or more input arrays.

  • ... (array_like) – One or more input arrays.

Returns

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

Return type

ndarray

See also

atleast_2d, atleast_3d

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

This docstring was copied from numpy.