pandas.DataFrame.to_stata

DataFrame.to_stata(self, 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