#### Previous topic

numpy.ma.transpose

#### Next topic

numpy.ma.atleast_2d

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