Mercurial > repos > iuc > dada2_filterandtrim

comparison README.md @ 0:cc41546adf56 draft

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
"planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/dada2 commit f8b6b6e72914ad6bcca8423dfa03f59bde80992e"
author iuc
date Fri, 08 Nov 2019 18:48:06 -0500
parents
children 777f9846c56d
comparison
equal deleted inserted replaced
-1:000000000000 0:cc41546adf56
1 Wrappers for the core functionality of the dada2 package https://benjjneb.github.io/dada2/index.html.
2
3 - filterAndTrim
4 - learnErrors
5 - dada
6 - mergePairs
7 - makeSequenceTable
8 - removeBimeraDenovo
9
10 Installation
11 ============
12
13 The dada2 wrappers can be installed via the toolshed. Since they use datatypes that have been introduced with Galaxy release 19.09 they won't work out of the box for older Galaxy releases.
14 In order to run the tools you may either upgrade Galaxy or execute the following two steps:
15
16 1. `find GALAXY_ROOT/shed_tools/testtoolshed.g2.bx.psu.edu/repos/iuc/ -name "dada2_*xml" -exec sed -i -e 's/profile="19.09"/profile="YOUR_RELEASE"/' {} ;` (replace GALAXY_ROOT and YOUR_RELEASE appropriately)
17 2. insert the following lines in `config/datatypes.xml` (just before the line `</registration>`):
18 ```
19 <datatype extension="dada2_dada" type="galaxy.datatypes.binary:RData" subclass="true" display_in_upload="true" />
20 <datatype extension="dada2_errorrates" type="galaxy.datatypes.binary:RData" subclass="true" display_in_upload="true" />
21 <datatype extension="dada2_mergepairs" type="galaxy.datatypes.binary:RData" subclass="true" display_in_upload="true" />
22 <datatype extension="dada2_sequencetable" type="galaxy.datatypes.tabular:Tabular" mimetype="application/text" subclass="true" display_in_upload="true" />
23 <datatype extension="dada2_uniques" type="galaxy.datatypes.tabular:Tabular" mimetype="application/text" subclass="true" display_in_upload="true" />
24 ```
25
26 Datatypes
27 =========
28
29 The dada2 Galaxy wrappers use a few extra data types to ensure that only inputs of the correct type can be used, these datatypes are available from Galaxy release 19.05, for earlier releases they need to be added manually.
30
31 For the outputs of dada, learnErrors, and mergePairs the following datatypes are used that derive from Rdata (which contains the named list that is returned from the corresponding dada function):
32
33 - dada2_dada (Rdata: named list, see docs for dada-class)
34 - dada2_errorrates (Rdata: named list, see docs for learnErrors)
35 - dada2_mergepairs (Rdata: named list, see docs for mergePairs)
36
37 For the outputs of makeSequenceTable and removeBimeraDenovo the following data types are used which derive from tabular:
38
39 - dada2_uniques
40 -- in R a named integer vector (names are the unique sequences)
41 -- in Galaxy written as a table (each row corresponding to a unique sequence, column 1: the sequence, column 2: the count)
42 - dada2_sequencetable
43 -- in R a named integer matrix (rows = samples, columns = unique sequences)
44 -- in Galaxy written as a table (rows = unique sequences, columns = samples)
45
46 Note the difference between the R and Galaxy representations! The main motivation is that the dada2_sequencetable is analogous to OTU tables as produced for instance by qiime (and it seemed natural to extend this to the uniques which are essentially a sequencetables of single samples).
47
48 Test data
49 =========
50
51 Test data for `dada2_seqCounts` is generated using planemo's `--update_test_data` argument and manual
52 inspection of the test files. In addition a run of the pipeline (using collections) is executed
53 manually using `planemo serve` making sure that the entries of the tables are generated in a useful way.
54
55 In order to have the Collection unzip tool available use `planemo s --galaxy_root GALAXY_ROOT --extra_tools GALAXY_ROOT/lib/galaxy/tools/`
56
57 All test other test data is generated using the shell script (`gentest.sh`) in test-data