numpy.full
numpy.full(shape, fill_value, dtype=None, order='C')
Функция full() возвращает новый массив указанной формы и типа, заполненный указанным значением fill_value
.
-
- shape - целое число, список или кортеж целых чисел
- Задает размеры необходимого массива - целое число или кортеж целых чисел.
- fill_value - число или любое допустимое значение NumPy
- Все элементы выходного массива будут равны
fill_value
. - dtype - тип данных NumPy (необязательный)
- Определяет тип данных выходного массива.
- order - 'C' или 'F' (необязательный)
- Этот параметр определяет в каком порядке массивы должны храниться в памяти: строчном C-стиле или столбчатом стиле Fortran.
-
- результат - массив NumPy
- Массив указанной формы, типа и порядка, все элементы которого равны указанному в
fill_value
значению.
Замечание
Если параметр 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')