pandas.DataFrame.to_stata

DataFrame.to_stata(path, convert_dates=None, write_index=True, byteorder=None, time_stamp=None, data_label=None, variable_labels=None, version=114, convert_strl=None, compression='infer', storage_options=None, *, value_labels=None)[source]

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

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

Параметры

path:str, объект пути или буфер

Строка, объект пути (реализующий os.PathLike[str]), или объект-поток, реализующий двоичную write() функцию.

Изменено в версии 1.0.0.

Ранее это было «fname»

convert_dates:dict

Словарь, сопоставляющий столбцы с типами datetime с внутренним форматом Stata для использования при записи дат. Доступные варианты — ‘tc’, ‘td’, ‘tm’, ‘tw’, ‘th’, ‘tq’, ‘ty’. Столбец может быть целым числом или именем. Столбцы datetime, для которых не указан тип преобразования, будут преобразованы в ‘tc’. Вызывает NotImplementedError, если столбец datetime содержит информацию о часовом поясе.

write_index:bool

Записать индекс в набор данных Stata.

byteorder:str

Может быть «>», «<», «little» или «big». По умолчанию — sys.byteorder.

time_stamp:datetime

Дата и время для использования в качестве даты создания файла. По умолчанию — текущее время.

data_label:str, необязательно

Метка для набора данных. Должна быть не длиннее 80 символов.

variable_labels:dict

Словарь, содержащий столбцы в качестве ключей и метки переменных в качестве значений. Каждая метка должна быть не длиннее 80 символов.

version:{114, 117, 118, 119, None}, по умолчанию 114

Версия для использования в выводимом файле dta. Установите в None, чтобы позволить pandas выбирать между форматами 118 или 119 в зависимости от количества столбцов в фрейме. Версия 114 может читаться Stata 10 и более поздними версиями. Версия 117 может читаться Stata 13 или более поздними версиями. Версия 118 поддерживается Stata 14 и более поздними версиями. Версия 119 поддерживается Stata 15 и более поздними версиями. Версия 114 ограничивает строковые переменные до 244 символов или меньше, в то время как версии 117 и более поздние позволяют строки длиной до 2 000 000 символов. Версии 118 и 119 поддерживают символы Юникода, а версия 119 поддерживает более 32 767 переменных.

Версию 119 обычно следует использовать только в том случае, если количество переменных превышает емкость формата dta 118. Экспорт меньших наборов данных в формате 119 может иметь непредвиденные последствия, и, по состоянию на ноябрь 2020 года, Stata SE не может читать файлы версии 119.

Изменено в версии 1.0.0: Добавлена поддержка форматов 118 и 119.

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

Список имен столбцов, которые нужно преобразовать в строковые столбцы в формат Stata StrL. Доступен только если версия — 117. Хранение строк в формате StrL может привести к созданию более компактных файлов dta, если строки содержат более 8 символов, а значения повторяются.

compression:str или dict, по умолчанию ‘infer’

Для сжатия выходных данных на лету. Если ‘infer’ и ‘path’ — путь, то обнаруживается сжатие по следующим расширениям: ‘.gz’, ‘.bz2’, ‘.zip’, ‘.xz’, ‘.zst’, ‘.tar’, ‘.tar.gz’, ‘.tar.xz’ или ‘.tar.bz2’ (иначе сжатия нет). Установите в None для отказа от сжатия. Также может быть словарем с ключом 'method', установленным в одном из {'zip', 'gzip', 'bz2', 'zstd', 'tar'} и другие пары ключ-значение передаются в zipfile.ZipFile, gzip.GzipFile, bz2.BZ2File, zstandard.ZstdCompressor или tarfile.TarFile, соответственно. Например, для более быстрого сжатия и создания воспроизводимого архива gzip можно передать следующее: compression={'method': 'gzip', 'compresslevel': 1, 'mtime': 1}.

Новое в версии 1.5.0: Добавлена поддержка файлов .tar.

Новое в версии 1.1.0.

Изменено в версии 1.4.0: Поддержка Zstandard.

storage_options:dict, необязательно

Дополнительные параметры, имеющие смысл для определенного подключения к хранилищу, например, хост, порт, имя пользователя, пароль и т. д. Для HTTP(S) URL-адресов пары ключ-значение передаются в urllib.request.Request в качестве параметров заголовка. Для других URL-адресов (например, начинающихся с «s3://» и «gcs://») пары ключ-значение передаются в fsspec.open. Дополнительные сведения см. в fsspec и urllib, а дополнительные примеры параметров хранилища см. здесь.

Новое в версии 1.2.0.

value_labels:dict of dicts

Словарь, содержащий столбцы в качестве ключей и словари значений столбца к меткам в качестве значений. Метки для одной переменной должны быть не длиннее 32 000 символов.

Новое в версии 1.4.0.

Возбуждает

NotImplementedError

• Если даты содержат информацию о часовом поясе

• Тип данных столбца не может быть представлен в Stata

ValueError

• Столбцы, перечисленные в convert_dates, не являются datetime64[ns] или datetime.datetime

• Столбец, указанный в convert_dates, отсутствует в DataFrame

• Метка категорий содержит более 32 000 символов

См. также

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')