numpy.ndarray.tolist

метод

ndarray.tolist()

Возвращает массив в виде вложенного списка Python с глубиной вложенности a.ndim.

Возвращает копию данных массива в виде (вложенного) списка Python. Элементы данных преобразуются к ближайшему совместимому встроенному типу Python с помощью функции item.

Если a.ndim равно 0, то, поскольку глубина вложенности списка равна 0, это будет не список, а просто скаляр Python.

Параметры

none

Возвращает

yobject, or list of object, or list of list of object, or …

Возможный вложенный список элементов массива.

Примечания

Массив можно воссоздать с помощью a = np.array(a.tolist()), хотя это иногда может привести к потере точности.

Примеры

Для одномерного массива a.tolist() почти совпадает с list(a), за исключением того, что tolist преобразует числовые типы NumPy в числовые типы Python:

>>> a = np.uint32([1, 2])
>>> a_list = list(a)
>>> a_list
[1, 2]
>>> type(a_list[0])
<class 'numpy.uint32'>
>>> a_tolist = a.tolist()
>>> a_tolist
[1, 2]
>>> type(a_tolist[0])
<class 'int'>

Кроме того, для двумерного массива tolist применяется рекурсивно:

>>> a = np.array([[1, 2], [3, 4]])
>>> list(a)
[array([1, 2]), array([3, 4])]
>>> a.tolist()
[[1, 2], [3, 4]]

Базовый случай этой рекурсии — массив 0D:

>>> a = np.array(1)
>>> list(a)
Traceback (most recent call last):
  ...
TypeError: iteration over a 0-d array
>>> a.tolist()
1