用途:该技能用于在本地环境中生成包含分析摘要、格式化表格和嵌入可视化的专业 PDF 报告,适合导出分析报告、带图表的结果汇总、格式化文档以及可发表级补充材料,也可将多项分析结果合并为单一文档。
主要能力:通过 reportlab 的 platypus 构建文档,支持标题、段落、分节、表格(自定义样式、颜色、网格、对齐)、图片嵌入(先保存 matplotlib 图再插入)、日期文本,并可实现页眉页脚、双栏布局、按条件高亮表格行等。文档可选 letter 或 A4 页面。
使用方式:导入 reportlab 相关模块与 matplotlib、pandas;用 SimpleDocTemplate 创建文档,建立 story 列表,依次追加 Paragraph、Spacer、Table、Image 等元素,最后用 doc.build(story) 输出。图片需先保存为 PNG 再以 Image 插入,可指定宽高与 DPI(建议 150-300)。页眉页脚可通过 onFirstPage/onLaterPages 回调实现。
适用场景:单细胞 RNA-seq 等分析报告、QC 指标报告、DEG 汇总表、UMAP 等可视化嵌入、多结果合并文档。
限制与注意:依赖 reportlab,缺失时需安装(pip install reportlab);图片路径需存在,否则报错;表格列数建议 4-6 列,超宽需缩窄列宽或减小字号;临时图片文件应在生成后清理;大文档宜分段构建以控制内存。文本型 PDF 通常小于 1MB,图片较多时可达 5-20MB,报告生成一般 1-3 秒。参考资料仅提供 reportlab 官方文档与 platypus 指南链接,未提供具体收费、平台或效果承诺信息。