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.rec.recarray

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

См. также

DataFrame.from_records

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

numpy.rec.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')])