云生信学生物信息学

featureCounts批量计数:分离注释、线程和存储读取瓶颈

作者:发布于 2026-11-20更新于 2026-11-15约 6 分钟阅读
featureCounts慢,先查注释与读取

featureCounts慢,先查注释与读取:确认参考注释与建库方向;固定fragment计数与BAM清单;核对样本列和summary;比较线程并检查存储等待
本文操作与检查路径示意。

featureCounts处理多个BAM变慢,应先核对注释和计数规则,再比较线程与存储读取。错误的染色体名称、链特异设置或配对参数,可能很快生成一张几乎没有有效计数的表;线程更多也修不好这些问题。下面以短读长双端RNA-seq、按基因汇总fragment为例,建立同输入的资源对照。

固定注释、样本与计数单位

BAM的比对参考与GTF必须对应同一基因组版本,并核对染色体名称。检查GTF中是否确有exon特征和gene_id属性,不能只根据扩展名判断。每个BAM对应哪个生物样本写入清单;同一样本多lane如何合并先按设计处理,不能把lane当作新的生物重复。

项目 本例含义 不能为提速随意改变
-t exon、-g gene_id 按基因汇总外显子区域 改变特征或聚合字段
-p –countReadPairs 双端数据按fragment计数 把read计数混成fragment
-s 按已验证建库方向填写 把未知链方向默认当0
多重比对、重叠等选项 保持项目既定规则 以额外过滤减少工作量

先用少量BAM建立固定命令

在已安装Subread featureCounts、samtools和GNU time的Linux环境执行。代码使用Bash数组,路径需替换。STRAND按实际文库填写0、1或2;示例不代替链方向验证。较新命令行中-p说明输入双端,若要数fragment,还需显式–countReadPairs,核对安装版帮助后再运行。

set -euo pipefail
: "${STRAND:?先确认文库链方向,填写0、1或2}"
[[ "$STRAND" =~ ^[012]$ ]] || exit 2
gtf=/project/reference/annotation.gtf
bams=(/project/bam/S01.bam /project/bam/S02.bam)
test -s "$gtf"
for bam in "${bams[@]}"; do
  test -s "$bam"
  samtools quickcheck -v "$bam"
done
mkdir counts-benchmark
featureCounts -v > counts-benchmark/version.txt 2>&1
for threads in 2 4; do
  out="counts-benchmark/t$threads"
  mkdir "$out"
  /usr/bin/time -v -o "$out/resources.txt" featureCounts \
    -T "$threads" -p --countReadPairs -s "$STRAND" \
    -t exon -g gene_id -a "$gtf" -o "$out/counts.txt" \
    "${bams[@]}" > "$out/stdout.log" 2> "$out/stderr.log"
  test -s "$out/counts.txt" && test -s "$out/counts.txt.summary" || exit 2
done

2和4是顺序运行的线程试验点,都需在获配范围内;已有counts-benchmark时停止,避免旧结果混入。quickcheck是BAM快速完整性检查,不遍历所有记录,也不验证比对质量。featureCounts可接收多份BAM,BAM索引不是这一命令的额外必需参数,不应看到慢就先反复重建索引。

先验收计数,再看时间

检查两轮counts.txt的样本列、Geneid、注释字段和计数是否对应同一输入;比较时排除版本或命令注释行,按Geneid匹配,不仅看文件hash。查看summary的Assigned及各类Unassigned,确认没有样本漏列或异常低分配。原始计数不是TPM,也不是差异分析结果。

大量Unassigned_NoFeatures时,先查参考名称、注释版本和所选特征;链方向、比对质量或重叠相关问题按日志与summary逐项解释。不能为了提高Assigned比例随意加入允许重叠或多重比对的选项。只有计数范围与结果通过,线程耗时对照才有意义。

定位读取瓶颈,再安排整批

保持所有计数设置一致,记录完整耗时、进程与任务组峰值、BAM所在存储和同时负载。更多线程没有提高吞吐且I/O等待增加时,先检查共享盘争用、输入是否反复跨网读取;必要时按获准方式复制到本地工作盘,并验证文件完整性,再单独测传输与计算。

坐标排序双端BAM可能涉及配对重排,按当前工具机制处理,不要为提速盲目关闭排序检查。多任务同时读取相同大文件,还可能挤占缓存和存储带宽;整批拆分须保持每个样本只进入一次,最终按同一Geneid集合关联,不能简单按行号拼接计数。

选定执行方案后,再用正式样本规模验证并发、工作盘和完成窗口。保存版本、输入清单、GTF校验、完整命令及summary。只有方法和读取路径合理后仍有明确资源缺口,才据这份记录调整CPU、存储或可用内存。

需要额外算力时

适用前提:排除注释和计数参数问题后,实测吞吐量达不到任务计划。如需额外资源,可评估按任务测算的CPU服务器租赁。咨询时说明软件版本、任务规模和使用期限,配置与支持范围另行确认。

咨询本任务的服务器配置

咨询本任务的服务器配置

留下手机号,我们会结合本文任务与您沟通服务器配置和报价。

也可联系云生信企业微信客服,说明本文任务。

参考与版本核对

按文中适用环境运行,所用版本与参数以实际安装环境和对应官方文档为准。

把知识用于当前任务

下一步可以直接开始分析

按研究目标查找在线工具、课程、计算资源或完整分析服务。

按目标找方案仍有疑问,联系客服 ↗