pandas.set_option

pandas.set_option(pat, value)=<pandas._config.config.CallableDynamicDoc object>

Устанавливает значение указанного параметра.

Доступные параметры:

• compute.[use_bottleneck, use_numba, use_numexpr]

• display.[chop_threshold, colheader_justify, date_dayfirst, date_yearfirst, encoding, expand_frame_repr, float_format]

• display.html.[border, table_schema, use_mathjax]

• display.[large_repr, max_categories, max_columns, max_colwidth, max_dir_items, max_info_columns, max_info_rows, max_rows, max_seq_items, memory_usage, min_rows, multi_sparse, notebook_repr_html, pprint_nest_depth, precision, show_dimensions]

• display.unicode.[ambiguous_as_wide, east_asian_width]

• display.[width]

• future.[infer_string, no_silent_downcasting]

• io.excel.ods.[reader, writer]

• io.excel.xls.[reader]

• io.excel.xlsb.[reader]

• io.excel.xlsm.[reader, writer]

• io.excel.xlsx.[reader, writer]

• io.hdf.[default_format, dropna_table]

• io.parquet.[engine]

• io.sql.[engine]

• mode.[chained_assignment, copy_on_write, data_manager, sim_interactive, string_storage, use_inf_as_na]

• plotting.[backend]

• plotting.matplotlib.[register_converters]

• styler.format.[decimal, escape, formatter, na_rep, precision, thousands]

• styler.html.[mathjax]

• styler.latex.[environment, hrules, multicol_align, multirow_align]

• styler.render.[encoding, max_columns, max_elements, max_rows, repr]

• styler.sparse.[columns, index]

Параметры:

pat:str

Регулярное выражение, которое должно соответствовать одному параметру. Примечание: частичные совпадения поддерживаются для удобства, но если вы не используете полное имя параметра (например, x.y.z.option_name), ваш код может сломаться в будущих версиях, если будут добавлены новые параметры с аналогичными именами.

value:object

Новое значение параметра.

Возвращает:

None

Возбуждает:

OptionError, если такого параметра не существует

Примечания

Дополнительную информацию см. в Руководстве пользователя.

Доступные параметры и их описания:

compute.use_bottleneck:bool

Использовать библиотеку bottleneck для ускорения, если она установлена, по умолчанию True. Допустимые значения: False,True [по умолчанию: True] [в настоящее время: True]

compute.use_numba:bool

Использовать движок numba для некоторых операций, если он установлен, по умолчанию False. Допустимые значения: False,True [по умолчанию: False] [в настоящее время: False]

compute.use_numexpr:bool

Использовать библиотеку numexpr для ускорения вычислений, если она установлена, по умолчанию True. Допустимые значения: False,True [по умолчанию: True] [в настоящее время: True]

display.chop_threshold:float or None

Если установлено значение с плавающей запятой, все значения с плавающей запятой, меньшие заданного порога, будут отображаться как точно 0 функциями repr и подобными. [по умолчанию: None] [в настоящее время: None]

display.colheader_justify:‘left’/’right’

Управляет выравниванием заголовков столбцов. Используется DataFrameFormatter. [по умолчанию: right] [в настоящее время: right]

display.date_dayfirst:boolean

Если True, даты печатаются и анализируются с днём впереди, например 20/01/2005 [по умолчанию: False] [в настоящее время: False]

display.date_yearfirst:boolean

Если True, даты печатаются и анализируются с годом впереди, например 2005/01/20 [по умолчанию: False] [в настоящее время: False]

display.encoding:str/unicode

По умолчанию используется обнаруженная кодировка консоли. Указывает кодировку, которая будет использоваться для строк, возвращаемых функцией to_string, эти строки, как правило, предназначены для отображения в консоли. [по умолчанию: utf-8] [в настоящее время: utf-8]

display.expand_frame_repr:boolean

Определяет, нужно ли печатать полное представление DataFrame для широких DataFrame на нескольких строках. max_columns всё ещё учитывается, но вывод будет переноситься на несколько «страниц», если его ширина превышает display.width. [по умолчанию: True] [в настоящее время: True]

display.float_format:callable

Функция должна принимать число с плавающей запятой и возвращать строку с желаемым форматом числа. Используется в некоторых местах, например, в SeriesFormatter. См. formats.format.EngFormatter для примера. [по умолчанию: None] [в настоящее время: None]

display.html.border:int

Атрибут border=value вставляется в тэг <table> для HTML-представления DataFrame. [по умолчанию: 1] [в настоящее время: 1]

display.html.table_schema:boolean

Определяет, нужно ли публиковать представление Table Schema для фронтендов, которые его поддерживают. (по умолчанию: False) [по умолчанию: False] [в настоящее время: False]

display.html.use_mathjax:boolean

Если True, Jupyter notebook обработает содержимое таблицы с помощью MathJax, рендеринг математических выражений, заключённых в знак доллара. (по умолчанию: True) [по умолчанию: True] [в настоящее время: True]

display.large_repr:‘truncate’/’info’

Для DataFrame, превышающих max_rows/max_cols, представление (и HTML-представление) может показать усечённую таблицу или переключиться на представление из df.info() (поведение в предыдущих версиях pandas). [по умолчанию: truncate] [в настоящее время: truncate]

display.max_categories:int

Устанавливает максимальное количество категорий, которые pandas должен вывести при печати Categorical или Series типа “category”. [по умолчанию: 8] [в настоящее время: 8]

display.max_columns:int

Если max_cols превышен, переключается на усечённое представление. В зависимости от large_repr, объекты либо усекаются по центру, либо выводятся как сводное представление. Значение ‘None’ означает неограниченное количество.

В случае, если python/IPython работает в терминале и large_repr равно ‘truncate’, это значение может быть установлено в 0 или None, и pandas будет автоматически определять ширину терминала и выводить усечённый объект, который поместится в ширине экрана. IPython notebook, IPython qtconsole или IDLE не работают в терминале, поэтому корректное автоматическое определение невозможно, и значение по умолчанию равно 20. [по умолчанию: 0] [в настоящее время: 0]

display.max_colwidth:int or None

Максимальная ширина столбца в символах в представлении pandas data structure. При переполнении столбца в выводе вставляется маркер “…”. Значение ‘None’ означает неограниченное количество. [по умолчанию: 50] [в настоящее время: 50]

display.max_dir_items:int

Количество элементов, которые будут добавлены в dir(…). Значение ‘None’ означает неограниченное количество. Поскольку dir кэшируется, изменение этого параметра немедленно не повлияет на уже существующие DataFrame до тех пор, пока столбец не будет удален или добавлен.

Это, например, используется для предложения столбцов из DataFrame для автодополнения. [по умолчанию: 100] [в настоящее время: 100]

display.max_info_columns:int

max_info_columns используется в методе DataFrame.info для определения, будет ли напечатана информация по столбцам. [по умолчанию: 100] [в настоящее время: 100]

display.max_info_rows:int

df.info() обычно показывает количество пустых значений для каждого столбца. Для больших таблиц это может быть довольно медленным. max_info_rows и max_info_cols ограничивают проверку на пустые значения только для таблиц меньших размеров, чем указано. [по умолчанию: 1690785] [в настоящее время: 1690785]

display.max_rows:int

Если max_rows превышен, переключается на усечённое представление. В зависимости от large_repr, объекты либо усекаются по центру, либо выводятся как сводное представление. Значение ‘None’ означает неограниченное количество.

Если python/IPython работает в терминале и large_repr равно ‘truncate’, это значение может быть установлено в 0, и pandas будет автоматически определять высоту терминала и выводить усечённый объект, который поместится по высоте экрана. IPython notebook, IPython qtconsole или IDLE не работают в терминале, поэтому корректное автоматическое определение невозможно. [по умолчанию: 60] [в настоящее время: 60]

display.max_seq_items:int or None

При красивой печати длинной последовательности не более max_seq_items будут напечатаны. Если элементы пропущены, они будут обозначены добавлением “…” к результирующей строке.

Если установлено значение None, количество элементов, подлежащих печати, не ограничено. [по умолчанию: 100] [в настоящее время: 100]

display.memory_usage:bool, string or None

Указывает, нужно ли отображать использование памяти DataFrame при вызове df.info(). Допустимые значения True,False,’deep’ [по умолчанию: True] [в настоящее время: True]

display.min_rows:int

Количество строк для отображения в усечённом представлении (когда max_rows превышен). Игнорируется, когда max_rows установлено в None или 0. Когда установлено в None, следует значению max_rows. [по умолчанию: 10] [в настоящее время: 10]

display.multi_sparse:boolean

«уплотнение» отображения MultiIndex (не отображать повторяющиеся элементы во внешних уровнях в группах) [по умолчанию: True] [в настоящее время: True]

display.notebook_repr_html:boolean

Если True, IPython notebook будет использовать html-представление для pandas-объектов (если оно доступно). [по умолчанию: True] [в настоящее время: True]

display.pprint_nest_depth:int

Управляет количеством вложенных уровней для обработки при красивой печати [по умолчанию: 3] [в настоящее время: 3]

display.precision:int

Точность вывода чисел с плавающей запятой в количестве знаков после запятой для обычного форматирования, а также научной нотации. Аналогично precision в numpy.set_printoptions(). [по умолчанию: 6] [в настоящее время: 6]

display.show_dimensions:boolean or ‘truncate’

Отображать ли размерность в конце представления DataFrame. Если указано ‘truncate’, отображать размеры только если таблица усечена (например, не отображаются все строки и/или столбцы) [по умолчанию: truncate] [в настоящее время: truncate]

display.unicode.ambiguous_as_wide:boolean

Использовать ли Unicode East Asian Width для расчета ширины отображаемого текста. Включение этого может повлиять на производительность (по умолчанию: False) [по умолчанию: False] [в настоящее время: False]

display.unicode.east_asian_width:boolean

Использовать ли Unicode East Asian Width для расчета ширины отображаемого текста. Включение этого может повлиять на производительность (по умолчанию: False) [по умолчанию: False] [в настоящее время: False]

display.width:int

Ширина отображения в символах. В случае, если python/IPython работает в терминале, это значение можно установить в None, и pandas корректно определит ширину. Обратите внимание, что IPython notebook, IPython qtconsole или IDLE не работают в терминале, и поэтому определить ширину корректно невозможно. [по умолчанию: 80] [в настоящее время: 80]

future.infer_string Whether to infer sequence of str objects as pyarrow string dtype, which will be the default in pandas 3.0 (at which point this option will be deprecated).

[по умолчанию: False] [в настоящее время: False]

future.no_silent_downcasting Whether to opt-in to the future behavior which will not silently downcast results from Series and DataFrame where, mask, and clip methods. Silent downcasting will be removed in pandas 3.0 (at which point this option will be deprecated).

[по умолчанию: False] [в настоящее время: False]

io.excel.ods.reader:string

Двигатель чтения по умолчанию для файлов ‘ods’. Доступные варианты: auto, odf, calamine. [по умолчанию: auto] [в настоящее время: auto]

io.excel.ods.writer:string

Двигатель записи по умолчанию для файлов ‘ods’. Доступные варианты: auto, odf. [по умолчанию: auto] [в настоящее время: auto]

io.excel.xls.reader:string

Двигатель чтения по умолчанию для файлов ‘xls’. Доступные варианты: auto, xlrd, calamine. [по умолчанию: auto] [в настоящее время: auto]

io.excel.xlsb.reader:string

Двигатель чтения по умолчанию для файлов ‘xlsb’. Доступные варианты: auto, pyxlsb, calamine. [по умолчанию: auto] [в настоящее время: auto]

io.excel.xlsm.reader:string

Двигатель чтения по умолчанию для файлов ‘xlsm’. Доступные варианты: auto, xlrd, openpyxl, calamine. [по умолчанию: auto] [в настоящее время: auto]

io.excel.xlsm.writer:string

Двигатель записи по умолчанию для файлов ‘xlsm’. Доступные варианты: auto, openpyxl. [по умолчанию: auto] [в настоящее время: auto]

io.excel.xlsx.reader:string

Двигатель чтения по умолчанию для файлов ‘xlsx’. Доступные варианты: auto, xlrd, openpyxl, calamine. [по умолчанию: auto] [в настоящее время: auto]

io.excel.xlsx.writer:string

Двигатель записи Excel по умолчанию для файлов ‘xlsx’. Доступные варианты: auto, openpyxl, xlsxwriter. [по умолчанию: auto] [в данный момент: auto]

io.hdf.default_format:format

формат записи по умолчанию, если None, то put по умолчанию будет ‘fixed’, а append по умолчанию будет ‘table’ [по умолчанию: None] [в данный момент: None]

io.hdf.dropna_table:boolean

удалять ВСЕ строки nan при добавлении в таблицу [по умолчанию: False] [в данный момент: False]

io.parquet.engine:string

Двигатель чтения/записи parquet по умолчанию. Доступные варианты: ‘auto’, ‘pyarrow’, ‘fastparquet’, по умолчанию ‘auto’ [по умолчанию: auto] [в данный момент: auto]

io.sql.engine:string

Двигатель чтения/записи sql по умолчанию. Доступные варианты: ‘auto’, ‘sqlalchemy’, по умолчанию ‘auto’ [по умолчанию: auto] [в данный момент: auto]

mode.chained_assignment:string

Вызвать исключение, предупреждение или бездействие при попытке использовать цепочку присваивания, по умолчанию предупреждение [по умолчанию: warn] [в данный момент: warn]

mode.copy_on_write:bool

Использовать новое поведение копирования с использованием Copy-on-Write. По умолчанию False, если не переопределено переменной среды ‘PANDAS_COPY_ON_WRITE’ (если установлено «1» для True, необходимо установить перед импортом pandas). [по умолчанию: False] [в данный момент: False]

mode.data_manager:string

Внутренний тип менеджера данных; может быть “block” или “array”. По умолчанию “block”, если не переопределено переменной среды ‘PANDAS_DATA_MANAGER’ (необходимо установить перед импортом pandas). [по умолчанию: block] [в данный момент: block] (Устарело, используйте `` вместо этого.)

mode.sim_interactive:boolean

Имитировать интерактивный режим для целей тестирования [по умолчанию: False] [в данный момент: False]

mode.string_storage:string

По умолчанию хранилище для StringDtype. Этот параметр игнорируется, если future.infer_string установлено в True. [по умолчанию: python] [в данный момент: python]

mode.use_inf_as_na:boolean

True означает, что None, NaN, INF, -INF обрабатываются как NA (старый способ), False означает, что None и NaN — это null, но INF, -INF — нет NA (новый способ). Этот параметр устарел в pandas 2.1.0 и будет удален в 3.0. [по умолчанию: False] [в данный момент: False] (Устарело, используйте `` вместо этого.)

plotting.backend:str

Используемый графический интерфейс. По умолчанию “matplotlib”, графический интерфейс, предоставляемый с pandas. Другие интерфейсы можно указать, предоставив имя модуля, реализующего интерфейс. [по умолчанию: matplotlib] [в данный момент: matplotlib]

plotting.matplotlib.register_converters:bool or ‘auto’.

Регистрировать ли преобразователи в реестре единиц matplotlib для дат, времен, дат и времени и периодов. Отключение приведет к удалению преобразователей, восстанавливая любые преобразователи, перезаписанные pandas. [по умолчанию: auto] [в данный момент: auto]

styler.format.decimal:str

Представление десятичного разделителя для чисел с плавающей точкой и комплексных чисел. [по умолчанию: .] [в данный момент: .]

styler.format.escape:str, optional

Выполнять ли экранирование определенных символов в зависимости от контекста; html или latex. [по умолчанию: None] [в данный момент: None]

styler.format.formatter:str, callable, dict, optional

Объект форматирования, который будет использоваться по умолчанию в Styler.format. [по умолчанию: None] [в данный момент: None]

styler.format.na_rep:str, optional

Строковое представление значений, отмеченных как отсутствующие. [по умолчанию: None] [в данный момент: None]

styler.format.precision:int

Точность для чисел с плавающей точкой и комплексных чисел. [по умолчанию: 6] [в данный момент: 6]

styler.format.thousands:str, optional

Представление разделителя тысяч для чисел с плавающей точкой, целых чисел и комплексных чисел. [по умолчанию: None] [в данный момент: None]

styler.html.mathjax:bool

Если False, будут рендериться специальные CSS-классы для атрибутов таблицы, указывающие, что Mathjax не будет использоваться в Jupyter Notebook. [по умолчанию: True] [в данный момент: True]

styler.latex.environment:str

Среда, которая заменяет \begin{table}. Если используется “longtable”, результаты в специфическом формате среды longtable. [по умолчанию: None] [в данный момент: None]

styler.latex.hrules:bool

Добавлять ли горизонтальные линии сверху и снизу и под заголовками. [по умолчанию: False] [в данный момент: False]

styler.latex.multicol_align:{“r”, “c”, “l”, “naive-l”, “naive-r”}

Указатель для горизонтального выравнивания разреженных LaTeX-многоколонок. К не наивным значениям также могут добавляться декораторы с трубками для рисования вертикальных линий, например, “|r” нарисует линию слева от объединённых ячеек, выровненных по правому краю. [по умолчанию: r] [в данный момент: r]

styler.latex.multirow_align:{“c”, “t”, “b”}

Указатель для вертикального выравнивания разреженных LaTeX-многострок. [по умолчанию: c] [в данный момент: c]

styler.render.encoding:str

Кодировка, используемая для выходных файлов HTML и LaTeX. [по умолчанию: utf-8] [в данный момент: utf-8]

styler.render.max_columns:int, optional

Максимальное количество столбцов, которые будут рендериться. Может быть уменьшено, чтобы удовлетворить max_elements, что имеет приоритет. [по умолчанию: None] [в данный момент: None]

styler.render.max_elements:int

Максимальное количество элементов ячеек данных (<td>), которые будут рендериться, прежде чем произойдёт обрезка по столбцам, строкам или обоим, если это необходимо. [по умолчанию: 262144] [в данный момент: 262144]

styler.render.max_rows:int, optional

Максимальное количество строк, которые будут рендериться. Может быть уменьшено, чтобы удовлетворить max_elements, что имеет приоритет. [по умолчанию: None] [в данный момент: None]

styler.render.repr:str

Определить, какой вывод использовать в Jupyter Notebook в {“html”, “latex”}. [по умолчанию: html] [в данный момент: html]

styler.sparse.columns:bool

Уплотнять ли отображение иерархических столбцов. Установка в False отобразит каждый явный элемент уровня в иерархическом ключе для каждого столбца. [по умолчанию: True] [в данный момент: True]

styler.sparse.index:bool

Уплотнять ли отображение иерархического индекса. Установка в False отобразит каждый явный элемент уровня в иерархическом ключе для каждой строки. [по умолчанию: True] [в данный момент: True]

Примеры

>>> pd.set_option('display.max_columns', 4)
>>> df = pd.DataFrame([[1, 2, 3, 4, 5], [6, 7, 8, 9, 10]])
>>> df
   0  1  ...  3   4
0  1  2  ...  4   5
1  6  7  ...  9  10
[2 rows x 5 columns]
>>> pd.reset_option('display.max_columns')