annotate bamcount.xml @ 1:78bca99736b0 draft default tip

Uploaded
author chrisw
date Tue, 19 Nov 2019 02:59:07 +0000
parents 1f0e3aaaba19
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
1
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
1 <tool id="bamcount" name="Summarize coverage from a BAM (bamcount)" version="0.2.0">
0
1f0e3aaaba19 Uploaded
chrisw
parents:
diff changeset
2 <requirements>
1
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
3 <requirement type="package" version="0.4.0">bamcount</requirement>
0
1f0e3aaaba19 Uploaded
chrisw
parents:
diff changeset
4 </requirements>
1f0e3aaaba19 Uploaded
chrisw
parents:
diff changeset
5 <command detect_errors="exit_code"><![CDATA[
1
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
6 bamcount "$input1" --threads $threads --coverage --no-head --min-unique-qual $min_uniq_qual --frag-dist bc --bigwig bc --auc bc --alts bc --junctions bc
0
1f0e3aaaba19 Uploaded
chrisw
parents:
diff changeset
7 ]]></command>
1f0e3aaaba19 Uploaded
chrisw
parents:
diff changeset
8 <inputs>
1
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
9 <param type="integer" name="threads" value="1" />
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
10 <param type="integer" name="min_uniq_qual" value="10" />
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
11 <param type="file" name="input1" format="bam" />
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
12 <param type="file" name="annotation" format="bed" />
0
1f0e3aaaba19 Uploaded
chrisw
parents:
diff changeset
13 </inputs>
1f0e3aaaba19 Uploaded
chrisw
parents:
diff changeset
14 <outputs>
1
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
15 <data name="output1" format="txt" from_work_dir="bc.auc.tsv" />
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
16 <data name="output2" format="txt" from_work_dir="bc.alts.tsv" />
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
17 <data name="output3" format="txt" from_work_dir="bc.frags.tsv" />
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
18 <data name="output4" format="txt" from_work_dir="bc.jxs.tsv" />
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
19 <!--
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
20 <data name="output5" format="bed" from_work_dir="bc.all.tsv" />
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
21 <data name="output6" format="bed" from_work_dir="bc.unique.tsv" />
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
22 -->
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
23 <data name="output7" format="bigwig" from_work_dir="bc.all.bw" />
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
24 <data name="output8" format="bigwig" from_work_dir="bc.unique.bw" />
0
1f0e3aaaba19 Uploaded
chrisw
parents:
diff changeset
25 </outputs>
1f0e3aaaba19 Uploaded
chrisw
parents:
diff changeset
26 <tests>
1f0e3aaaba19 Uploaded
chrisw
parents:
diff changeset
27 <test>
1f0e3aaaba19 Uploaded
chrisw
parents:
diff changeset
28 <param name="input1" value="test.bam"/>
1
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
29 <output name="output1" file="test.auc.tsv"/>
0
1f0e3aaaba19 Uploaded
chrisw
parents:
diff changeset
30 </test>
1f0e3aaaba19 Uploaded
chrisw
parents:
diff changeset
31 </tests>
1f0e3aaaba19 Uploaded
chrisw
parents:
diff changeset
32 <help><![CDATA[
1
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
33 bamcount 0.4.0
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
34
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
35 BAM and BigWig utility.
0
1f0e3aaaba19 Uploaded
chrisw
parents:
diff changeset
36
1
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
37 Usage:
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
38 bamcount <bam> [options]
0
1f0e3aaaba19 Uploaded
chrisw
parents:
diff changeset
39
1
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
40 Options:
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
41 -h --help Show this screen.
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
42 --version Show version.
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
43 --threads # of threads to do BAM decompression
0
1f0e3aaaba19 Uploaded
chrisw
parents:
diff changeset
44
1
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
45 Extract basic junction information from the BAM, including co-occurrence
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
46 --junctions <prefix> Extract jx coordinates, strand, and anchor length, per read
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
47 Writes to a TSV file <prefix>.jxs.tsv
0
1f0e3aaaba19 Uploaded
chrisw
parents:
diff changeset
48
1
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
49 Extract reads from BAM into FASTQ (exclusive of all other modes):
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
50 --bam2fastq <prefix> Extract all reads from the passed in BAM and output as FASTQs
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
51 Uses prefix to name the fastq(s)
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
52 --filter-out SAM bit flags to filter out
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
53 --filter-in SAM bit flags to filter in
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
54 --re-reverse If read is reversed in alignment, re-reverse it in output
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
55 --one-file If you know file is not paired or just want all reads in one file
0
1f0e3aaaba19 Uploaded
chrisw
parents:
diff changeset
56
1
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
57 Non-reference summaries:
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
58 --alts <prefix> Print differing from ref per-base coverages
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
59 Writes to a CSV file <prefix>.alts.tsv
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
60 --include-softclip <prefix> Print a record to the alts CSV for soft-clipped bases
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
61 Writes total counts to a separate TSV file <prefix>.softclip.tsv
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
62 --only-polya If --include-softclip, only print softclips which are mostly A's or T's
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
63 --include-n Print mismatch records when mismatched read base is N
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
64 --print-qual Print quality values for mismatched bases
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
65 --delta Print POS field as +/- delta from previous
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
66 --require-mdz Quit with error unless MD:Z field exists everywhere it's
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
67 expected
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
68 --no-head Don't print sequence names and lengths in header
0
1f0e3aaaba19 Uploaded
chrisw
parents:
diff changeset
69
1
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
70 Coverage and quantification:
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
71 --coverage Print per-base coverage (slow but totally worth it)
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
72 --auc <prefix> Print per-base area-under-coverage, will generate it for the genome
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
73 and for the annotation if --annotation is also passed in
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
74 Writes to a TSV file <prefix>.auc.tsv
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
75 --bigwig <prefix> Output coverage as BigWig file(s). Writes to <prefix>.all.bw
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
76 (also <prefix>.unique.bw when --min-unique-qual is specified).
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
77 Requires libBigWig.
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
78 --annotation <bed> <prefix>
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
79 Path to BED file containing list of regions to sum coverage over
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
80 (tab-delimited: chrm,start,end)
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
81 --keep-bam-order Output annotation coverage in the order chromosomes appear in the BAM file.
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
82 The default is to output annotation coverage in the order chromosomes appear in the BED file.
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
83 --min-unique-qual <int>
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
84 Output second bigWig consisting built only from alignments
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
85 with at least this mapping quality. --bigwig must be specified.
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
86 Also produces second set of annotation sums based on this coverage
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
87 if --annotation is enabled
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
88 --double-count Allow overlapping ends of PE read to count twice toward
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
89 coverage
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
90 --num-bases Report total sum of bases in alignments processed (that pass filters)
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
91
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
92 Other outputs:
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
93 --read-ends Print counts of read starts/ends, if --min-unique-qual is set
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
94 then only the alignments that pass that filter will be counted here
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
95 Writes to 2 TSV files: <prefix>.starts.tsv, <prefix>.ends.tsv
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
96 --frag-dist <prefix> Print fragment length distribution across the genome
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
97 Writes to a TSV file <prefix>.frags.tsv
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
98 --echo-sam Print a SAM record for each aligned read
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
99 --ends Report end coordinate for each read (useful for debugging)
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
100 --test-polya Lower Poly-A filter minimums for testing (only useful for debugging/testing)
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
101 ]]></help>
0
1f0e3aaaba19 Uploaded
chrisw
parents:
diff changeset
102 <citations>
1f0e3aaaba19 Uploaded
chrisw
parents:
diff changeset
103 <citation type="bibtex">
1
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
104 @misc{githubbamcount,
0
1f0e3aaaba19 Uploaded
chrisw
parents:
diff changeset
105 author = {Wilks, Christopher},
1f0e3aaaba19 Uploaded
chrisw
parents:
diff changeset
106 year = {2019},
1f0e3aaaba19 Uploaded
chrisw
parents:
diff changeset
107 title = {bamcount},
1f0e3aaaba19 Uploaded
chrisw
parents:
diff changeset
108 publisher = {GitHub},
1f0e3aaaba19 Uploaded
chrisw
parents:
diff changeset
109 journal = {GitHub repository},
1
78bca99736b0 Uploaded
chrisw
parents: 0
diff changeset
110 url = {https://github.com/ChristopherWilks/bamcount},
0
1f0e3aaaba19 Uploaded
chrisw
parents:
diff changeset
111 }</citation>
1f0e3aaaba19 Uploaded
chrisw
parents:
diff changeset
112 </citations>
1f0e3aaaba19 Uploaded
chrisw
parents:
diff changeset
113 </tool>