plotnine 是 Python 的数据可视化库，基于图形语法（grammar of graphics），语法与 R 的 ggplot2 几乎一致。它采用声明式写法：描述想要什么，而不是如何绘制；通过 + 逐层叠加组件来构建图形。适合需要静态、出版级图表的场景，例如印刷或报告配图；资料建议在需要静态输出时优先于 plotly。
主要能力：几何对象（geom_point 散点、geom_line 折线、geom_bar 计数柱、geom_col 数值柱、geom_histogram 直方图、geom_boxplot 箱线图、geom_smooth 趋势线等）；美学映射（x、y 位置，color 点线颜色，fill 填充色，size 大小，shape 形状，alpha 透明度）；标度与坐标系（坐标轴范围与标签、颜色调色板、坐标控制）；分面（多面板图）；主题与标题标签等外观定制。
基本用法：从 plotnine 导入 ggplot、aes、geom_point 等组件，用 ggplot(df, aes(x="col_x", y="col_y")) + geom_point() 构建图形；可用 from plotnine import * 导入全部组件，from plotnine.data import mtcars 使用内置数据集。保存用 p.save("plot.png", width=10, height=8, dpi=300)。
在研究工作流中，资料强调文件优先执行：可视化应写入 scripts/stage8_analysis/{step}_{plot-name}.py 脚本，通过 Bash 配合自动输出捕获包装脚本执行，而非交互式生成，以保证可审计与可复现；失败时创建带版本号的副本修复。
限制与注意：资料未提供安装命令、收费与价格信息；常见问题包括图形不显示、列名未找到、颜色未生效、意外分组和语法错误，可参考对应参考文件排查。作为主要分析工具使用时，报告软件与工具部分建议引用 Kibirige, H. et al. plotnine: Grammar of graphics for Python, https://plotnine.org/；仅用于未纳入交付物的快速探索性绘图时不必引用。