Mercurial > repos > pjbriggs > trimmomatic
annotate README.rst @ 18:9b273be64c25 draft default tip
Updated for Trimmomatic 0.39
| author | pjbriggs |
|---|---|
| date | Thu, 02 Mar 2023 14:48:18 +0000 |
| parents | d300b1888cef |
| children |
| 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 | 18 Installation via the Galaxy Tool Shed will take care of installing the tool wrapper |
| 19 and the trimmomatic program and data, and setting the appropriate environment | |
| 20 variables. | |
| 1 | 21 |
|
8
a923b799c77c
Version 0.36.3: fix the naming of output collections to differentiate btwn paired/unpaired; document the _JAVA_OPTIONS env var (thanks Marius van den Beek).
pjbriggs
parents:
7
diff
changeset
|
22 Controlling the available memory |
|
a923b799c77c
Version 0.36.3: fix the naming of output collections to differentiate btwn paired/unpaired; document the _JAVA_OPTIONS env var (thanks Marius van den Beek).
pjbriggs
parents:
7
diff
changeset
|
23 ================================ |
|
a923b799c77c
Version 0.36.3: fix the naming of output collections to differentiate btwn paired/unpaired; document the _JAVA_OPTIONS env var (thanks Marius van den Beek).
pjbriggs
parents:
7
diff
changeset
|
24 |
|
a923b799c77c
Version 0.36.3: fix the naming of output collections to differentiate btwn paired/unpaired; document the _JAVA_OPTIONS env var (thanks Marius van den Beek).
pjbriggs
parents:
7
diff
changeset
|
25 The default amount of memory avilable to trimmomatic is set to 8GB. |
|
a923b799c77c
Version 0.36.3: fix the naming of output collections to differentiate btwn paired/unpaired; document the _JAVA_OPTIONS env var (thanks Marius van den Beek).
pjbriggs
parents:
7
diff
changeset
|
26 To change the default amount of memory you can set the environment variable |
|
a923b799c77c
Version 0.36.3: fix the naming of output collections to differentiate btwn paired/unpaired; document the _JAVA_OPTIONS env var (thanks Marius van den Beek).
pjbriggs
parents:
7
diff
changeset
|
27 ``_JAVA_OPTIONS`` to ``-Xmx<amount_of_memory_in_GB>G``. The recommended way to |
|
a923b799c77c
Version 0.36.3: fix the naming of output collections to differentiate btwn paired/unpaired; document the _JAVA_OPTIONS env var (thanks Marius van den Beek).
pjbriggs
parents:
7
diff
changeset
|
28 set this is in the job_conf.xml file. To change the available memory to 6GB, a |
|
a923b799c77c
Version 0.36.3: fix the naming of output collections to differentiate btwn paired/unpaired; document the _JAVA_OPTIONS env var (thanks Marius van den Beek).
pjbriggs
parents:
7
diff
changeset
|
29 line like the below should be added: |
|
a923b799c77c
Version 0.36.3: fix the naming of output collections to differentiate btwn paired/unpaired; document the _JAVA_OPTIONS env var (thanks Marius van den Beek).
pjbriggs
parents:
7
diff
changeset
|
30 |
|
a923b799c77c
Version 0.36.3: fix the naming of output collections to differentiate btwn paired/unpaired; document the _JAVA_OPTIONS env var (thanks Marius van den Beek).
pjbriggs
parents:
7
diff
changeset
|
31 ``<env id="_JAVA_OPTIONS">-Xmx6G</env>`` |
|
a923b799c77c
Version 0.36.3: fix the naming of output collections to differentiate btwn paired/unpaired; document the _JAVA_OPTIONS env var (thanks Marius van den Beek).
pjbriggs
parents:
7
diff
changeset
|
32 |
|
a923b799c77c
Version 0.36.3: fix the naming of output collections to differentiate btwn paired/unpaired; document the _JAVA_OPTIONS env var (thanks Marius van den Beek).
pjbriggs
parents:
7
diff
changeset
|
33 This will set the environment variable ``_JAVA_OPTIONS`` to ``-Xmx6G``. |
|
a923b799c77c
Version 0.36.3: fix the naming of output collections to differentiate btwn paired/unpaired; document the _JAVA_OPTIONS env var (thanks Marius van den Beek).
pjbriggs
parents:
7
diff
changeset
|
34 |
| 1 | 35 Manual Installation |
| 36 =================== | |
| 37 | |
| 38 There are two files to install: | |
| 39 | |
| 40 - ``trimmomatic.xml`` (the Galaxy tool definition) | |
| 41 - ``trimmomatic.sh`` (the shell script wrapper) | |
| 42 | |
| 43 The suggested location is in a ``tools/trimmomatic/`` folder. You will then | |
| 44 need to modify the ``tools_conf.xml`` file to tell Galaxy to offer the tool | |
| 45 by adding the line: | |
| 46 | |
| 47 <tool file="trimmomatic/trimmomatic.xml" /> | |
| 48 | |
| 16 | 49 You will also need to install trimmomatic 0.38: |
| 1 | 50 |
| 16 | 51 - http://www.usadellab.org/cms/uploads/supplementary/Trimmomatic/Trimmomatic-0.38.zip |
| 1 | 52 |
| 53 The tool wrapper uses the following environment variables in order to find the | |
| 54 appropriate files: | |
| 55 | |
| 56 - ``TRIMMOMATIC_DIR`` should point to the directory holding the | |
| 4 | 57 ``trimmomatic-0.36.jar`` file |
| 1 | 58 - ``TRIMMOMATIC_ADAPTERS_DIR`` should point to the directory holding the adapter |
| 59 sequence files (used by the ``ILLUMINACLIP`` option). | |
| 60 | |
| 61 If you want to run the functional tests, copy the sample test files under | |
| 62 sample test files under Galaxy's ``test-data/`` directory. Then: | |
| 63 | |
| 64 ./run_tests.sh -id trimmomatic | |
| 65 | |
| 66 You will need to have set the environment variables above. | |
| 67 | |
| 68 History | |
| 69 ======= | |
| 70 | |
| 71 ========== ====================================================================== | |
| 72 Version Changes | |
| 73 ---------- ---------------------------------------------------------------------- | |
| 18 | 74 0.39 - Update to Trimmomatic 0.39. |
| 16 | 75 0.38.1 - Bug fix: add dependency on ``coreutils`` so that ``readlink -e`` is |
| 76 supported across both Linux and MacOS platforms. | |
| 15 | 77 0.38.0 - Update to Trimmomatic 0.38. |
| 12 | 78 0.36.6 - Added trimlog and log outputs; add support for ``fastqillumina`` |
| 79 and ``fastqsolexa`` input types | |
|
11
86bedbd3c5c2
Uploaded version 0.36.5 (use conda to resolve dependencies)
pjbriggs
parents:
9
diff
changeset
|
80 0.36.5 - Remove tool_dependencies.xml and always use conda to resolve tool |
|
86bedbd3c5c2
Uploaded version 0.36.5 (use conda to resolve dependencies)
pjbriggs
parents:
9
diff
changeset
|
81 dependencies |
| 9 | 82 0.36.4 - Add option to provide custom adapter sequences for ILLUMINACLIP |
| 83 - Add options ``minAdapterLength`` and ``keepBothReads`` for ILLUMINACLIP | |
| 84 in palindrome mode | |
|
8
a923b799c77c
Version 0.36.3: fix the naming of output collections to differentiate btwn paired/unpaired; document the _JAVA_OPTIONS env var (thanks Marius van den Beek).
pjbriggs
parents:
7
diff
changeset
|
85 0.36.3 - Fix naming of output collections. Instead of all outputs being called |
|
a923b799c77c
Version 0.36.3: fix the naming of output collections to differentiate btwn paired/unpaired; document the _JAVA_OPTIONS env var (thanks Marius van den Beek).
pjbriggs
parents:
7
diff
changeset
|
86 "Trimmomatic on collection NN" these will now be called "Trimmomatic |
|
a923b799c77c
Version 0.36.3: fix the naming of output collections to differentiate btwn paired/unpaired; document the _JAVA_OPTIONS env var (thanks Marius van den Beek).
pjbriggs
parents:
7
diff
changeset
|
87 on collection NN: paired" or "Trimmomatic on collection NN: unpaired". |
| 7 | 88 0.36.2 - Support fastqsanger.gz datatype. If fastqsanger.gz is used as input |
| 89 the output will also be fastqsanger.gz. | |
| 90 - Use $_JAVA_OPTIONS to customize memory requirements. | |
|
6
b9415df5fc32
Updated to 0.36.1: Reimplement to work with bioconda Trimmomatic 0.36 (toolshed version is still supported for now).
pjbriggs
parents:
4
diff
changeset
|
91 0.36.1 - Reimplement to work with bioconda Trimmomatic 0.36 (toolshed version |
|
b9415df5fc32
Updated to 0.36.1: Reimplement to work with bioconda Trimmomatic 0.36 (toolshed version is still supported for now).
pjbriggs
parents:
4
diff
changeset
|
92 is still supported for now). |
| 4 | 93 0.36.0 - Update to Trimmomatic 0.36. |
| 94 0.32.4 - Add support for ``AVGQUAL`` and ``MAXINFO`` operations. | |
|
3
a7139c612c45
Updated to version 0.32.3: add support for FASTQ pairs (dataset collections)
pjbriggs
parents:
2
diff
changeset
|
95 0.32.3 - Add support for FASTQ R1/R2 pairs using dataset collections (input |
|
a7139c612c45
Updated to version 0.32.3: add support for FASTQ pairs (dataset collections)
pjbriggs
parents:
2
diff
changeset
|
96 can be dataset collection, in which case tool also outputs dataset |
|
a7139c612c45
Updated to version 0.32.3: add support for FASTQ pairs (dataset collections)
pjbriggs
parents:
2
diff
changeset
|
97 collections) and improve order and naming of output files. |
| 2 | 98 0.32.2 - Use ``GALAXY_SLOTS`` to set the appropriate number of threads to use |
| 99 at runtime (default is 6). | |
| 1 | 100 0.32.1 - Remove ``trimmomatic_adapters.loc.sample`` and hard-code adapter files |
| 101 into the XML wrapper. | |
| 102 0.32.0 - Add tool_dependencies.xml to install Trimmomatic 0.32 automatically and | |
| 103 set the environment. | |
| 104 - Update tool versioning to use Trimmomatic version number (i.e. ``0.32``) | |
| 105 with tool iteration appended (i.e. ``.1``). | |
| 106 0.0.4 - Specify '-threads 6' in <command> section. | |
| 107 0.0.3 - Added MINLEN, LEADING, TRAILING, CROP and HEADCROP options of trimmomatic. | |
| 108 0.0.2 - Updated ILLUMINACLIP option to use standard adapter sequences (requires | |
| 109 the trimmomatic_adapters.loc file; sample version is supplied) plus | |
| 110 cosmetic updates to wording and help text for some options. | |
| 111 0.0.1 - Initial version | |
| 112 ========== ====================================================================== | |
| 113 | |
| 114 | |
| 7 | 115 Credits |
| 116 ======= | |
| 117 | |
| 118 This wrapper has been developed and is maintained by Peter Briggs (@pjbriggs). | |
| 12 | 119 Peter van Heusden (@pvanheus) and Marius van den Beek (@mvdbeek) contributed |
| 9 | 120 support for gz compressed FastQ files. Charles Girardot (@cgirardot) and |
| 121 Jelle Scholtalbers (@scholtalbers) contributed additional options to ILLUMINACLIP. | |
| 12 | 122 Matthias Bernt (@bernt-matthias) added log and trimlog output. |
| 16 | 123 Nicola Soranzo (@nsoranzo) suggested using coreutils to enable cross-platform |
| 124 support across Linux and MacOS. | |
| 18 | 125 Cristóbal Gallardo (@gallardoalba) updated Trimmomatic up to version 0.39. |
| 7 | 126 |
| 1 | 127 Developers |
| 128 ========== | |
| 129 | |
| 130 This tool is developed on the following GitHub repository: | |
| 131 https://github.com/fls-bioinformatics-core/galaxy-tools/tree/master/trimmomatic | |
| 132 | |
| 133 For making the "Galaxy Tool Shed" http://toolshed.g2.bx.psu.edu/ tarball I use | |
| 134 the ``package_trimmomatic.sh`` script. | |
| 135 | |
| 136 | |
| 137 Licence (MIT) | |
| 138 ============= | |
| 139 | |
| 140 Permission is hereby granted, free of charge, to any person obtaining a copy | |
| 141 of this software and associated documentation files (the "Software"), to deal | |
| 142 in the Software without restriction, including without limitation the rights | |
| 143 to use, copy, modify, merge, publish, distribute, sublicense, and/or sell | |
| 144 copies of the Software, and to permit persons to whom the Software is | |
| 145 furnished to do so, subject to the following conditions: | |
| 146 | |
| 147 The above copyright notice and this permission notice shall be included in | |
| 148 all copies or substantial portions of the Software. | |
| 149 | |
| 150 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR | |
| 151 IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, | |
| 152 FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE | |
| 153 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER | |
| 154 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, | |
| 155 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN | |
| 156 THE SOFTWARE. |