numpy.asarray

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

Преобразует входные данные в массив.

Параметры:

aarray_like

Входные данные в любом формате, который может быть преобразован в массив. Это включает списки, списки кортежей, кортежи, кортежи кортежей, кортежи списков и ndarrays.

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

По умолчанию тип данных определяется по входным данным.

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

Расположение памяти. ‘A’ и ‘K’ зависят от порядка входного массива a. ‘C’ - строчная (C-стиль), ‘F’ - столбцовая (Fortran-стиль) организация памяти. ‘A’ (любой) означает ‘F’, если a является Фортрановским, 'C' в противном случае 'K' (сохранить) сохраняет порядок ввода. По умолчанию 'K'.

devicestr, необязательно

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

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

copybool, необязательно

Если True, то объект копируется. Если None, то объект копируется только в случае необходимости, т.е. если __array__ возвращает копию, если obj является вложенной последовательностью, или если копия необходима для выполнения других требований (dtype, order, и т.д.). Для False он генерирует исключение ValueError, если копию избежать нельзя. По умолчанию: None.

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

likearray_like, необязательно

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

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

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

outndarray

Интерпретация массива a. Копия не создается, если входной объект уже является ndarray с соответствующим типом данных и порядком. Если a является подклассом ndarray, возвращается базовый ndarray.

См. также

asanyarray

Аналогичная функция, которая проходит через подклассы.

ascontiguousarray

Преобразовать вход в непрерывный массив.

asfortranarray

Преобразовать вход в ndarray со столбцовым порядком памяти.

asarray_chkfinite

Аналогичная функция, проверяющая входные данные на наличие NaN и Inf.

fromiter

Создать массив из итератора.

fromfunction

Создать массив, выполняя функцию на позициях сетки.

Примеры

Преобразовать список в массив:

>>> a = [1, 2]
>>> np.asarray(a)
array([1, 2])

Существующие массивы не копируются:

>>> a = np.array([1, 2])
>>> np.asarray(a) is a
True

Если dtype задан, массив копируется только если тип данных не совпадает:

>>> a = np.array([1, 2], dtype=np.float32)
>>> np.shares_memory(np.asarray(a, dtype=np.float32), a)
True
>>> np.shares_memory(np.asarray(a, dtype=np.float64), a)
False

В отличие от asanyarray, подклассы ndarray не передаются:

>>> issubclass(np.recarray, np.ndarray)
True
>>> a = np.array([(1., 2), (3., 4)], dtype='f4,i4').view(np.recarray)
>>> np.asarray(a) is a
False
>>> np.asanyarray(a) is a
True