Series.to_frame()

Метод to_frame() преобразует Series в DataFrame с одним столбцом. Часто нужен, когда функции или методы (например, merge, concat) требуют именно двумерную структуру.

Сигнатура

Series.to_frame(name=<no_default>)

Параметры

  • name — имя столбца в результирующем DataFrame. Если не указано, берётся Series.name (или 0, если имени нет).

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

DataFrame с одним столбцом.

Примеры

Пример 1. Базовое преобразование

import pandas as pd

s = pd.Series([23.5, 24.1, 22.8], name="temp")
df = s.to_frame()
print(df)

   temp
0  23.5
1  24.1
2  22.8

Пример 2. Явное имя столбца

import pandas as pd

s = pd.Series([1, 2, 3])
print(s.to_frame(name="value"))

   value
0      1
1      2
2      3

Пример 3. Объединение через concat

import pandas as pd

a = pd.Series([1, 2, 3], name="a")
b = pd.Series([4, 5, 6], name="b")
df = pd.concat([a.to_frame(), b.to_frame()], axis=1)
print(df)

   a  b
0  1  4
1  2  5
2  3  6

Пример 4. Выделение столбца из DataFrame и обратно

import pandas as pd

df = pd.DataFrame({"pin": ["A0", "A1"], "val": [512, 600]})
only_val = df["val"].to_frame()
print(only_val)

   val
0  512
1  600

Пример 5. Series без имени

import pandas as pd

s = pd.Series([10, 20])
print(s.to_frame())

    0
0  10
1  20

См. также

Примечание

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

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