`numpy.full()`

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

Сигнатура

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

Параметры

shape — форма массива (int или кортеж).
fill_value — значение, которым заполняется массив (скаляр или массив для броадкаста).
dtype — тип элементов (по умолчанию выводится из fill_value).
order — порядок размещения: 'C' или 'F'.

Возвращаемое значение

ndarray указанной формы, заполненный fill_value.

Примеры

Пример 1. Одномерный массив.

import numpy as np

print(np.full(5, 7))

[7 7 7 7 7]

Пример 2. Матрица из значений с плавающей точкой.

print(np.full((2, 3), 3.14))

[[3.14 3.14 3.14]
 [3.14 3.14 3.14]]

Пример 3. Явный dtype.

print(np.full((2, 2), 1, dtype=np.uint8))

[[1 1]
 [1 1]]

Пример 4. Инициализация буфера значением «нет данных».

# -1 как маркер «датчик не прочитан»
readings = np.full(8, -1, dtype=int)
readings[0] = 512
readings[3] = 700
print(readings)

[512  -1  -1 700  -1  -1  -1  -1]

Пример 5. Заполнение массивом через броадкаст.

row = np.array([1, 2, 3])
m = np.full((4, 3), row)
print(m)

[[1 2 3]
 [1 2 3]
 [1 2 3]
 [1 2 3]]

См. также

Примечание

Лицензия и источники

Техническое описание функции адаптировано из официальной документации NumPy (https://numpy.org/doc/stable/), BSD-3-Clause License. Примеры и пояснения — © AlashEd Wiki.

numpy.full()