This is a pre-release version (2.5.0.dev0+git20251130.2de293a). Go to latest (2.4.4)
{ } Raw JSON

bundles / numpy 2.5.0.dev0+git20251130.2de293a / numpy / ma / core / ones

function

numpy.ma.core:ones

source: build-install/usr/lib/python3.14/site-packages/numpy/ma/core.py :8749

Signature

def   ones ( shape dtype = None order = C * device = None like = None fill_value = None hardmask = False )

Summary

Return a new array of given shape and type, filled with ones.

Parameters

shape : int or sequence of ints

Shape of the new array, e.g., (2, 3) or 2.

dtype : data-type, optional

The desired data-type for the array, e.g., numpy.int8. Default is numpy.float64.

order : {'C', 'F'}, optional, default: C

Whether to store multi-dimensional data in row-major (C-style) or column-major (Fortran-style) order in memory.

device : str, optional

The device on which to place the created array. Default: None. For Array-API interoperability only, so must be "cpu" if passed.

like : array_like, optional

Reference object to allow the creation of arrays which are not NumPy arrays. If an array-like passed in as like supports the __array_function__ protocol, the result will be defined by it. In this case, it ensures the creation of an array object compatible with that passed in via this argument.

Returns

out : MaskedArray

Array of ones with the given shape, dtype, and order.

Examples

import numpy as np
np.ones(5)
np.ones((5,), dtype=int)
np.ones((2, 1))
s = (2,2)
np.ones(s)

See also

empty

Return a new uninitialized array.

full

Return a new array of given shape filled with value.

ones_like

Return an array of ones with shape and type of input.

zeros

Return a new array setting values to zero.

Aliases

  • numpy.ma.ones

Referenced by