annotate summarize_unique_barcodes.xml @ 18:c139b9abe064 draft

Changed env parameter in summarize_unique_barcodes.xml
author nikos
date Wed, 11 Feb 2015 07:32:32 -0500
parents 31f25b37187b
children ceb96c265bd1
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
17
31f25b37187b Uploaded
nikos
parents:
diff changeset
1 <tool id="rna_probing_summarize" version="1.0.0" name="Summarize Unique Barcodes" force_history_refresh="True">
31f25b37187b Uploaded
nikos
parents:
diff changeset
2 <description></description>
31f25b37187b Uploaded
nikos
parents:
diff changeset
3
31f25b37187b Uploaded
nikos
parents:
diff changeset
4 <requirements>
31f25b37187b Uploaded
nikos
parents:
diff changeset
5 <requirement type="package" version="4.1.0">gnu_awk</requirement>
31f25b37187b Uploaded
nikos
parents:
diff changeset
6 <requirement type="package" version="0.1.19">samtools</requirement>
31f25b37187b Uploaded
nikos
parents:
diff changeset
7 <requirement type="package" version="3.1.1">R_3_1_1</requirement>
31f25b37187b Uploaded
nikos
parents:
diff changeset
8 <requirement type="R-module">RNAprobR</requirement>
31f25b37187b Uploaded
nikos
parents:
diff changeset
9 <requirement type="package" version="1.0.0">RNAprobR</requirement>
31f25b37187b Uploaded
nikos
parents:
diff changeset
10 <requirement type="set_environment">RNA_PROBING_SCRIPT_PATH</requirement>
18
c139b9abe064 Changed env parameter in summarize_unique_barcodes.xml
nikos
parents: 17
diff changeset
11 <requirement type="set_environment">RNAprobR_PATH</requirement>
c139b9abe064 Changed env parameter in summarize_unique_barcodes.xml
nikos
parents: 17
diff changeset
12
17
31f25b37187b Uploaded
nikos
parents:
diff changeset
13 </requirements>
31f25b37187b Uploaded
nikos
parents:
diff changeset
14
31f25b37187b Uploaded
nikos
parents:
diff changeset
15 <command interpreter="bash">
31f25b37187b Uploaded
nikos
parents:
diff changeset
16 summarize_unique_barcodes.sh
31f25b37187b Uploaded
nikos
parents:
diff changeset
17
31f25b37187b Uploaded
nikos
parents:
diff changeset
18 ## Inputs
31f25b37187b Uploaded
nikos
parents:
diff changeset
19 -f $input1 -b $input2
31f25b37187b Uploaded
nikos
parents:
diff changeset
20
31f25b37187b Uploaded
nikos
parents:
diff changeset
21 ##
31f25b37187b Uploaded
nikos
parents:
diff changeset
22
31f25b37187b Uploaded
nikos
parents:
diff changeset
23 #if str( $k2n ) == 'True':
31f25b37187b Uploaded
nikos
parents:
diff changeset
24 -k
31f25b37187b Uploaded
nikos
parents:
diff changeset
25 #end if
31f25b37187b Uploaded
nikos
parents:
diff changeset
26
31f25b37187b Uploaded
nikos
parents:
diff changeset
27 #if str( $priming.flag ) == 'True':
31f25b37187b Uploaded
nikos
parents:
diff changeset
28 -p $priming.position
31f25b37187b Uploaded
nikos
parents:
diff changeset
29 #end if
31f25b37187b Uploaded
nikos
parents:
diff changeset
30
31f25b37187b Uploaded
nikos
parents:
diff changeset
31 #if str( $trimming ) == 'True':
31f25b37187b Uploaded
nikos
parents:
diff changeset
32 -t
31f25b37187b Uploaded
nikos
parents:
diff changeset
33 #end if
31f25b37187b Uploaded
nikos
parents:
diff changeset
34
18
c139b9abe064 Changed env parameter in summarize_unique_barcodes.xml
nikos
parents: 17
diff changeset
35 -r \$RNAprobR_PATH
17
31f25b37187b Uploaded
nikos
parents:
diff changeset
36 </command>
31f25b37187b Uploaded
nikos
parents:
diff changeset
37
31f25b37187b Uploaded
nikos
parents:
diff changeset
38 <!-- basic error handling -->
31f25b37187b Uploaded
nikos
parents:
diff changeset
39 <stdio>
31f25b37187b Uploaded
nikos
parents:
diff changeset
40 <regex match="Error" level="fatal" description="" />
31f25b37187b Uploaded
nikos
parents:
diff changeset
41 </stdio>
31f25b37187b Uploaded
nikos
parents:
diff changeset
42
31f25b37187b Uploaded
nikos
parents:
diff changeset
43 <inputs>
31f25b37187b Uploaded
nikos
parents:
diff changeset
44 <param format="bam" name="input1" type="data" label="Aligned Reads" help="BAM format." />
31f25b37187b Uploaded
nikos
parents:
diff changeset
45 <param format="tabular" name="input2" type="data" optional="True" label="Barcodes" help="Produced by Debarcoding tool." />
31f25b37187b Uploaded
nikos
parents:
diff changeset
46 <param name="k2n" type="boolean" checked="False" truevalue="True" falsevalue="False" label="Produce k2n file" help="Check the box if you ran the tool and received a warning message to produce the k2n file. Necessary if you want to use 'HRF-Seq' method in 'Normalize' tool. Warning: Can be very slow!" />
31f25b37187b Uploaded
nikos
parents:
diff changeset
47 <param name="trimming" type="boolean" checked="True" truevalue="True" falsevalue="False" label="Trim untemplated nucleotides" help="" />
31f25b37187b Uploaded
nikos
parents:
diff changeset
48 <conditional name="priming">
31f25b37187b Uploaded
nikos
parents:
diff changeset
49 <param name="flag" type="select" label="Set priming position" help="Set the priming position manually.">
31f25b37187b Uploaded
nikos
parents:
diff changeset
50 <option value="False">No</option>
31f25b37187b Uploaded
nikos
parents:
diff changeset
51 <option value="True">Yes</option>
31f25b37187b Uploaded
nikos
parents:
diff changeset
52 </param>
31f25b37187b Uploaded
nikos
parents:
diff changeset
53 <when value="True">
31f25b37187b Uploaded
nikos
parents:
diff changeset
54 <param name="position" type="integer" value="0" min="0" label="Priming position" />
31f25b37187b Uploaded
nikos
parents:
diff changeset
55 </when>
31f25b37187b Uploaded
nikos
parents:
diff changeset
56 <when value="False" />
31f25b37187b Uploaded
nikos
parents:
diff changeset
57 </conditional>
31f25b37187b Uploaded
nikos
parents:
diff changeset
58 </inputs>
31f25b37187b Uploaded
nikos
parents:
diff changeset
59
31f25b37187b Uploaded
nikos
parents:
diff changeset
60 <outputs>
31f25b37187b Uploaded
nikos
parents:
diff changeset
61 <data format="tabular" name="trimming_stats" label="${tool.name} on ${on_string}: Trimming stats" from_work_dir="output_dir/trimming_stats.txt">
31f25b37187b Uploaded
nikos
parents:
diff changeset
62 <filter>trimming is True</filter>
31f25b37187b Uploaded
nikos
parents:
diff changeset
63 </data>
31f25b37187b Uploaded
nikos
parents:
diff changeset
64 <data format="tabular" name="unique_barcodes" label="${tool.name} on ${on_string}: Unique Barcodes" from_work_dir="output_dir/unique_barcodes.txt">
31f25b37187b Uploaded
nikos
parents:
diff changeset
65 <filter> input2 != None </filter>
31f25b37187b Uploaded
nikos
parents:
diff changeset
66 </data>
31f25b37187b Uploaded
nikos
parents:
diff changeset
67 <data format="tabular" name="read_counts" label="${tool.name} on ${on_string}: Read Counts" from_work_dir="output_dir/read_counts.txt" />
31f25b37187b Uploaded
nikos
parents:
diff changeset
68 <data format="txt" name="k2n_file" label="${tool.name} on ${on_string}: k2n file" from_work_dir="output_dir/k2n.txt">
31f25b37187b Uploaded
nikos
parents:
diff changeset
69 <filter> k2n is True </filter>
31f25b37187b Uploaded
nikos
parents:
diff changeset
70 </data>
31f25b37187b Uploaded
nikos
parents:
diff changeset
71 </outputs>
31f25b37187b Uploaded
nikos
parents:
diff changeset
72
31f25b37187b Uploaded
nikos
parents:
diff changeset
73 <tests>
31f25b37187b Uploaded
nikos
parents:
diff changeset
74 <test>
31f25b37187b Uploaded
nikos
parents:
diff changeset
75 <param name="input1" value="aligned.bam" />
31f25b37187b Uploaded
nikos
parents:
diff changeset
76 <param name="input2" value="barcodes.txt" />
31f25b37187b Uploaded
nikos
parents:
diff changeset
77 <param name="k2n" value="True" />
31f25b37187b Uploaded
nikos
parents:
diff changeset
78 <param name="trimming" value="True" />
31f25b37187b Uploaded
nikos
parents:
diff changeset
79 <output name="trimming_stats" file="trimming_stats.txt" />
31f25b37187b Uploaded
nikos
parents:
diff changeset
80 <output name="unique_barcodes" file="unique_barcodes.txt" />
31f25b37187b Uploaded
nikos
parents:
diff changeset
81 <output name="read_counts" file="read_counts.txt" />
31f25b37187b Uploaded
nikos
parents:
diff changeset
82 </test>
31f25b37187b Uploaded
nikos
parents:
diff changeset
83 </tests>
31f25b37187b Uploaded
nikos
parents:
diff changeset
84
31f25b37187b Uploaded
nikos
parents:
diff changeset
85 <help>
31f25b37187b Uploaded
nikos
parents:
diff changeset
86 **What it does**
31f25b37187b Uploaded
nikos
parents:
diff changeset
87
31f25b37187b Uploaded
nikos
parents:
diff changeset
88 *Summarize Unique Barcodes* counts the number of unique random barcodes and reads associated with each sequenced fragment. A fragment is understood as 1) a pair of Reverse Transcriptase (RT) termination site and RT priming site given paired end sequencing, or 2) an RT termination site in a single end sequencing. For non-barcoded sequencing it only counts the reads matching each fragment.
31f25b37187b Uploaded
nikos
parents:
diff changeset
89
31f25b37187b Uploaded
nikos
parents:
diff changeset
90 ------
31f25b37187b Uploaded
nikos
parents:
diff changeset
91
31f25b37187b Uploaded
nikos
parents:
diff changeset
92 **Inputs**
31f25b37187b Uploaded
nikos
parents:
diff changeset
93
31f25b37187b Uploaded
nikos
parents:
diff changeset
94 *Summarize Unique Barcodes* requires a file containing the Aligned Reads (required) in BAM_ format and tabular file with the Barcodes (optional) produced by the *Preprocessing* tool of the *RNA probing* suite.
31f25b37187b Uploaded
nikos
parents:
diff changeset
95
31f25b37187b Uploaded
nikos
parents:
diff changeset
96 .. _BAM: http://samtools.github.io/hts-specs/SAMv1.pdf
31f25b37187b Uploaded
nikos
parents:
diff changeset
97
31f25b37187b Uploaded
nikos
parents:
diff changeset
98 -------
31f25b37187b Uploaded
nikos
parents:
diff changeset
99
31f25b37187b Uploaded
nikos
parents:
diff changeset
100 **Parameters**
31f25b37187b Uploaded
nikos
parents:
diff changeset
101
31f25b37187b Uploaded
nikos
parents:
diff changeset
102 **Produce k2n file** - A file that contains a sequence of numbers where the n-th element informs how many unique cDNA molecules gives rise to observing n unique barcodes in a given sample. Required for calculating Estimated Unique Counts (EUCs) in tool *Normalize*.
31f25b37187b Uploaded
nikos
parents:
diff changeset
103
31f25b37187b Uploaded
nikos
parents:
diff changeset
104 **Trim untemplated nucleotides** - Untemplated nucleotides can be added to cDNA 3’ ends via terminal transferase activity of reverse transcriptase which offset the location of the read-end mapping and lead to erroneous assignment of reactivity information to nucleotides upstream of those which has reacted (Schmidt and Mueller, 1999, Talkish et al., 2014). Setting this parameter on will remove those nucleotides.
31f25b37187b Uploaded
nikos
parents:
diff changeset
105
31f25b37187b Uploaded
nikos
parents:
diff changeset
106 Recommended for methods based on detecting reverse transcription termination sites (e.g. DMS-Seq, HRF-Seq or SHAPE-Seq), and not for methods based on ligating the linker directly to RNA (e.g. PARS or FragSeq).
31f25b37187b Uploaded
nikos
parents:
diff changeset
107
31f25b37187b Uploaded
nikos
parents:
diff changeset
108 **Set priming position** - Applicable when the priming site is fixed.
31f25b37187b Uploaded
nikos
parents:
diff changeset
109
31f25b37187b Uploaded
nikos
parents:
diff changeset
110 ------
31f25b37187b Uploaded
nikos
parents:
diff changeset
111
31f25b37187b Uploaded
nikos
parents:
diff changeset
112 **Outputs**
31f25b37187b Uploaded
nikos
parents:
diff changeset
113
31f25b37187b Uploaded
nikos
parents:
diff changeset
114 **Unique Barcodes** (if a Barcode file is given) is a tabular file with 4 columns.
31f25b37187b Uploaded
nikos
parents:
diff changeset
115
31f25b37187b Uploaded
nikos
parents:
diff changeset
116 ====== ==========================================================
31f25b37187b Uploaded
nikos
parents:
diff changeset
117 Column Description
31f25b37187b Uploaded
nikos
parents:
diff changeset
118 ------ ----------------------------------------------------------
31f25b37187b Uploaded
nikos
parents:
diff changeset
119 1 Transcript identifier
31f25b37187b Uploaded
nikos
parents:
diff changeset
120 2 RT termination site (start)
31f25b37187b Uploaded
nikos
parents:
diff changeset
121 3 RT priming site (end)
31f25b37187b Uploaded
nikos
parents:
diff changeset
122 4 Count of unique barcodes associated with fragments matching the first three columns
31f25b37187b Uploaded
nikos
parents:
diff changeset
123 ====== ==========================================================
31f25b37187b Uploaded
nikos
parents:
diff changeset
124
31f25b37187b Uploaded
nikos
parents:
diff changeset
125 .
31f25b37187b Uploaded
nikos
parents:
diff changeset
126
31f25b37187b Uploaded
nikos
parents:
diff changeset
127 **Read Counts** is similar to Unique Barcodes but the fourth column is a count of reads matching first three columns.
31f25b37187b Uploaded
nikos
parents:
diff changeset
128
31f25b37187b Uploaded
nikos
parents:
diff changeset
129 **k2n file** as described above.
31f25b37187b Uploaded
nikos
parents:
diff changeset
130
31f25b37187b Uploaded
nikos
parents:
diff changeset
131 **Trimming Stats** reports statistics of trimming untemplated nucleotides from read ends.
31f25b37187b Uploaded
nikos
parents:
diff changeset
132
31f25b37187b Uploaded
nikos
parents:
diff changeset
133 </help>
31f25b37187b Uploaded
nikos
parents:
diff changeset
134
31f25b37187b Uploaded
nikos
parents:
diff changeset
135 <citations>
31f25b37187b Uploaded
nikos
parents:
diff changeset
136 <citation type="doi">10.1093/nar/gku167</citation>
31f25b37187b Uploaded
nikos
parents:
diff changeset
137 <citation type="doi">10.1093/nar/27.21.e31-i</citation>
31f25b37187b Uploaded
nikos
parents:
diff changeset
138 <citation type="doi">10.1261/rna.042218.113</citation>
31f25b37187b Uploaded
nikos
parents:
diff changeset
139 </citations>
31f25b37187b Uploaded
nikos
parents:
diff changeset
140
31f25b37187b Uploaded
nikos
parents:
diff changeset
141 </tool>