元分析森林图生成器

为系统综述和元分析创建可发表级别的森林图，支持自定义样式和统计注释。

快速开始

python
from scripts.forest_plotter import ForestPlotter

plotter = ForestPlotter()

生成森林图

核心功能

1. 基础森林图

python
fig = plotter.plot(
data=studies_df,
effect_col=HR,
cilowercol=CI_lower,
ciuppercol=CI_upper,
studycol=studyname
)

必需数据列：

• - 研究名称/标识符
• 效应量（OR、HR、RR、MD等）
• 置信区间下限
• 置信区间上限
• 权重（可选，用于精确度）

2. 统计注释

python
fig = plotter.plotwithstats(
data,
heterogeneity_stats={
I2: 45.2,
p_value: 0.03,
Q_statistic: 18.4
},
overall_effect={
estimate: 1.15,
ci: [0.98, 1.35],
p_value: 0.08
}
)

异质性指标：

3. 亚组分析

python
fig = plotter.subgroup_plot(
data,
subgroupcol=treatmenttype,
subgroups=[手术, 放疗, 联合治疗]
)

4. 自定义样式

python
fig = plotter.plot(
data,
style=publication,
journal=lancet, # 或 nejm, jama, nature
color_scheme=monochrome,
show_weights=True
)

命令行使用

bash

从CSV数据生成

使用自定义样式

输出格式

• - PDF：出版级质量，矢量图形
• PNG：网页/演示用途，300 DPI
• SVG：可在Illustrator/Inkscape中编辑
• TIFF：期刊投稿格式

参考资料

• - references/forest-plot-styles.md - 期刊特定格式
• examples/sample-plots/ - 示例输出