ggstatsplot中统计结果提取的技术解析

背景介绍

ggstatsplot作为R语言中一个强大的统计可视化包，其独特之处在于能够直接在图形中展示统计检验结果。然而，在实际应用中，用户有时需要单独获取这些统计结果用于其他用途，而不是直接显示在图形上。本文将深入探讨如何有效提取ggstatsplot生成的统计信息。

核心功能解析

ggstatsplot提供了两种主要方式来获取统计结果：

1. extract_stats()函数：这是获取统计结果的主要接口，返回一个包含统计信息的列表对象。该列表通常包含两个部分：

   • subtitle_data：包含全局检验结果（如Kruskal-Wallis检验）
   • caption_data：包含成对比较结果

2. extract_subtitle()函数：专门用于提取图形副标题中的统计表达式。

关键注意事项

在实际使用中，有以下几点需要特别注意：

1. 结果可见性与计算的关系：当设置results.subtitle = FALSE时，不仅会隐藏统计结果，ggstatsplot实际上会跳过相关统计计算。这是出于性能考虑的设计选择。

2. 独立控制选项：results.subtitle和pairwise.comparisons参数是独立控制的。这意味着用户可以：

   • 显示全局检验但隐藏成对比较
   • 隐藏全局检验但显示成对比较
   • 同时显示或隐藏两者

3. 替代方案：当需要统计结果但不希望显示在图形中时，可以考虑使用statsExpressions包直接进行计算，这是ggstatsplot的统计计算后端。

实际应用建议

对于需要在报告中引用统计结果但不希望全部显示在图形中的场景，推荐以下工作流程：

1. 首先使用ggstatsplot生成完整图形并提取统计结果
2. 然后根据需要隐藏部分结果的显示
3. 最后将提取的统计结果用于报告中的文字描述部分

这种工作流既保证了统计计算的准确性，又提供了展示的灵活性。

总结

ggstatsplot提供了灵活的统计结果提取机制，理解其设计哲学和工作原理对于高效使用该包至关重要。通过合理利用extract_stats()函数和参数控制，用户可以实现统计计算与结果展示的精细控制，满足各种复杂的数据可视化需求。