pandas.api.interchange.from_dataframe

pandas.api.interchange.from_dataframe(df, allow_copy=True)[исходный код]

Создать pd.DataFrame из любого DataFrame, поддерживающего протокол обмена.

Примечание

Для новых разработок настоятельно рекомендуем использовать Arrow C Data Interface вместе с Arrow PyCapsule Interface вместо протокола обмена. Начиная с pandas 2.3, from_dataframe использует PyCapsule Interface и переходит на протокол обмена только в случае неудачи.

Предупреждение

Из-за серьёзных проблем с реализацией рекомендуем рассматривать возможность использования протокола обмена только в следующих случаях:

• преобразование в pandas: для pandas >= 2.0.3

• преобразование из pandas: для pandas >= 3.0.0

Параметры:

df:DataFrameXchg

Объект, поддерживающий протокол обмена, то есть метод __dataframe__.

allow_copy:bool, default: True

Разрешить ли копирование памяти для выполнения преобразования (если значение false, запрашивается подход без копирования).

Возвращает:

pd.DataFrame

Примеры

>>> df_not_necessarily_pandas = pd.DataFrame({'A': [1, 2], 'B': [3, 4]})
>>> interchange_object = df_not_necessarily_pandas.__dataframe__()
>>> interchange_object.column_names()
Index(['A', 'B'], dtype='object')
>>> df_pandas = (pd.api.interchange.from_dataframe
...              (interchange_object.select_columns_by_name(['A'])))
>>> df_pandas
     A
0    1
1    2

Эти методы (column_names, select_columns_by_name) должны работать с любой библиотекой для работы с фреймами данных, реализующей протокол обмена.