{ } Raw JSON

bundles / numpy 2.4.4 / numpy / full

_ArrayFunctionDispatcher

numpy:full

source: /numpy/_core/numeric.py :323

Signature

def   full ( shape fill_value dtype = None order = C * device = None like = None )

Summary

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

Parameters

shape : int or sequence of ints

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

fill_value : scalar or array_like

Fill value.

dtype : data-type, optional

The desired data-type for the array The default, None, means

np.array(fill_value).dtype.

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

Whether to store multidimensional data in C- or Fortran-contiguous (row- or column-wise) 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 : ndarray

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

Examples

import numpy as np
np.full((2, 2), np.inf)
np.full((2, 2), 10)
np.full((2, 2), [1, 2])

See also

empty

Return a new uninitialized array.

full_like

Return a new array with shape of input filled with value.

ones

Return a new array setting values to one.

zeros

Return a new array setting values to zero.

Aliases

  • numpy.full
  • numpy._core.numeric._full_with_like

Referenced by