Spec-Zone.ru › pandas 0.21

pandas.Panel.to_json

Panel.to_json(path_or_buf=None, orient=None, date_format=None, double_precision=10, force_ascii=True, date_unit='ms', default_handler=None, lines=False, compression=None) [source]

Преобразование объекта в строку JSON.

Обратите внимание, что значения NaN и None будут преобразованы в null, а объекты datetime — в метки времени Unix.

Параметры:

path_or_buf : путь или буфер для записи результирующей строки

если это None, возвращается преобразованная строка

orient : строка

  • Серия

    • по умолчанию ‘индекс’
    • допустимые значения: {‘разделение’, ‘записи’, ‘индекс’}
  • DataFrame

    • по умолчанию ‘столбцы’
    • допустимые значения: {‘разделение’, ‘записи’, ‘индекс’, ‘столбцы’, ‘значения’}
  • Формат строки JSON

    • разделение : словарь, подобный {индекс -> [индекс], столбцы -> [столбцы], данные -> [значения]}
    • записи : список, подобный [{столбец -> значение}, ... , {столбец -> значение}]
    • индекс : словарь, подобный {индекс -> {столбец -> значение}}
    • столбцы : словарь, подобный {столбец -> {индекс -> значение}}
    • значения : только массив значений
    • таблица : словарь, подобный {‘схема’: {схема}, ‘данные’: {данные}}, описывающий данные, а компонент данных похож на orient='records'.

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

date_format : {None, ‘эпоха’, ‘iso’}

Тип преобразования даты. epoch = эпоха в миллисекундах, iso = ISO8601. Значение по умолчанию зависит от orient. Для orient=’table’, значение по умолчанию ‘iso’. Для всех остальных значений orient, значение по умолчанию ‘epoch’.

double_precision : количество десятичных знаков для кодирования

значений с плавающей точкой, по умолчанию 10.

force_ascii : принудительно кодировать строку в ASCII, по умолчанию True.

date_unit : строка, по умолчанию ‘мс’ (миллисекунды)

Единица времени для кодирования, управляет точностью метки времени и ISO8601. Одно из значений ‘с’, ‘мс’, ‘мкс’, ‘нс’ для секунды, миллисекунды, микросекунды и наносекунды соответственно.

default_handler : вызываемый, по умолчанию None

Обработчик, вызываемый, если объект не может быть преобразован в подходящий для JSON формат. Должен принять один аргумент, который является объектом для преобразования, и вернуть сериализуемый объект.

lines : boolean, по умолчанию False

Если ‘orient’ равно ‘записи’, выводить строку с разделителями JSON. Вызовет ValueError, если неверный ‘orient’, так как другие не являются списками.

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

compression : {None, ‘gzip’, ‘bz2’, ‘xz’}

Строка, представляющая сжатие для использования в выходном файле, используется только тогда, когда первый аргумент является именем файла

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

Возвращает:

объект того же типа, что и входной объект, с отфильтрованными осями информации

См. также

pd.read_json

Примеры

>>> df = pd.DataFrame([['a', 'b'], ['c', 'd']],
...                   index=['row 1', 'row 2'],
...                   columns=['col 1', 'col 2'])
>>> df.to_json(orient='split')
'{"columns":["col 1","col 2"],
  "index":["row 1","row 2"],
  "data":[["a","b"],["c","d"]]}'

Кодирование/декодирование DataFrame с использованием формата JSON 'index'.

>>> df.to_json(orient='index')
'{"row 1":{"col 1":"a","col 2":"b"},"row 2":{"col 1":"c","col 2":"d"}}'

Кодирование/декодирование DataFrame с использованием формата JSON 'records'. Обратите внимание, что метки индексов не сохраняются при этом кодировании.

>>> df.to_json(orient='records')
'[{"col 1":"a","col 2":"b"},{"col 1":"c","col 2":"d"}]'

Кодирование со схемой таблицы

>>> df.to_json(orient='table')
'{"schema": {"fields": [{"name": "index", "type": "string"},
                        {"name": "col 1", "type": "string"},
                        {"name": "col 2", "type": "string"}],
             "primaryKey": "index",
             "pandas_version": "0.20.0"},
  "data": [{"index": "row 1", "col 1": "a", "col 2": "b"},
           {"index": "row 2", "col 1": "c", "col 2": "d"}]}'

© 2008–2012, AQR Capital Management, LLC, Lambda Foundry, Inc. and PyData Development Team
Licensed under the 3-clause BSD License.
https://pandas.pydata.org/pandas-docs/version/0.21.1/generated/pandas.Panel.to_json.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API