Mercurial > repos > pjbriggs > trimmomatic
annotate README.rst @ 4:14d05f2d511d draft
Version that supports Trimmomatic 0.36.
| author | pjbriggs |
|---|---|
| date | Thu, 14 Jul 2016 09:17:38 -0400 |
| parents | f8a9a5eaca8a |
| children | f80107cdc406 |
| rev | line source |
|---|---|
| 1 | 1 Trimmomatic: flexible read trimming tool for Illumina NGS data |
| 2 ============================================================== | |
| 3 | |
| 4 Galaxy tool wrapper for the Trimmomatic program, which provides various functions for | |
| 5 manipluating Illumina FASTQ files (both single and paired-end). | |
| 6 | |
| 7 Trimmomatic has been developed within Bjorn Usadel's group at RWTH Aachen university | |
| 8 http://www.usadellab.org/cms/index.php?page=trimmomatic | |
| 9 | |
| 10 The reference for Trimmomatic is: | |
| 11 | |
| 12 - Bolger, A.M., Lohse, M., & Usadel, B. (2014). Trimmomatic: A flexible trimmer | |
| 13 for Illumina Sequence Data. Bioinformatics, btu170. | |
| 14 | |
| 15 Automated installation | |
| 16 ====================== | |
| 17 | |
|
2
a60283899c6d
Version 0.32.2: use GALAXY_SLOTS to set number of threads.
pjbriggs
parents:
1
diff
changeset
|
18 Installation via the Galaxy Tool Shed will take care of installing the tool wrapper |
|
a60283899c6d
Version 0.32.2: use GALAXY_SLOTS to set number of threads.
pjbriggs
parents:
1
diff
changeset
|
19 and the trimmomatic program and data, and setting the appropriate environment |
|
a60283899c6d
Version 0.32.2: use GALAXY_SLOTS to set number of threads.
pjbriggs
parents:
1
diff
changeset
|
20 variables. |
| 1 | 21 |
| 22 Manual Installation | |
| 23 =================== | |
| 24 | |
| 25 There are two files to install: | |
| 26 | |
| 27 - ``trimmomatic.xml`` (the Galaxy tool definition) | |
| 28 - ``trimmomatic.sh`` (the shell script wrapper) | |
| 29 | |
| 30 The suggested location is in a ``tools/trimmomatic/`` folder. You will then | |
| 31 need to modify the ``tools_conf.xml`` file to tell Galaxy to offer the tool | |
| 32 by adding the line: | |
| 33 | |
| 34 <tool file="trimmomatic/trimmomatic.xml" /> | |
| 35 | |
| 4 | 36 You will also need to install trimmomatic 0.36: |
| 1 | 37 |
| 4 | 38 - http://www.usadellab.org/cms/uploads/supplementary/Trimmomatic/Trimmomatic-0.36.zip |
| 1 | 39 |
| 40 The tool wrapper uses the following environment variables in order to find the | |
| 41 appropriate files: | |
| 42 | |
| 43 - ``TRIMMOMATIC_DIR`` should point to the directory holding the | |
| 4 | 44 ``trimmomatic-0.36.jar`` file |
| 1 | 45 - ``TRIMMOMATIC_ADAPTERS_DIR`` should point to the directory holding the adapter |
| 46 sequence files (used by the ``ILLUMINACLIP`` option). | |
| 47 | |
| 48 If you want to run the functional tests, copy the sample test files under | |
| 49 sample test files under Galaxy's ``test-data/`` directory. Then: | |
| 50 | |
| 51 ./run_tests.sh -id trimmomatic | |
| 52 | |
| 53 You will need to have set the environment variables above. | |
| 54 | |
| 55 History | |
| 56 ======= | |
| 57 | |
| 58 ========== ====================================================================== | |
| 59 Version Changes | |
| 60 ---------- ---------------------------------------------------------------------- | |
| 4 | 61 0.36.0 - Update to Trimmomatic 0.36. |
| 62 0.32.4 - Add support for ``AVGQUAL`` and ``MAXINFO`` operations. | |
|
3
f8a9a5eaca8a
Updated to version 0.32.3: add support for FASTQ pairs (dataset collections)
pjbriggs
parents:
2
diff
changeset
|
63 0.32.3 - Add support for FASTQ R1/R2 pairs using dataset collections (input |
|
f8a9a5eaca8a
Updated to version 0.32.3: add support for FASTQ pairs (dataset collections)
pjbriggs
parents:
2
diff
changeset
|
64 can be dataset collection, in which case tool also outputs dataset |
|
f8a9a5eaca8a
Updated to version 0.32.3: add support for FASTQ pairs (dataset collections)
pjbriggs
parents:
2
diff
changeset
|
65 collections) and improve order and naming of output files. |
|
2
a60283899c6d
Version 0.32.2: use GALAXY_SLOTS to set number of threads.
pjbriggs
parents:
1
diff
changeset
|
66 0.32.2 - Use ``GALAXY_SLOTS`` to set the appropriate number of threads to use |
|
a60283899c6d
Version 0.32.2: use GALAXY_SLOTS to set number of threads.
pjbriggs
parents:
1
diff
changeset
|
67 at runtime (default is 6). |
| 1 | 68 0.32.1 - Remove ``trimmomatic_adapters.loc.sample`` and hard-code adapter files |
| 69 into the XML wrapper. | |
| 70 0.32.0 - Add tool_dependencies.xml to install Trimmomatic 0.32 automatically and | |
| 71 set the environment. | |
| 72 - Update tool versioning to use Trimmomatic version number (i.e. ``0.32``) | |
| 73 with tool iteration appended (i.e. ``.1``). | |
| 74 0.0.4 - Specify '-threads 6' in <command> section. | |
| 75 0.0.3 - Added MINLEN, LEADING, TRAILING, CROP and HEADCROP options of trimmomatic. | |
| 76 0.0.2 - Updated ILLUMINACLIP option to use standard adapter sequences (requires | |
| 77 the trimmomatic_adapters.loc file; sample version is supplied) plus | |
| 78 cosmetic updates to wording and help text for some options. | |
| 79 0.0.1 - Initial version | |
| 80 ========== ====================================================================== | |
| 81 | |
| 82 | |
| 83 Developers | |
| 84 ========== | |
| 85 | |
| 86 This tool is developed on the following GitHub repository: | |
| 87 https://github.com/fls-bioinformatics-core/galaxy-tools/tree/master/trimmomatic | |
| 88 | |
| 89 For making the "Galaxy Tool Shed" http://toolshed.g2.bx.psu.edu/ tarball I use | |
| 90 the ``package_trimmomatic.sh`` script. | |
| 91 | |
| 92 | |
| 93 Licence (MIT) | |
| 94 ============= | |
| 95 | |
| 96 Permission is hereby granted, free of charge, to any person obtaining a copy | |
| 97 of this software and associated documentation files (the "Software"), to deal | |
| 98 in the Software without restriction, including without limitation the rights | |
| 99 to use, copy, modify, merge, publish, distribute, sublicense, and/or sell | |
| 100 copies of the Software, and to permit persons to whom the Software is | |
| 101 furnished to do so, subject to the following conditions: | |
| 102 | |
| 103 The above copyright notice and this permission notice shall be included in | |
| 104 all copies or substantial portions of the Software. | |
| 105 | |
| 106 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR | |
| 107 IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, | |
| 108 FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE | |
| 109 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER | |
| 110 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, | |
| 111 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN | |
| 112 THE SOFTWARE. |