NumPy full()

The full() method creates a new array of given shape and type, filled with a given fill value.

Example

import numpy as np

# create an 2x2 array filled with 3s array1 = np.full((2, 2), 3)
print(array1) ''' Output: [[3 3] [3 3]] '''

full() Syntax

The syntax of full() is:

numpy.empty(shape, fill_value, dtype = None, order = 'C', like = None)

full() Arguments

The full() method takes the following arguments:

  • shape - desired new shape of the array (can be integer or sequence of integers)
  • fill_value - value to fill the array with
  • dtype (optional) - datatype of the array
  • order (optional) - specifies the order in which the uninitialized values are filled
  • like (optional)- reference object to allow the creation of arrays that are not NumPy arrays

full() Return Value

The full() method returns the array of given shape, order, and datatype filled with a fill value.


Example 1: Create Array With full()

import numpy as np

# create a 1D array of five 2s array1 = np.full(5,2)
print('1D Array: ',array1)
# create a 2D array of 2.0s array2 = np.full((3,2), 2.0)
print('2D Array: \n',array2)
# create an nd-array of (1,2) array3 = np.full((2, 2, 2), (1, 2))
print('n-d array:\n',array3)

Output

1D Array:  [2 2 2 2 2]
2D Array: 
[[2. 2.]
 [2. 2.]
 [2. 2.]]
n-d array:
[[[1 2]
  [1 2]]

 [[1 2]
  [1 2]]]

If unspecified, the default dtype is the data type of fill value.


Example 2: Change the Data Type of Array Elements

You can change the data type of array elements by using the dtype argument.

import numpy as np

# create a 1D array of five 2s

# pass the dtype argument to change the data type

array1 = np.full(5, 2, dtype = 'float')

print('1D Array: ',array1)

Output

1D Array:  [2. 2. 2. 2. 2.]

Here, the fill value is 2, so the default dtype is an integer. However, we changed the data type of the filled value to floating-point by passing dtype='float'.


Using Optional Order Argument in fullempty()

The order argument specifies the order in which the uninitialized values are filled.

The order can be:

  • 'C' - elements are stored row-wise (default)
  • 'F' - elements are stored column-wise

Our premium learning platform, created with over a decade of experience and thousands of feedbacks.

Learn and improve your coding skills like never before.

Try Programiz PRO
  • Interactive Courses
  • Certificates
  • AI Help
  • 2000+ Challenges