pandas.get_option

pandas.get_option(pat)=<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), ваш код может сломаться в будущих версиях, если будут добавлены новые параметры с похожими именами.

Возвращаемое значение:

result:значение параметра

Исключения:

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() обычно показывает количество null-значений для каждого столбца. Для больших кадров это может быть довольно медленным. max_info_rows и max_info_cols ограничивают проверку на null-значения только для кадров с размерами меньше заданных. [по умолчанию: 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’

Вывод размеров в конце repr 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 — нет (новый способ). Этот параметр устарел в 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. К значениям, кроме naive, можно добавить декораторы «|», например, «|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.get_option('display.max_columns')  
4