用途:当需要在 Kaplan-Meier 生存曲线下方添加 "Number at risk" 表、生成符合临床肿瘤学期刊(如 NEJM、Lancet、JCO)要求的生存图,或在投稿前统一图表格式时使用。
主要能力:根据生存数据自动计算各时间点的风险人数,支持右删失数据处理与删失计数;提供 NEJM、Lancet、JCO 及自定义期刊模板;时间轴与曲线 X 轴精确对齐,支持横向/纵向布局与响应式排版;可生成独立风险表或曲线与风险表组合图,输出 PNG/JPEG、PDF、SVG 等格式。时间点支持自动、固定间隔与自定义选择。
使用方式:依赖 Python 3.10+ 及 lifelines、matplotlib、numpy、pandas、Pillow 等库(见 requirements.txt)。安装依赖:pip install -r requirements.txt。打包入口为 scripts/main.py,可先运行 python -m py_compile scripts/main.py 校验,再用 python scripts/main.py --help 查看参数。常用参数包括 --input、--time-col、--event-col、--group-col、--style、--time-points、--combine、--km-plot、--output、--output-dir、--format、--dpi 等。输入数据需含时间列与事件列(0=删失,1=事件),分组列可选;支持 CSV、Excel、SAS、RData、pickle 等格式。
适用场景:临床试验报告风险表、医学论文图表规范化、多组生存分析图表批量生成。
限制:自动化计算需人工抽查核对;默认最多支持 6 组,超限自动分页或缩小字体;具体性能与边界处理资料暂未提供;当前生命周期状态为 Draft。