polars.Series.to_pandas

Series.to_pandas(
    *,
    use_pyarrow_extension_array: bool = False,
    **kwargs: Any,
) → pd.Series[Any]

Преобразует этот Series в pandas Series.

Эта операция копирует данные, если use_pyarrow_extension_array не включён.

Параметры:

use_pyarrow_extension_array

Использовать массив расширения на основе PyArrow вместо массива NumPy для pandas Series. Это позволяет выполнять операции без копирования и сохранять нулевые значения. Последующие операции над полученным pandas Series могут вызвать преобразование в NumPy, если эти операции не поддерживаются функциями вычислений PyArrow.

**kwargs

Дополнительные именованные аргументы, передаваемые в pyarrow.Array.to_pandas().

Возвращает:

pandas.Series

Примечания

Для этой операции необходимо установить и pandas, и pyarrow.

Примеры

>>> s = pl.Series("a", [1, 2, 3])
>>> s.to_pandas()
0    1
1    2
2    3
Name: a, dtype: int64

Нулевые значения преобразуются в NaN.

>>> s = pl.Series("b", [1, 2, None])
>>> s.to_pandas()
0    1.0
1    2.0
2    NaN
Name: b, dtype: float64

Передайте use_pyarrow_extension_array=True, чтобы получить pandas Series на основе массива расширения PyArrow. Это позволит сохранить нулевые значения.

>>> s.to_pandas(use_pyarrow_extension_array=True)
0       1
1       2
2    <NA>
Name: b, dtype: int64[pyarrow]