pandas.DataFrame.from_records

classmethodDataFrame.from_records(data, index=None, exclude=None, columns=None, coerce_float=False, nrows=None)[source]

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

Создаёт объект DataFrame из структурированного массива ndarray, последовательности кортежей или словарей или DataFrame.

Параметры:

data:структурированный массив ndarray, последовательность кортежей или словарей или DataFrame

Структурированные входные данные.

Устарело начиная с версии 2.1.0: Передача DataFrame устарела.

index:строка, список полей, последовательность

Поле массива, используемое в качестве индекса, или определённый набор входных меток для использования.

exclude:последовательность, по умолчанию None

Столбцы или поля для исключения.

columns:последовательность, по умолчанию None

Имена столбцов для использования. Если переданные данные не имеют имён, связанных с ними, этот аргумент предоставляет имена для столбцов. В противном случае этот аргумент указывает порядок столбцов в результате (любые имена, не найденные в данных, станут столбцами со значениями all-NA).

coerce_float:bool, по умолчанию False

Попытка преобразовать значения нестроковых, нечисловых объектов (например, decimal.Decimal) в числа с плавающей запятой, полезно для наборов результатов SQL.

nrows:int, по умолчанию None

Количество строк для чтения, если данные являются итератором.

Возвращает:

DataFrame

См. также

DataFrame.from_dict

DataFrame из словаря массивов или словарей.

DataFrame

Объект DataFrame, созданный с помощью конструктора.

Примеры

Данные могут быть предоставлены как структурированный массив ndarray:

>>> data = np.array([(3, 'a'), (2, 'b'), (1, 'c'), (0, 'd')],
...                 dtype=[('col_1', 'i4'), ('col_2', 'U1')])
>>> pd.DataFrame.from_records(data)
   col_1 col_2
0      3     a
1      2     b
2      1     c
3      0     d

Данные могут быть предоставлены как список словарей:

>>> data = [{'col_1': 3, 'col_2': 'a'},
...         {'col_1': 2, 'col_2': 'b'},
...         {'col_1': 1, 'col_2': 'c'},
...         {'col_1': 0, 'col_2': 'd'}]
>>> pd.DataFrame.from_records(data)
   col_1 col_2
0      3     a
1      2     b
2      1     c
3      0     d

Данные могут быть предоставлены как список кортежей с соответствующими столбцами:

>>> data = [(3, 'a'), (2, 'b'), (1, 'c'), (0, 'd')]
>>> pd.DataFrame.from_records(data, columns=['col_1', 'col_2'])
   col_1 col_2
0      3     a
1      2     b
2      1     c
3      0     d