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:строка, объект пути или буфер

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

convert_dates:словарь

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

write_index:bool

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

byteorder:строка

Может принимать значения “>”, “<”, “little” или “big”. Значение по умолчанию — sys.byteorder.

time_stamp:datetime

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

data_label:строка, необязательно

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

variable_labels:словарь

Словарь, содержащий столбцы в качестве ключей и метки переменных в качестве значений. Каждая метка должна содержать не более 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.

convert_strl:список, необязательно

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

compression:строка или словарь, значение по умолчанию ‘infer’

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

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

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

storage_options:словарь, необязательно

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

value_labels:словарь словарей

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

Добавлено в версии 1.4.0.

Возбуждает:

NotImplementedError

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

• Тип столбца не может быть представлен в 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')