Series.tolist() / Index.tolist()

Метод tolist() (синоним to_list()) преобразует Series или Index в обычный список Python. Полезен при передаче данных в библиотеки, не работающие с pandas-объектами напрямую, или при сериализации.

Сигнатура

Series.tolist()
Index.tolist()

Параметры

Метод не принимает параметров.

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

list с элементами того же типа (типы NumPy конвертируются в нативные Python-типы).

Примеры

Пример 1. Series в список

import pandas as pd

s = pd.Series([23.5, 24.1, 22.8])
print(s.tolist())

[23.5, 24.1, 22.8]

Пример 2. Index в список (имена столбцов)

import pandas as pd

df = pd.DataFrame({"pin": [], "value": [], "ts": []})
print(df.columns.tolist())

['pin', 'value', 'ts']

Пример 3. Передача в matplotlib

import pandas as pd

s = pd.Series([1, 4, 9, 16, 25])
y = s.tolist()
# plt.plot(y) — ожидает list/array
print(y)

[1, 4, 9, 16, 25]

Пример 4. Строковые значения

import pandas as pd

pins = pd.Series(["D2", "D4", "D6", "D8"])
print(pins.tolist())

['D2', 'D4', 'D6', 'D8']

Пример 5. Конвертация типов

import pandas as pd
import numpy as np

s = pd.Series([1, 2, 3], dtype=np.int64)
values = s.tolist()
print(type(values[0]))

<class 'int'>

См. также

• DataFrame.to_dict() / Series.to_dict()

• Series.to_frame()

Примечание

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

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