numpy.full

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

Функция numpy.full() возвращает новый массив указанной формы и типа, заполненный указанным значением fill_value.

Параметры:
shape - целое число, список или кортеж целых чисел
Задает размеры необходимого массива - целое число или кортеж целых чисел.
fill_value - число или любое допустимое значение NumPy
Все элементы выходного массива будут равны fill_value.
dtype - тип данных NumPy (необязательный)
Определяет тип данных выходного массива.
order - 'C' или 'F' (необязательный)
Этот параметр определяет в каком порядке массивы должны храниться в памяти: строчном C-стиле или столбчатом стиле Fortran.
Возвращает:
результат - массив NumPy
Массив указанной формы, типа и порядка, все элементы которого равны указанному в fill_value значению.
Смотрите так же: full_like, empty, zeros, ones

Замечание

Если параметр dtype не указан то тип данных выходного массива будет таким же как у fill_value, который можно узнать, выполнив np.array(fill_value).dtype:

>>> fill_value = 3.14
>>>
>>> np.array(fill_value).dtype
dtype('float64')

Примеры

>>> import numpy as np
>>> 
>>> np.full(4, 5)    #  Может появиться предупреждение
/home/n1/anaconda3/lib/python3.5/site-packages/numpy/core/numeric.py:301:
FutureWarning: in the future, full((4,), 5)
will return an array of dtype('int32')
format(shape, fill_value, array(fill_value).dtype), FutureWarning)
array([ 5.,  5.,  5.,  5.])
>>> # т.е. в будущем  full((4,), 5) вернет массива типа 'int32'
... #  на вычислениях это никак не скажется
... 
>>> np.full(4, 5) + 1
array([ 6.,  6.,  6.,  6.])
>>> 
>>> np.full((3, 3), 5, dtype = int)
array([[5, 5, 5],
       [5, 5, 5],
       [5, 5, 5]])
>>>
>>>
>>> #  Можно заполнить массив значением inf или nan:
... np.full((3, 3),np.inf)
array([[ inf,  inf,  inf],
       [ inf,  inf,  inf],
       [ inf,  inf,  inf]])
>>> 
>>> np.full((3, 3),np.nan)
array([[ nan,  nan,  nan],
       [ nan,  nan,  nan],
       [ nan,  nan,  nan]])
>>>
>>>
>>> #  Или строками:
... np.full((3, 3), 'a')
array([['a', 'a', 'a'],
       ['a', 'a', 'a'],
       ['a', 'a', 'a']], dtype='<U1')