`numpy.empty()`

Функция numpy.empty() возвращает новый массив заданной формы и типа без инициализации значений. Содержимое — случайный «мусор» из памяти. Работает быстрее, чем zeros или ones, и подходит, если массив сразу заполняется.

Сигнатура

numpy.empty(shape, dtype=float, order='C', *, like=None)

Параметры

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

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

ndarray заданной формы и типа. Значения не определены — это произвольные данные из выделенной памяти.

Примеры

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

import numpy as np

a = np.empty(4)
print(a)

[6.93e-310 6.93e-310 0.00e+000 0.00e+000]

Пример 2. Двумерный массив целых.

m = np.empty((2, 3), dtype=int)
print(m.shape, m.dtype)

(2, 3) int64

Пример 3. Заполнение после создания.

buf = np.empty(5, dtype=int)
for i in range(5):
    buf[i] = i * i
print(buf)

[ 0  1  4  9 16]

Пример 4. Буфер для показаний АЦП.

# Готовим пустой буфер на 8 измерений
adc_buffer = np.empty(8, dtype=np.uint16)
adc_buffer[:] = [512, 520, 530, 525, 515, 518, 522, 519]
print("Среднее:", adc_buffer.mean())

Среднее: 520.125

Пример 5. Сравнение со zeros.

z = np.zeros((2, 2))
e = np.empty((2, 2))
print("zeros:\n", z)
print("empty (значения произвольны):\n", e.shape)

zeros:
 [[0. 0.]
 [0. 0.]]
empty (значения произвольны):
 (2, 2)

См. также

Примечание

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

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

numpy.empty()