pandas.DataFrame.to_stata

DataFrame.to_stata(fname, convert_dates=None, write_index=True, encoding='latin-1', byteorder=None, time_stamp=None, data_label=None, variable_labels=None, version=114, convert_strl=None) [source]

Экспорт объекта DataFrame в формат Stata dta.

Записывает DataFrame в файл данных Stata. Файлы «dta» содержат набор данных Stata.

Параметры:

fname : str, buffer or path object Строка, объект пути (pathlib.Path или py._path.local.LocalPath) или объект, реализующий функцию двоичного записи write(). Если используется буфер, то буфер не будет автоматически закрыт после записи данных файла. convert_dates : dict Словарь, сопоставляющий столбцы, содержащие типы datetime, со внутренним форматом Stata для использования при записи дат. Доступные варианты: «tc», «td», «tm», «tw», «th», «tq», «ty». Столбец может быть целым числом или именем. Столбцы datetime, для которых не указан тип преобразования, будут преобразованы в «tc». Вызывается NotImplementedError, если столбец datetime содержит информацию о часовом поясе. write_index : bool Записать индекс в набор данных Stata. encoding : str По умолчанию используется latin-1. Unicode не поддерживается. byteorder : str Может быть «>», «<», «little» или «big». По умолчанию sys.byteorder. time_stamp : datetime Дата и время для использования в качестве даты создания файла. По умолчанию — текущее время. data_label : str, optional Метка для набора данных. Должна содержать 80 символов или меньше. variable_labels : dict Словарь, содержащий столбцы в качестве ключей и метки переменных в качестве значений. Каждая метка должна содержать 80 символов или меньше. Введено в версии 0.19.0. version : {114, 117}, default 114 Версия, используемая в выходном файле dta. Версия 114 может быть прочитана Stata 10 и более поздними версиями. Версия 117 может быть прочитана Stata 13 и более поздними версиями. Версия 114 ограничивает строковые переменные 244 символами или меньше, а версия 117 позволяет использовать строки длиной до 2 000 000 символов. Введено в версии 0.23.0. convert_strl : list, optional Список имен столбцов для преобразования в строковые столбцы в формат Stata StrL. Доступно только если версия равна 117. Хранение строк в формате StrL может привести к созданию более компактных файлов dta, если строки содержат более 8 символов и значения повторяются. Введено в версии 0.23.0.

Возможные исключения:

NotImplementedError Если datetime содержит информацию о часовом поясе Тип данных столбца не может быть представлен в Stata ValueError Столбцы, указанные в convert_dates, не являются datetime64[ns] или datetime.datetime Столбец, указанный в convert_dates, отсутствует в DataFrame Метка категорий содержит более 32 000 символов Введено в версии 0.19.0.

См. также

read_stata

Импорт файлов данных Stata.

io.stata.StataWriter

Модуль для записи данных Stata.

io.stata.StataWriter117

Модуль для записи файлов версии 117.

Примеры

>>> df = pd.DataFrame({'animal': ['falcon', 'parrot', 'falcon',
...                               'parrot'],
...                    'speed': [350, 18, 361, 15]})
>>> df.to_stata('animals.dta')  # doctest: +SKIP