annotate fastx_clipper.xml @ 1:08495cd1d93e draft

Uploaded tool help images.
author devteam
date Tue, 03 Jun 2014 14:53:42 -0400
parents 743d895d28db
children 4286abbc87a2
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
1 <tool id="cshl_fastx_clipper" name="Clip" version="1.0.1" >
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
2 <description>adapter sequences</description>
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
3 <requirements>
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
4 <requirement type="package" version="0.0.13">fastx_toolkit</requirement>
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
5 </requirements>
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
6 <command>
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
7 zcat -f $input | fastx_clipper -l $minlength -a $clip_source.clip_sequence -d $keepdelta -o $output -v $KEEP_N $DISCARD_OPTIONS
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
8 #if $input.ext == "fastqsanger":
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
9 -Q 33
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
10 #end if
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
11 </command>
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
12
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
13 <inputs>
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
14 <param format="fasta,fastqsanger,fastqsolexa,fastqillumina" name="input" type="data" label="Library to clip" />
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
15
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
16 <param name="minlength" size="4" type="integer" value="15">
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
17 <label>Minimum sequence length (after clipping, sequences shorter than this length will be discarded)</label>
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
18 </param>
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
19
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
20 <conditional name="clip_source">
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
21 <param name="clip_source_list" type="select" label="Source">
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
22 <option value="prebuilt" selected="true">Standard (select from the list below)</option>
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
23 <option value="user">Enter custom sequence</option>
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
24 </param>
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
25
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
26 <when value="user">
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
27 <param name="clip_sequence" size="30" label="Enter custom clipping sequence" type="text" value="AATTGGCC" />
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
28 </when>
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
29
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
30 <when value="prebuilt">
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
31 <param name="clip_sequence" type="select" label="Choose Adapter">
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
32 <options from_file="fastx_clipper_sequences.txt">
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
33 <column name="name" index="1"/>
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
34 <column name="value" index="0"/>
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
35 </options>
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
36 </param>
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
37 </when>
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
38 </conditional>
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
39
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
40 <param name="keepdelta" size="2" type="integer" value="0">
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
41 <label>enter non-zero value to keep the adapter sequence and x bases that follow it</label>
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
42 <help>use this for hairpin barcoding. keep at 0 unless you know what you're doing.</help>
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
43 </param>
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
44
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
45 <param name="KEEP_N" type="select" label="Discard sequences with unknown (N) bases">
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
46 <option value="">Yes</option>
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
47 <option value="-n">No</option>
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
48 </param>
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
49
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
50 <param name="DISCARD_OPTIONS" type="select" label="Output options">
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
51 <option value="-c">Output only clipped sequences (i.e. sequences which contained the adapter)</option>
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
52 <option value="-C">Output only non-clipped sequences (i.e. sequences which did not contained the adapter)</option>
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
53 <option value="">Output both clipped and non-clipped sequences</option>
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
54 </param>
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
55
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
56 </inputs>
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
57 <!--
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
58 #functional test with param value starting with - fails.
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
59 -->
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
60 <tests>
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
61 <test>
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
62 <param name="input" value="fastx_clipper1.fastq" ftype="fastqsolexa"/>
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
63 <param name="maxmismatches" value="2" />
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
64 <param name="minlength" value="15" />
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
65 <param name="clip_source_list" value="user" />
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
66 <param name="clip_sequence" value="CAATTGGTTAATCCCCCTATATA" />
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
67 <param name="keepdelta" value="0" />
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
68 <param name="KEEP_N" value="+-n" />
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
69 <param name="DISCARD_OPTIONS" value="+-c" />
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
70 <output name="output" file="fastx_clipper1a.out" />
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
71 </test>
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
72 </tests>
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
73 <outputs>
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
74 <data format="input" name="output" metadata_source="input" />
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
75 </outputs>
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
76
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
77 <help>
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
78 **What it does**
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
79
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
80 This tool clips adapters from the 3'-end of the sequences in a FASTA/FASTQ file.
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
81
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
82 --------
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
83
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
84
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
85 **Clipping Illustration:**
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
86
1
08495cd1d93e Uploaded tool help images.
devteam
parents: 0
diff changeset
87 .. image:: fastx_clipper_illustration.png
0
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
88
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
89
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
90
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
91
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
92
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
93
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
94
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
95
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
96 **Clipping Example:**
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
97
1
08495cd1d93e Uploaded tool help images.
devteam
parents: 0
diff changeset
98 .. image:: fastx_clipper_example.png
0
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
99
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
100
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
101
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
102 **In the above example:**
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
103
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
104 * Sequence no. 1 was discarded since it wasn't clipped (i.e. didn't contain the adapter sequence). (**Output** parameter).
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
105 * Sequence no. 5 was discarded --- it's length (after clipping) was shorter than 15 nt (**Minimum Sequence Length** parameter).
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
106
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
107
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
108
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
109
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
110 ------
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
111
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
112 This tool is based on `FASTX-toolkit`__ by Assaf Gordon.
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
113
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
114 .. __: http://hannonlab.cshl.edu/fastx_toolkit/
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
115
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
116 </help>
743d895d28db Uploaded tool tarball.
devteam
parents:
diff changeset
117 </tool>