statannotations vs statannot：新一代统计标注库的优势与迁移指南

statannotations vs statannot：新一代统计标注库的优势与迁移指南

【免费下载链接】statannotationsadd statistical significance annotations on seaborn plots. Further development of statannot, with bugfixes, new features, and a different API.项目地址: https://gitcode.com/gh_mirrors/st/statannotations

statannotations是statannot的进阶版本，作为一款强大的统计显著性标注工具，它能在seaborn图表上轻松添加统计显著性标注，为数据可视化分析提供了极大便利。相比statannot，statannotations带来了诸多改进，包括全新的API设计、更多实用功能以及重要的bug修复，让用户的使用体验得到显著提升。

🚀 statannotations的核心优势

更强大的兼容性支持

statannotations紧跟主流数据科学库的更新步伐，已实现与pandas v2+和seaborn v0.12+的完美兼容[CHANGELOG.md]。这意味着用户可以放心使用最新版本的数据分析工具，而不必担心因版本不兼容导致的问题。

全新的Annotator类设计

statannotations进行了重大重构，引入了Annotator类，将准备和添加标注的操作拆分为独立的方法调用[CHANGELOG.md]。这种设计不仅降低了代码复杂度，使其更符合SOLID原则，还为用户提供了更灵活、更直观的操作方式。

丰富的功能扩展

statannotations在statannot的基础上新增了多项实用功能：

• 支持小提琴图（violinplot）的统计标注[CHANGELOG.md]
• 可选择跳过非显著性结果的标注[CHANGELOG.md]
• 提供修改标注间距的选项[CHANGELOG.md]
• 支持水平方向的图表标注[CHANGELOG.md]
• 增加了scipy的Brunner-Munzel检验[CHANGELOG.md]

重要的bug修复

statannotations解决了statannot存在的多个关键问题：

• 修复了非字符串组标签的标注问题[CHANGELOG.md]
• 解决了应用多重比较校正后非显著性测试结果的渲染问题[CHANGELOG.md]
• 修复了标注图例显示错误（通常是NS范围）[CHANGELOG.md]
• 修正了计算xunits时的错误，该错误曾导致错误的y位置计算[CHANGELOG.md]

📊 可视化效果对比

statannotations提供了更丰富的可视化选项，让统计标注更加清晰、美观。以下是一些示例：

使用statannotations进行多组比较的统计标注效果，清晰展示不同组别间的显著性差异

statannotations支持在分面图上添加统计标注，满足复杂数据分析需求

通过statannotations可以轻松实现自定义文本标注，让图表信息更丰富

🔄 从statannot迁移到statannotations的指南

安装statannotations

首先，你需要安装statannotations。可以通过以下命令从GitCode仓库克隆并安装：

git clone https://gitcode.com/gh_mirrors/st/statannotations cd statannotations pip install .

API变化与调整

statannotations引入了Annotator类，替代了statannot中的函数式调用。以下是一个简单的迁移示例：

在statannot中，你可能会这样使用：

add_stat_annotation(ax, data, x, y, ...)

而在statannotations中，相应的代码变为：

from statannotations.Annotator import Annotator annotator = Annotator(ax, data, x, y, ...) annotator.configure(test='t-test_ind') annotator.apply_and_annotate()

处理常见迁移问题

统计测试函数的变化

statannotations实现了StatTest类，移除了stat_func参数和test_long_name[CHANGELOG.md]。如果你在statannot中使用了自定义的统计函数，需要相应地调整为StatTest类的实现方式。

坐标系统的变化

statannotations中的标注y位置基于绘图坐标而非数据坐标[CHANGELOG.md]。这可能会影响你的标注位置设置，需要根据新的坐标系统进行调整。

多重比较校正的默认行为

在statannotations中，多重比较校正默认设置为None，因为statsmodels是一个额外的依赖项[CHANGELOG.md]。如果你的代码依赖于默认的校正行为，需要显式设置校正方法。

📚 学习资源与文档

要深入了解statannotations的更多功能和使用方法，可以参考以下资源：

• 官方文档：docs/source/index.rst
• 示例代码：usage/example.ipynb
• 测试脚本：usage/test_script.py

🌟 总结

statannotations作为statannot的新一代继任者，通过全新的API设计、丰富的功能扩展和重要的bug修复，为用户提供了更强大、更灵活的统计标注解决方案。无论你是数据科学家、研究人员还是学生，statannotations都能帮助你更轻松地在seaborn图表上添加专业的统计显著性标注，让你的数据可视化分析更加出色。

现在就开始使用statannotations，体验新一代统计标注库带来的便利与强大功能吧！

【免费下载链接】statannotationsadd statistical significance annotations on seaborn plots. Further development of statannot, with bugfixes, new features, and a different API.项目地址: https://gitcode.com/gh_mirrors/st/statannotations