pandas.set_option

熊猫。set_option ( pat , value ) = <pandas._config.config.CallableDynamicDoc对象>

设置指定选项的值。

可用选项：

• 计算。[use_bottleneck、use_numba、use_numexpr]

• 显示。[chop_threshold、colheader_justify、date_dayfirst、date_yearfirst、编码、expand_frame_repr、float_format]

• display.html.[边框、table_schema、use_mathjax]

• 显示。[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_深度、精度、show_dimensions]

• display.unicode.[ambigious_as_wide, east_asian_width]

• 显示。[宽度]

• 未来。[infer_string，no_silent_downcasting]

• io.excel.ods.[读者、作家]

• io.excel.xls.[读者]

• io.excel.xlsb.[读者]

• io.excel.xlsm.[读者、作家]

• io.excel.xlsx.[读者、作家]

• io.hdf。[默认格式，dropna_table]

• io.parquet.[引擎]

• io.sql.[引擎]

• 模式。[chained_assignment、copy_on_write、data_manager、sim_interactive、string_storage、use_inf_as_na]

• 绘图。[后端]

• 绘图.matplotlib.[register_converters]

• styler.format.[小数、转义、格式化程序、na_rep、精度、千]

• styler.html.[mathjax]

• styler.latex.[环境、hrules、multicol_align、multirow_align]

• styler.render.[编码、max_columns、max_elements、max_rows、repr]

• styler.sparse.[列，索引]

参数：

帕特斯特​

正则表达式应该匹配单个选项。注意：为了方便起见，支持部分匹配，但除非您使用完整的选项名称（egxyzoption_name），否则如果引入具有相似名称的新选项，您的代码可能会在未来版本中中断。

值对象

期权的新价值。

返回：

没有任何

加薪：

OptionError 如果不存在这样的选项

笔记

请参阅用户指南以获取更多信息。

可用选项及其描述：

计算.use_bottleneck bool

如果安装了瓶颈库则使用加速，默认为True 有效值：False,True [默认：True] [当前：True]

计算.use_numba布尔值

如果已安装，则使用 numba 引擎选项进行选择操作，默认为 False 有效值：False,True [默认值：False] [当前：False]

计算.use_numexpr布尔值

如果安装了 numexpr 库，则使用它来加速计算，默认为 True 有效值：False,True [默认值：True] [当前：True]

display.chop_threshold float 或 None

如果设置为浮点值，所有小于给定阈值的浮点值将被 repr 和朋友显示为 0。 [默认：无] [当前：无]

display.colheader_justify '左'/'右'

控制列标题的对齐方式。由 DataFrameFormatter 使用。 [默认：右] [当前：右]

display.date_dayfirst布尔值

当为 True 时，首先打印并解析日期，例如 20/01/2005 [默认值：False] [当前：False]

display.date_yearfirst布尔值

当为 True 时，首先打印和解析日期，例如 2005/01/20 [默认值：False] [当前：False]

display.encoding str/unicode

默认为检测到的控制台编码。指定 to_string 返回的字符串使用的编码，这些通常是要在控制台上显示的字符串。 [默认：utf-8] [当前：utf-8]

display.expand_frame_repr布尔值

是否打印跨多行的宽 DataFrame 的完整 DataFrame 表示，max_columns仍然受到尊重，但如果其宽度超过display.width，输出将环绕多个“页面” 。 [默认值：True] [当前：True]

display.float_format可调用

可调用函数应接受浮点数并返回具有所需数字格式的字符串。这在某些地方使用，例如 SeriesFormatter。有关示例，请参阅formats.format.EngFormatter。 [默认：无] [当前：无]

显示.html.border int

在DataFrame HTML 表示的标签border=value中插入一个属性。 <table>[默认：1] [当前：1]

display.html.table_schema布尔值

是否为支持它的前端发布表架构表示。 （默认值：False）[默认值：False] [当前：False]

display.html.use_mathjax布尔值

当为 True 时，Jupyter 笔记本将使用 MathJax 处理表格内容，呈现由美元符号括起来的数学表达式。 （默认值：True）[默认值：True] [当前：True]

display.large_repr '截断'/'信息'

对于超过 max_rows/max_cols 的 DataFrame，repr（和 HTML repr）可以显示截断的表，或从 df.info() 切换到视图（早期版本的 pandas 中的行为）。 [默认：截断] [当前：截断]

显示.max_categories int

这设置了 pandas 在打印类别或一系列 dtype“类别”时应输出的最大类别数。 [默认：8] [当前：8]

显示.max_columns int

如果超过 max_cols，则切换到截断视图。根据 large_repr，对象要么被集中截断，要么被打印为摘要视图。 “无”值表示无限制。

如果 python/IPython 在终端中运行并且large_repr 等于“truncate”，则可以将其设置为 0 或 None，并且 pandas 将自动检测终端的宽度并打印适合屏幕宽度的截断对象。 IPython 笔记本、IPython qtconsole 或 IDLE 不在终端中运行，因此无法进行正确的自动检测，默认为 20。 [默认值：0] [当前：0]

display.max_colwidth int 或 None

pandas 数据结构的 repr 中列的最大宽度（以字符为单位）。当列溢出时，“...”占位符会嵌入到输出中。 “无”值表示无限制。 [默认：50] [当前：50]

显示.max_dir_items int

将添加到dir(...)的项目数。 “无”值表示无限制。由于 dir 已缓存，因此更改此选项不会立即影响已存在的数据帧，直到删除或添加列为止。

例如，这用于建议从数据帧到选项卡完成的列。 [默认：100] [当前：100]

显示.max_info_columns int

max_info_columns 在 DataFrame.info 方法中使用来决定是否打印每列信息。 [默认：100] [当前：100]

显示.max_info_rows int

df.info() 通常会显示每列的空计数。对于大框架，这可能会非常慢。 max_info_rows 和 max_info_cols 将此空检查仅限于尺寸小于指定尺寸的帧。 [默认：1690785] [当前：1690785]

显示.max_rows int

如果超过 max_rows，则切换到截断视图。根据 large_repr，对象要么被集中截断，要么被打印为摘要视图。 “无”值表示无限制。

如果 python/IPython 在终端中运行并且large_repr 等于“truncate”，则可以将其设置为 0，并且 pandas 将自动检测终端的高度并打印适合屏幕高度的截断对象。 IPython Notebook、IPython qtconsole 或 IDLE 不在终端中运行，因此无法进行正确的自动检测。 [默认：60] [当前：60]

display.max_seq_items int 或 None

当漂亮打印一个长序列时，不会再 打印max_seq_items 。如果省略项目，则将通过在结果字符串中添加“...”来表示它们。

如果设置为“无”，则要打印的项目数量不受限制。 [默认：100] [当前：100]

display.memory_usage bool、string 或 None

这指定在调用 df.info() 时是否应显示 DataFrame 的内存使用情况。有效值 True、False、'deep' [默认值：True] [当前：True]

显示.min_rows int

截断视图中显示的行数（超过max_rows时）。当max_rows设置为 None 或 0时忽略。设置为 None 时，遵循max_rows的值。 [默认：10] [当前：10]

display.multi_sparse布尔值

“sparsify” MultiIndex 显示（不显示组内外部级别中的重复元素）[默认值：True] [当前：True]

display.notebook_repr_html布尔值

当 True 时，IPython 笔记本将使用 pandas 对象的 html 表示（如果可用）。 [默认值：True] [当前：True]

显示.pprint_nest_深度int

控制漂亮打印时要处理的嵌套级别数 [默认值：3] [当前：3]

显示精度int

浮点输出精度以小数点后的位数表示，适用于常规格式和科学记数法。类似于precision在numpy.set_printoptions(). [默认值：6] [当前：6]

display.show_dimensions布尔值或 'truncate'

是否在 DataFrame repr 的末尾打印尺寸。如果指定“truncate”，则仅在框架被截断时打印尺寸（例如，不显示所有行和/或列）[默认：截断] [当前：截断]

display.unicode.ambiguously_as_wide布尔值

是否使用 Unicode 东亚宽度来计算显示文本宽度。启用此功能可能会影响性能（默认值：False）[默认值：False] [当前：False]

display.unicode.east_asian_width布尔值

是否使用 Unicode 东亚宽度来计算显示文本宽度。启用此功能可能会影响性能（默认值：False）[默认值：False] [当前：False]

显示宽度int

显示宽度（以字符为单位）。如果 python/IPython 在终端中运行，则可以将其设置为 None，并且 pandas 将正确自动检测宽度。请注意，IPython Notebook、IPython qtconsole 或 IDLE 不在终端中运行，因此无法正确检测宽度。 [默认：80] [当前：80]

future.infer_string 是否将 str 对象的序列推断为 pyarrow string dtype，这将是 pandas 3.0 中的默认值（此时此选项将被弃用）。

[默认值：False] [当前：False]

future.no_silent_downcasting 是否选择未来的行为，该行为不会默默地向下转换 Series 和 DataFrame where、mask和Clip方法的结果。静默向下转型将在 pandas 3.0 中删除（届时此选项将被弃用）。

[默认值：False] [当前：False]

io.excel.ods.reader字符串

“ods”文件的默认 Excel 阅读器引擎。可用选项：自动、odf、炉甘石。 [默认：自动] [当前：自动]

io.excel.ods.writer字符串

“ods”文件的默认 Excel 编写引擎。可用选项：自动、odf。 [默认：自动] [当前：自动]

io.excel.xls.reader字符串

“xls”文件的默认 Excel 阅读器引擎。可用选项：自动、xlrd、炉甘石。 [默认：自动] [当前：自动]

io.excel.xlsb.reader字符串

“xlsb”文件的默认 Excel 阅读器引擎。可用选项：auto、pyxlsb、炉甘石。 [默认：自动] [当前：自动]

io.excel.xlsm.reader字符串

“xlsm”文件的默认 Excel 阅读器引擎。可用选项：auto、xlrd、openpyxl、炉甘石。 [默认：自动] [当前：自动]

io.excel.xlsm.writer字符串

“xlsm”文件的默认 Excel 编写器引擎。可用选项：auto、openpyxl。 [默认：自动] [当前：自动]

io.excel.xlsx.reader字符串

“xlsx”文件的默认 Excel 阅读器引擎。可用选项：auto、xlrd、openpyxl、炉甘石。 [默认：自动] [当前：自动]

io.excel.xlsx.writer字符串

“xlsx”文件的默认 Excel 编写引擎。可用选项：auto、openpyxl、xlsxwriter。 [默认：自动] [当前：自动]

io.hdf.default_format格式

默认格式写入格式，如果无，则 put 将默认为 'fixed'，append 将默认为 'table' [默认：无] [当前：无]

io.hdf.dropna_table布尔值

追加到表时删除所有 nan 行 [默认值：False] [当前：False]

io.parquet.engine字符串

默认的镶木地板读取器/写入器引擎。可用选项：'auto'、'pyarrow'、'fastparquet'，默认为 'auto' [默认：auto] [当前：auto]

io.sql.engine字符串

默认的 sql 读取器/写入器引擎。可用选项: 'auto', 'sqlalchemy', 默认为 'auto' [默认: auto] [当前: auto]

mode.chained_赋值字符串

如果尝试使用链式赋值，则引发异常、警告或不执行任何操作，默认为警告 [默认：警告] [当前：警告]

mode.copy_on_write bool

使用写入时复制来使用新的复制视图行为。默认为 False，除非被“PANDAS_COPY_ON_WRITE”环境变量覆盖（如果设置为 True 的“1”，则需要在导入 pandas 之前设置）。 [默认值：False] [当前：False]

mode.data_manager字符串

内部数据管理器类型；可以是“块”或“数组”。默认为“block”，除非被“PANDAS_DATA_MANAGER”环境变量覆盖（需要在导入 pandas 之前设置）。 [默认：块] [当前：块]（已弃用，请使用 `` 代替。）

mode.sim_interactive布尔值

是否模拟交互模式以进行测试[默认：False][当前：False]

mode.string_存储字符串

StringDtype 的默认存储。如果future.infer_string设置为 True，则忽略此选项 。 [默认：python] [当前：python]

mode.use_inf_as_na布尔值

True 表示将 None、NaN、INF、-INF 视为 NA（旧方式），False 表示 None 和 NaN 为空，但 INF、-INF 不为 NA（新方式）。

此选项在 pandas 2.1.0 中已弃用，并将在 3.0 中删除。 [默认值：False] [当前：False]（已弃用，请使用 `` 代替。）

绘图后端str

要使用的绘图后端。默认值为“matplotlib”，由 pandas 提供的后端。可以通过提供实现后端的模块的名称来指定其他后端。 [默认：matplotlib] [当前：matplotlib]

plotting.matplotlib.register_converters bool 或 'auto'。

是否使用 matplotlib 的单位注册表注册日期、时间、日期时间和周期的转换器。切换为 False 将删除转换器，恢复 pandas 覆盖的任何转换器。 [默认：自动] [当前：自动]

styler.format.decimal str

浮点数和复数的小数点分隔符的字符表示形式。 [默认值：.] [当前：.]

styler.format.escape str，可选

是否根据给定的上下文转义某些字符； html 或乳胶。 [默认：无] [当前：无]

styler.format.formatter str，可调用，dict，可选

用作默认值的格式化程序对象Styler.format。 [默认：无] [当前：无]

styler.format.na_rep str，可选

标识为缺失的值的字符串表示形式。 [默认：无] [当前：无]

styler.format. precision int 类型

浮点数和复数的精度。 [默认值：6] [当前：6]

styler.format.thousands str，可选

浮点型、整数型和复数型千位分隔符的字符表示形式。 [默认：无] [当前：无]

styler.html.mathjax布尔

如果为 False，则会将特殊的 CSS 类渲染到表属性，指示 Jupyter Notebook 中不会使用 Mathjax。 [默认值：True] [当前：True]

styler.latex.environment str

环境要更换\begin{table}。如果使用“longtable”，则会产生特定的 longtable 环境格式。 [默认：无] [当前：无]

styler.latex.hrules布尔

是否在顶部、底部和标题下方添加水平线。 [默认值：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，可选

将呈现的最大列数。仍可能减少到满足max_elements，这优先。 [默认：无] [当前：无]

styler.render.max_elements int

修剪之前渲染的数据单元格 (<td>) 元素的最大数量将出现在列、行或两者上（如果需要）。 [默认：262144] [当前：262144]

styler.render.max_rows int，可选

将呈现的最大行数。仍可能减少到满足max_elements，这优先。 [默认：无] [当前：无]

styler.render.repr str

确定在 {“html”, “latex”} 中的 Jupyter Notebook 中使用哪个输出。 [默认：html] [当前：html]

styler.sparse.columns布尔值

是否稀疏分层列的显示。设置为 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')