用途:对表格生存数据运行 Kaplan-Meier 分析并导出单个 PDF 生存图。输入需包含时间、状态和分组列,分组须为预计算的分类变量而非连续评分。
主要能力:命令行工作流,带参数校验;支持 logrank 或 wald 统计方法(wald 仅支持恰好 2 组);可自定义图形尺寸、字体、标题、图例、线型线宽、分组颜色、删失标记、置信区间、风险表等;输出 km-plot.pdf 与 session_info.txt。
用法:需 shell 中可用 Rscript,并安装 optparse、data.table、survival、survminer、ggplot2。主命令:Rscript scripts/main.R --input_file <input_file> --output_dir <output_dir> --time_col <time_column> --status_col <status_column> --risk_col <group_column>。默认列名为 futime、fustat、risk_group,默认输出目录 ./KM_Results。
限制:status 须为 0 删失、1 事件;time 须为非负有限数值;缺失行会被剔除,过滤后至少保留 2 条完整观测且至少 2 组;近似唯一或连续型分组列会被拒绝。--auto_convert_days 为启发式转换,仅当 max(time)>365 时按天处理,源数据已是年或月时应设为 false。该技能不用于推导截断值或拆分连续评分,不提供多变量 Cox 回归、协变量调整或更广泛的生存分析流程,也不生成多图或报告。重复运行分析结果一致,但 PDF 可能非字节级相同。