volcano-plot-labeler

用途：为火山图自动标注最显著基因。主要能力：按 |log2FC|*-log10(pvalue) 排序选出前 N（默认 10）个基因；用力导向斥力算法分散标签，绘制引导线防止重叠；可配置 p 值/倍数变化阈值、标签样式、图形尺寸，输出 PNG、PDF、SVG。用法：安装 pip install pandas matplotlib numpy scipy，或 pip install -r requirements.txt；调用 label_volcano_plot(df, log2fc_col='log2FoldChange', pvalue_col='padj', gene_col='gene_name', top_n=10)，保存图 fig.savefig('volcano_plot_labeled.png', dpi=300, bbox_inches='tight')；也可命令行 python scripts/main.py --input data/deseq2_results.csv --output volcano_labeled.png --log2fc-col log2FoldChange --pvalue-col padj --gene-col gene_name --top-n 10。验证：python -m py_compile scripts/main.py，python scripts/main.py --help。输入 CSV/TSV 需含 log2FoldChange、padj/pvalue、gene_name 列。适用场景：差异表达结果的火山图标注与审阅。限制：资料未提供实际性能、准确率与收费信息；当前为 Draft 阶段；缺输入需提澄清，执行失败或无依赖时有回退说明。