pandas.read_stata

pandas.read_stata(filepath_or_buffer, convert_dates=True, convert_categoricals=True, encoding=None, index_col=None, convert_missing=False, preserve_dtypes=True, columns=None, order_categoricals=True, chunksize=None, iterator=False) [source]

Чтение файла Stata в DataFrame.

Параметры:

filepath_or_buffer : str, path object or file-like object Любой допустимый путь к файлу является приемлемым. Строка может быть URL-адресом. Допустимые схемы URL включают http, ftp, s3 и file. Для URL-адресов файлов ожидается хост. Локальный файл может быть: file://localhost/path/to/table.dta. Если вы хотите передать объект пути, pandas принимает любой os.PathLike. Под объектом типа «подобный файлу» мы подразумеваем объекты с методом read(), например, обработчик файла (например, через встроенную функцию open или StringIO). convert_dates : boolean, defaults to True Преобразовать переменные даты в значения времени DataFrame. convert_categoricals : boolean, defaults to True Чтение меток значений и преобразование столбцов в категориальные/факторные переменные. encoding : string, None or encoding Кодировка, используемая для разбора файлов. По умолчанию None соответствует latin-1. index_col : string, optional, default: None Столбец, который нужно установить в качестве индекса. convert_missing : boolean, defaults to False Флаг, указывающий, следует ли преобразовывать пропущенные значения в их представления Stata. Если False, пропущенные значения заменяются на nan. Если True, столбцы, содержащие пропущенные значения, возвращаются с типами данных object, а пропущенные значения представлены объектами StataMissingValue. preserve_dtypes : boolean, defaults to True Сохранить типы данных Stata. Если False, числовые данные повышаются до типов по умолчанию pandas для внешних данных (float64 или int64). columns : list or None Столбцы для сохранения. Столбцы будут возвращены в указанном порядке. None возвращает все столбцы. order_categoricals : boolean, defaults to True Флаг, указывающий, упорядочены ли преобразованные категориальные данные. chunksize : int, default None Возвращает объект StataReader для итераций, возвращает куски с заданным количеством строк. iterator : boolean, default False Возвращает объект StataReader.

Возвращает:

DataFrame или StataReader

См. также

io.stata.StataReader

Программный модуль низкого уровня для чтения файлов данных Stata.

DataFrame.to_stata

Экспорт файлов данных Stata.

Примеры

Чтение файла Stata dta:

>>> df = pd.read_stata('filename.dta')

Чтение файла Stata dta кусками по 10 000 строк:

>>> itr = pd.read_stata('filename.dta', chunksize=10000)
>>> for chunk in itr:
...     do_something(chunk)