annotate tools/primers/seq_primer_clip.txt @ 1:06e6112091aa draft

Uploaded v0.0.9, modifies tests to cope with current Tool Shed limitation.
author peterjc
date Tue, 30 Apr 2013 11:04:13 -0400
parents b8ca95338e77
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
1 Galaxy tool to primer clip (trim) FASTA, FASTQ or SFF reads
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
2 ===========================================================
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
3
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
4 This tool is copyright 2011 by Peter Cock, The James Hutton Institute
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
5 (formerly SCRI, Scottish Crop Research Institute), UK. All rights reserved.
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
6 See the licence text below.
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
7
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
8 This tool is a short Python script (using the Galaxy library functions and
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
9 Biopython). There are just two files to install:
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
10
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
11 * seq_primer_clip.py (the Python script)
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
12 * seq_primer_clip.xml (the Galaxy tool definition)
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
13
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
14 The suggested location is a new tools/primers folder. You will also need to
1
06e6112091aa Uploaded v0.0.9, modifies tests to cope with current Tool Shed limitation.
peterjc
parents: 0
diff changeset
15 modify the tools_conf.xml file to tell Galaxy to offer the tool:
0
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
16
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
17 <tool file="primers/seq_primer_clip.xml" />
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
18
1
06e6112091aa Uploaded v0.0.9, modifies tests to cope with current Tool Shed limitation.
peterjc
parents: 0
diff changeset
19 If you wish to run the unit tests, also add this to tools_conf.xml.sample
06e6112091aa Uploaded v0.0.9, modifies tests to cope with current Tool Shed limitation.
peterjc
parents: 0
diff changeset
20 and move/copy the test-data files under Galaxy's test-data folder. Then:
0
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
21
1
06e6112091aa Uploaded v0.0.9, modifies tests to cope with current Tool Shed limitation.
peterjc
parents: 0
diff changeset
22 $ ./run_functional_tests.sh -id seq_primer_clip
0
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
23
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
24 You will also need to install Biopython 1.54 or later. That's it.
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
25
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
26
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
27 History
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
28 =======
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
29
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
30 v0.0.1 - Initial version (not publicly released)
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
31 v0.0.2 - Sort primers by length (longest and therefore most specific first)
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
32 v0.0.3 - Consider missing bases at start/end of read as mismatches
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
33 v0.0.4 - Apply minimum length to sequences with no match too
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
34 v0.0.5 - Count clipped & non-matched short reads separately, length bug fixes
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
35 v0.0.6 - Added some functional tests
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
36 v0.0.7 - Added error check for bad filename arguments
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
37 v0.0.8 - Record version of Python script when run from Galaxy.
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
38 - Check for errors using Python script's return code.
1
06e6112091aa Uploaded v0.0.9, modifies tests to cope with current Tool Shed limitation.
peterjc
parents: 0
diff changeset
39 v0.0.9 - Moved test data to workaround Galaxy Tool Shed limititation.
0
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
40
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
41
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
42 Developers
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
43 ==========
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
44
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
45 This script and related tools are being developed on the following hg branch:
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
46 http://bitbucket.org/peterjc/galaxy-central/src/tools
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
47
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
48 This incorporates the previously used hg branch:
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
49 http://bitbucket.org/peterjc/galaxy-central/src/fasta_filter
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
50
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
51 For making the "Galaxy Tool Shed" http://toolshed.g2.bx.psu.edu/ tarball use
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
52 the following command from the Galaxy root folder:
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
53
1
06e6112091aa Uploaded v0.0.9, modifies tests to cope with current Tool Shed limitation.
peterjc
parents: 0
diff changeset
54 $ tar -czf seq_primer_clip.tar.gz tools/primers/seq_primer_clip.* test-data/dop_primers.fasta test-data/MID4_GLZRM4E04_rnd30*
0
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
55
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
56 Check this worked:
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
57
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
58 $ tar -tzf seq_primer_clip.tar.gz
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
59 tools/primers/seq_primer_clip.py
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
60 tools/primers/seq_primer_clip.txt
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
61 tools/primers/seq_primer_clip.xml
1
06e6112091aa Uploaded v0.0.9, modifies tests to cope with current Tool Shed limitation.
peterjc
parents: 0
diff changeset
62 test-data/dop_primers.fasta
06e6112091aa Uploaded v0.0.9, modifies tests to cope with current Tool Shed limitation.
peterjc
parents: 0
diff changeset
63 test-data/MID4_GLZRM4E04_rnd30.fasta
06e6112091aa Uploaded v0.0.9, modifies tests to cope with current Tool Shed limitation.
peterjc
parents: 0
diff changeset
64 test-data/MID4_GLZRM4E04_rnd30.fastqsanger
06e6112091aa Uploaded v0.0.9, modifies tests to cope with current Tool Shed limitation.
peterjc
parents: 0
diff changeset
65 test-data/MID4_GLZRM4E04_rnd30_fclip.fasta
06e6112091aa Uploaded v0.0.9, modifies tests to cope with current Tool Shed limitation.
peterjc
parents: 0
diff changeset
66 test-data/MID4_GLZRM4E04_rnd30_fclip.fastqsanger
06e6112091aa Uploaded v0.0.9, modifies tests to cope with current Tool Shed limitation.
peterjc
parents: 0
diff changeset
67 test-data/MID4_GLZRM4E04_rnd30_fclip.sff
06e6112091aa Uploaded v0.0.9, modifies tests to cope with current Tool Shed limitation.
peterjc
parents: 0
diff changeset
68 test-data/MID4_GLZRM4E04_rnd30_frclip.fasta
06e6112091aa Uploaded v0.0.9, modifies tests to cope with current Tool Shed limitation.
peterjc
parents: 0
diff changeset
69 test-data/MID4_GLZRM4E04_rnd30_frclip.fastqsanger
06e6112091aa Uploaded v0.0.9, modifies tests to cope with current Tool Shed limitation.
peterjc
parents: 0
diff changeset
70 test-data/MID4_GLZRM4E04_rnd30_frclip.sff
06e6112091aa Uploaded v0.0.9, modifies tests to cope with current Tool Shed limitation.
peterjc
parents: 0
diff changeset
71 test-data/MID4_GLZRM4E04_rnd30.sff
0
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
72
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
73
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
74 Licence (MIT/BSD style)
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
75 =======================
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
76
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
77 Permission to use, copy, modify, and distribute this software and its
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
78 documentation with or without modifications and for any purpose and
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
79 without fee is hereby granted, provided that any copyright notices
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
80 appear in all copies and that both those copyright notices and this
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
81 permission notice appear in supporting documentation, and that the
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
82 names of the contributors or copyright holders not be used in
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
83 advertising or publicity pertaining to distribution of the software
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
84 without specific prior permission.
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
85
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
86 THE CONTRIBUTORS AND COPYRIGHT HOLDERS OF THIS SOFTWARE DISCLAIM ALL
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
87 WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
88 WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL THE
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
89 CONTRIBUTORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY SPECIAL, INDIRECT
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
90 OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
91 OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
92 OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE
b8ca95338e77 Uploaded v0.0.8, first public release.
peterjc
parents:
diff changeset
93 OR PERFORMANCE OF THIS SOFTWARE.