NumPy full()

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