pandas.read_hdf

pandas.read_hdf(path_or_buf, key=None, mode='r', errors='strict', where=None, start=None, stop=None, columns=None, iterator=False, chunksize=None, **kwargs)[source]

Чтение из хранилища, закрытие его, если оно было открыто.

Получение объекта pandas, сохранённого в файле, необязательно на основе критериев where.

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

Pandas использует PyTables для чтения и записи HDF5 файлов, что позволяет сериализовать данные типа object с помощью pickle при использовании формата “fixed”. Загрузка закодированных данных, полученных из ненадежных источников, может быть небезопасной.

См.: https://docs.python.org/3/library/pickle.html для более подробной информации.

Параметры

path_or_buf:str, path object, pandas.HDFStore

Любой допустимый путь к файлу допустим. Поддерживаются только локальные файловые системы, удалённые URL-адреса и объекты типа «поток» не поддерживаются.

Если вы хотите передать объект пути, pandas принимает любой os.PathLike.

В качестве альтернативы, pandas принимает открытый pandas.HDFStore объект.

key:object, необязательно

Идентификатор группы в хранилище. Его можно опустить, если HDF-файл содержит один объект pandas.

mode:{‘r’, ‘r+’, ‘a’}, по умолчанию ‘r’

Режим использования при открытии файла. Игнорируется, если path_or_buf является pandas.HDFStore. Значение по умолчанию - ‘r’.

errors:str, по умолчанию ‘strict’

Определяет, как обрабатывать ошибки кодирования и декодирования. См. параметр errors в open() для полного списка вариантов.

where:list, необязательно

Список объектов Term (или преобразуемых).

start:int, необязательно

Номер строки для начала выборки.

stop:int, необязательно

Номер строки для окончания выборки.

columns:list, необязательно

Список имён столбцов для возврата.

iterator:bool, необязательно

Возвращает объект-итератор.

chunksize:int, необязательно

Количество строк, включаемых в итерацию при использовании итератора.

**kwargs

Дополнительные ключевые параметры, передаваемые в HDFStore.

Возвращаемое значение

item:object

Выбранный объект. Тип возвращаемого значения зависит от сохранённого объекта.

См. также

DataFrame.to_hdf

Запись HDF-файла из DataFrame.

HDFStore

Доступ на низком уровне к HDF-файлам.

Примеры

>>> df = pd.DataFrame([[1, 1.0, 'a']], columns=['x', 'y', 'z'])  
>>> df.to_hdf('./store.h5', 'data')  
>>> reread = pd.read_hdf('./store.h5')