bam-filtration
执行数据清理和删除操作。此技能获取原始 BAM 文件,通过主动移除人工产物创建新的"清洁"BAM 文件:线粒体读取、黑名单区域、PCR 重复序列和未映射读取。当您想要从数据集中"清理"、"过滤"或"移除不良读取"时使用此技能。这是峰 calling 之前的先决步骤。如果您只想查看统计信息而不修改文件,请勿使用此技能。
📖 中文导读:执行数据清理和删除操作。此技能获取原始 BAM 文件,通过主动移除人工产物创建新的"清洁"BAM 文件:线粒体读取、黑名单区域、PCR 重复序列和未映射读取。当您想要从数据集中"清理"、"过滤"或"移除不良读取"时使用此技能。这是峰 calling 之前的先决步骤。如果您只想查看统计信息而不修改文件,请勿使用此技能。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: BAM-filtration description: Performs data cleaning and removal operations. This skill takes a raw BAM and creates a new, "clean" BAM file by actively removing artifacts: mitochondrial reads, blacklisted regions, PCR duplicates, and unmapped reads. Use this skill to "clean," "filter," or "remove bad reads" from a dataset. This is a prerequisite step before peak calling. Do NOT use this skill if you only want to view statistics without modifying the file.
BAM Filtration for ChIP-seq / ATAC-seq
Overview
Main steps include:
- Check the availability of blacklist file in current directory. Always prompt user whether to filter blacklist if blacklist files are missing. if the user need to filter blacklist file, then prompt user for the path of blacklist file.
- Initialize the project directory and create the required directory.
- Refer to the Inputs & Outputs section to check inputs and build the output architecture. All the output file should located in
${proj_dir}in Step 0. - Discover input BAMs in the current directory (or those matching a target token), and only select BAMs that are already coordinate-sorted and contain read group (RG) information.
- Perform the filtration task with tools.
When to use this skill
- Use this skill to "clean," "filter," or "remove bad reads" from a dataset
- This is a prerequisite step before peak calling.
- Do NOT use this skill if you only want to view statistics without modifying the file.
Inputs & Outputs
Inputs
${sample}.bam # BAMs that are already coordinate-sorted and contain read group (RG) information
Outputs
all_bam_filtration/
filtered_bam/
${sample}.filtered.bam
${sample}.filtered.bam.bai
temp/
... # intermediate files
Decision Tree
Step 0: Initialize Project
Call:
mcp__project-init-tools__project_init
with:
sample: alltask: bam_filtration
The tool will:
- Create
${sample}_bam_filtrationdirectory. - Return the full path of the
${sample}_bam_filtrationdirectory, which will be used as${proj_dir}.
Step 1: Filter BAM files
Call:
- mcp__qc-tools__bam_artifacts
with:
bam_file: BAMs that are already coordinate-sorted and contain read group (RG) informationoutput_bam: ${proj_dir}/filtered_bam/${sample}.filtered.bamtemp_dir: ${proj_dir}/temp/blacklist_bed: Path of the blacklist file