idxstats component

CHANGELOG.md

@@ -35,6 +35,9 @@
     - `salmon/salmon_index`: Create a salmon index for the transcriptome to use Salmon in the mapping-based mode (PR #24).
     - `salmon/salmon_quant`: Transcript quantification from RNA-seq data (PR #24).
 
+* `samtools`:
+    - `samtools/idxstats`: Reports alignment summary statistics for a SAM/BAM/CRAM file (PR #32).
+
 ## MAJOR CHANGES
 
 ## MINOR CHANGES

src/samtools/idxstats/config.vsh.yaml

@@ -0,0 +1,52 @@
+name: samtools_idxstats
+namespace: samtools
+description: Reports alignment summary statistics for a BAM file
+keywords: [stats, mapping, counts, chromosome, bam, sam, cram]
+links:
+  homepage: https://www.htslib.org/
+  documentation: https://www.htslib.org/doc/samtools-idxstats.html
+  repository: https://github.com/samtools/samtools.git
+references: 
+  doi: 10.1093/bioinformatics/btp352, 10.1093/gigascience/giab008
+license: MIT/Expat
+
+argument_groups:
+  - name: Inputs
+    arguments:
+      - name: "--bam"
+        type: file
+        description: BAM input file.
+      - name: "--bai"
+        type: file
+        description: BAM index file.
+      - name: "--fasta"
+        type: file
+        description: Reference file the CRAM was created with (optional).
+  - name: Outputs
+    arguments:
+      - name: "--output"
+        type: file
+        description: |
+          File containing samtools stats output in tab-delimited format.
+        required: true
+        must_exist: false
+        example: output.idxstats
+
+resources:
+  - type: bash_script
+    path: script.sh
+test_resources:
+  - type: bash_script
+    path: test.sh
+  - type: file
+    path: test_data
+engines:
+  - type: docker
+    image: quay.io/biocontainers/samtools:1.3.1--h9071d68_10
+    setup:
+      - type: docker
+        run: |
+          echo "$(samtools --version 2>&1)" > /var/software_versions.txt
+runners:
+- type: executable
+- type: nextflow

src/samtools/idxstats/help.txt

@@ -0,0 +1,5 @@
+```
+samtools idxstats
+```
+
+Usage: samtools idxstats <in.bam>

src/samtools/idxstats/script.sh

@@ -0,0 +1,8 @@
+#!/bin/bash
+
+## VIASH START
+## VIASH END
+
+set -e
+
+samtools idxstats "$par_bam" > "$par_output"

src/samtools/idxstats/test.sh

@@ -0,0 +1,51 @@
+#!/bin/bash
+
+test_dir="${meta_resources_dir}test_data"
+echo ">>> Testing $meta_functionality_name"
+
+"$meta_executable" \
+  --bam "$test_dir/a.sorted.bam" \
+  --bai "$test_dir/a.sorted.bam.bai" \
+  --output "$test_dir/a.sorted.idxstats"
+
+echo "$test_dir/a.sorted.idxstats"
+
+echo ">>> Checking whether output exists"
+[ ! -f "$test_dir/a.sorted.idxstats" ] && echo "File 'a.sorted.idxstats' does not exist!" && exit 1
+
+echo ">>> Checking whether output is non-empty"
+[ ! -s "$test_dir/a.sorted.idxstats" ] && echo "File 'a.sorted.idxstats' is empty!" && exit 1
+
+echo ">>> Checking whether output is correct"
+diff "$test_dir/a.sorted.idxstats" "$test_dir/a_ref.sorted.idxstats" || \
+    (echo "Output file a.sorted.idxstats does not match expected output" && exit 1)
+
+rm "$test_dir/a.sorted.idxstats"
+
+############################################################################################
+
+echo ">>> Testing $meta_functionality_name with singletons in the input"
+
+"$meta_executable" \
+  --bam "$test_dir/test.paired_end.sorted.bam" \
+  --bai "$test_dir/test.paired_end.sorted.bam.bai" \
+  --output "$test_dir/test.paired_end.sorted.idxstats"
+
+echo ">>> Checking whether output exists"
+[ ! -f "$test_dir/test.paired_end.sorted.idxstats" ] && \
+    echo "File 'test.paired_end.sorted.idxstats' does not exist!" && exit 1
+
+echo ">>> Checking whether output is non-empty"
+[ ! -s "$test_dir/test.paired_end.sorted.idxstats" ] && \
+    echo "File 'test.paired_end.sorted.idxstats' is empty!" && exit 1
+
+echo ">>> Checking whether output is correct"
+diff "$test_dir/test.paired_end.sorted.idxstats" "$test_dir/test_ref.paired_end.sorted.idxstats" || \
+    (echo "Output file test.paired_end.sorted.idxstats does not match expected output" && exit 1)
+
+rm "$test_dir/test.paired_end.sorted.idxstats"
+
+############################################################################################
+
+echo "All tests succeeded!"
+exit 0

src/samtools/idxstats/test_data/a_ref.sorted.idxstats

@@ -0,0 +1,2 @@
+xx	20	6	0
+*	0	0	0

src/samtools/idxstats/test_data/script.sh

@@ -0,0 +1,14 @@
+#!/bin/bash
+
+# dowload test data from snakemake wrapper
+if [ ! -d /tmp/idxstats_source ]; then
+  git clone --depth 1 --single-branch --branch master https://github.com/snakemake/snakemake-wrappers.git /tmp/idxstats_source
+fi
+
+cp -r /tmp/idxstats_source/bio/samtools/idxstats/test/mapped/* src/samtools/idxstats/test_data
+# samtools idxstats a.sorted.bam > a.sorted.idxstats
+
+# dowload test data from nf-core module
+wget https://github.com/nf-core/test-datasets/raw/modules/data/genomics/sarscov2/illumina/bam/test.paired_end.sorted.bam
+wget https://github.com/nf-core/test-datasets/raw/modules/data/genomics/sarscov2/illumina/bam/test.paired_end.sorted.bam.bai
+# samtools idxstats test.paired_end.sorted.bam > test_ref.paired_end.sorted.idxstats

src/samtools/idxstats/test_data/test_ref.paired_end.sorted.idxstats

@@ -0,0 +1,2 @@
+MT192765.1	29829	197	3
+*	0	0	0