v0.11.2 (2021年8月)#

这是一个小版本发布,解决了 v0.11 系列中的问题,并增加了少量有针对性的增强功能。建议所有用户升级。

  • API |增强|lmplot() 中,添加了一个新的 facet_kws 参数,并从函数签名中弃用了 sharexshareylegend_out 参数;请将它们传递到 facet_kws 字典中 (#2576)。

  • |功能| 添加了一个 move_legend() 便捷函数,用于在现有轴或图形上重新定位图例,并更新其属性。此函数应优先于在没有图例数据的情况下调用 ax.legend,因为后者在不同的 seaborn 绘图类型中无法可靠工作 (#2643)。

  • |功能|histplot() 中,添加了 stat="percent" 作为归一化选项,使得条形高度总和为100,并将 stat="proportion" 作为现有 stat="probability" 的别名 (#2461, #2634)。

  • |功能| 添加了 FacetGrid.refline()JointGrid.refline() 方法,用于在每个子图中一步绘制水平和/或垂直参考线 (#2620)。

  • |功能|kdeplot() 中,添加了 warn_singular 参数以静默关于数据方差为零的警告 (#2566)。

  • |增强|histplot() 中,提高了处理大数据集和多分组/分面时的性能(#2559, #2570)。

  • |增强| FacetGridPairGridJointGrid 对象现在通过 .figure 属性引用底层的 matplotlib 图形。现有的 .fig 属性仍然存在,但不推荐使用,并可能在将来被弃用。其效果是,你现在可以在任何 seaborn 函数的返回值上调用 obj.figure 来访问 matplotlib 对象 (#2639)。

  • |增强|FacetGrid 及其使用的函数中,现在禁用了内部轴标签的可见性,并且在添加额外层时不再擦除外部轴标签。这为 seaborn 函数生成的图表产生了相同的结果,但对于自定义的分面图,可能会产生不同的(在大多数情况下更好)结果 (#2583)。

  • |增强|FacetGridPairGrid 以及使用它们的函数中,禁用了 matplotlib 的 figure.autolayout 参数,以避免图例与图表重叠 (#2571)。

  • |增强| 当输入一个数据框时,load_dataset() 助手现在会生成更具信息性的错误,从而减轻了一个常见的初学者错误 (#2604)。

  • |修复| |增强| 改进了对缺失数据的鲁棒性,包括对 pd.NA 类型的一些额外支持 (#2417, #2435)。

  • |修复|ecdfplot()rugplot() 中,修复了一个错误,即如果在绘图前数据轴具有对数刻度,结果会不正确 (#2504)。

  • |修复|histplot() 中,修复了一个使用 shrink 与非离散 bin 时条形位置不准确的问题 (#2477)。

  • |修复|displot() 中,修复了一个 bug,当使用分面而不指定 hue 时,common_norm=False 被忽略的问题 (#2468)。

  • |修复|histplot() 中,修复了两个错误,即自动计算的边缘宽度对于对数刻度直方图和y轴上的分类直方图来说太厚了 (#2522)。

  • |修复|histplot()kdeplot() 中,修复了一个当 fill=Falsealpha 参数被忽略的错误 (#2460)。

  • |修复|histplot()kdeplot() 中,修复了一个当 hue 作为无名称的向量提供时,multiple 参数被忽略的错误 (#2462)。

  • |修复|displot() 中,即使未分配 hue,默认的 alpha 值现在也会根据提供的 multiple 参数进行调整 (#2462)。

  • |修复|displot() 中,修复了一个导致在 common_bins=False 时二维直方图分面出错的错误 (#2640)。

  • |修复|rugplot() 中,修复了一个阻止使用 datetime 数据的错误 (#2458)。

  • |修复|relplot()displot() 中,修复了一个 bug,即返回的 FacetGrid 对象所附带的数据框会删除未在图中使用的列 (#2623)。

  • |修复|relplot() 中,修复了一个错误,当数据框中的某一列名与绘图变量之一同名时,会引发该错误 (#2581)。

  • |修复| 在关系图中,修复了一个错误,当 size_norm 超出数据范围时,size 语义的图例条目不正确 (#2580)。

  • |修复|lmplot()regplot() 中,修复了一个当 truncate=True 时 x 轴被限制在数据范围内的错误 (#2576)。

  • |修复|lmplot() 中,修复了一个 sharey=False 并不总是按预期工作的错误 (#2576)。

  • |修复|热图() 中,修复了一个垂直旋转的 y 轴刻度标签与其行不对齐的错误 (#2574)。

  • |修复| 修复了一个在使用 seaborn 时阻止 Python 在 -OO 模式下运行的问题 (#2473)。

  • |文档| 改进了与主题相关函数的API文档 (#2573)。

  • |文档| 为所有文档化类的方法添加了文档字符串页面 (#2644)。