pandas.DataFrame.to_records

DataFrame.to_records(index=True, column_dtypes=None, index_dtypes=None)[source]

Преобразовать DataFrame в массив записей NumPy.

Индекс будет включен в качестве первого поля массива записей, если запрошено.

Параметры

index:bool, по умолчанию True

Включить индекс в результирующий массив записей, хранящийся в поле ‘index’ или с использованием метки индекса, если она установлена.

column_dtypes:str, тип, dict, по умолчанию None

Если строка или тип, тип данных для хранения всех столбцов. Если словарь, отображение имён столбцов и индексов (нумерация с нуля) на конкретные типы данных.

index_dtypes:str, тип, dict, по умолчанию None

Если строка или тип, тип данных для хранения всех уровней индекса. Если словарь, отображение имён уровней индекса и индексов (нумерация с нуля) на конкретные типы данных.

Это отображение применяется только если index=True.

Возвращает

numpy.recarray

Массив NumPy ndarray с метками DataFrame в качестве полей и каждой строкой DataFrame в качестве записей.

См. также

DataFrame.from_records

Преобразование структурированного или массива записей ndarray в DataFrame.

numpy.recarray

ndarray, который позволяет получать доступ к полям с помощью атрибутов, аналогично типизированным столбцам в таблице.

Примеры

>>> df = pd.DataFrame({'A': [1, 2], 'B': [0.5, 0.75]},
...                   index=['a', 'b'])
>>> df
   A     B
a  1  0.50
b  2  0.75
>>> df.to_records()
rec.array([('a', 1, 0.5 ), ('b', 2, 0.75)],
          dtype=[('index', 'O'), ('A', '<i8'), ('B', '<f8')])

Если индекс DataFrame не имеет метки, то имя поля recarray устанавливается в ‘index’. Если индекс имеет метку, то используется это имя поля:

>>> df.index = df.index.rename("I")
>>> df.to_records()
rec.array([('a', 1, 0.5 ), ('b', 2, 0.75)],
          dtype=[('I', 'O'), ('A', '<i8'), ('B', '<f8')])

Индекс можно исключить из массива записей:

>>> df.to_records(index=False)
rec.array([(1, 0.5 ), (2, 0.75)],
          dtype=[('A', '<i8'), ('B', '<f8')])

Типы данных можно указать для столбцов:

>>> df.to_records(column_dtypes={"A": "int32"})
rec.array([('a', 1, 0.5 ), ('b', 2, 0.75)],
          dtype=[('I', 'O'), ('A', '<i4'), ('B', '<f8')])

А также для индекса:

>>> df.to_records(index_dtypes="<S2")
rec.array([(b'a', 1, 0.5 ), (b'b', 2, 0.75)],
          dtype=[('I', 'S2'), ('A', '<i8'), ('B', '<f8')])

>>> index_dtypes = f"<S{df.index.str.len().max()}"
>>> df.to_records(index_dtypes=index_dtypes)
rec.array([(b'a', 1, 0.5 ), (b'b', 2, 0.75)],
          dtype=[('I', 'S1'), ('A', '<i8'), ('B', '<f8')])