numpy.asarray()

Функция numpy.asarray() преобразует входные данные в ndarray. В отличие от np.array(), если на вход уже подан ``ndarray` подходящего типа, новый массив не создаётся — возвращается тот же объект.

Сигнатура

numpy.asarray(a, dtype=None, order=None, *, copy=None, like=None)

Параметры

  • a — входные данные: список, кортеж, ndarray и т. п.

  • dtype — желаемый тип данных. По умолчанию выводится из a.

  • order — порядок хранения: 'C', 'F', 'A', 'K'.

  • copy — создавать ли копию (NumPy 2.0+).

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

ndarray со значениями a. Возможно, тот же объект, что и a.

Примеры

Пример 1. Список → массив.

import numpy as np

data = [1, 2, 3, 4]
arr = np.asarray(data)
print(arr, arr.dtype)
[1 2 3 4] int64

Пример 2. Без копирования, если уже ndarray того же типа.

a = np.array([1.0, 2.0, 3.0])
b = np.asarray(a)
print(a is b)
True

Пример 3. Принудительное приведение типа.

a = np.array([1, 2, 3])
b = np.asarray(a, dtype=np.float32)
print(b, b.dtype, a is b)
[1. 2. 3.] float32 False

Пример 4. Вложенный список → 2D.

data = [[1, 2], [3, 4], [5, 6]]
arr = np.asarray(data)
print(arr.shape)
(3, 2)

Пример 5. Унификация входа в функции обработки сигнала.

def normalize(samples):
    x = np.asarray(samples, dtype=float)
    return x / np.max(np.abs(x))

print(normalize([2, -4, 1, 3]))
[ 0.5  -1.    0.25  0.75]

См. также

Примечание

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

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