numpy.full

numpy.full(shape, fill_value, dtype=None, order='C', *, device=None, like=None)[source]

Возвращает новый массив заданной формы и типа, заполненный fill_value.

Параметры:

shapeint или последовательность целых чисел

Форма нового массива, например, (2, 3) или 2.

fill_valueскаляр или массив_подобный

Значение заполнения.

dtypeтип данных, необязательно

Желаемый тип данных для массива. По умолчанию, None, означает

np.array(fill_value).dtype.

order{‘C’, ‘F’}, необязательно

Определяет, хранить ли многомерные данные в C- или Fortran-последовательном (строка или столбец) порядке в памяти.

deviceстрока, необязательно

Устройство, на котором разместить созданный массив. По умолчанию: None. Только для совместимости с Array-API, поэтому должен быть "cpu" при передаче.

Добавлен в версии 2.0.0.

likeмассив_подобный, необязательно

Ссылка на объект, позволяющая создавать массивы, которые не являются массивами NumPy. Если в качестве like передан массив-подобный объект, поддерживающий протокол __array_function__, результат будет определяться им. В этом случае гарантируется создание объекта массива, совместимого с переданным через этот аргумент.

Добавлен в версии 1.20.0.

Возвращает:

outndarray

Массив fill_value заданной формы, типа и порядка.

См. также

full_like

Возвращает новый массив с формой входных данных, заполненных значением.

empty

Возвращает новый незаполненный массив.

ones

Возвращает новый массив, устанавливающий значения в единицу.

zeros

Возвращает новый массив, устанавливающий значения в ноль.

Примеры

>>> np.full((2, 2), np.inf)
array([[inf, inf],
       [inf, inf]])
>>> np.full((2, 2), 10)
array([[10, 10],
       [10, 10]])

>>> np.full((2, 2), [1, 2])
array([[1, 2],
       [1, 2]])