Mercurial > repos > peterjc > fastq_filter_by_id
comparison tools/fastq_filter_by_id/README.rst @ 3:e0041942a12d draft default tip
v0.0.5 - galaxy_sequence_utils dependency and other cleanups inc using MIT license
author | peterjc |
---|---|
date | Fri, 03 Feb 2017 05:34:18 -0500 |
parents | |
children |
comparison
equal
deleted
inserted
replaced
2:d570cc324779 | 3:e0041942a12d |
---|---|
1 Obsolete | |
2 ======== | |
3 | |
4 This tool is now obsolete, having been replaced by a more general version | |
5 covering the FASTA, FASTQ and SFF sequence formats in a single tool. You | |
6 should only install this tool if you need to support existing workflows | |
7 which used it. | |
8 | |
9 Galaxy tool to filter FASTQ sequences by ID | |
10 =========================================== | |
11 | |
12 This tool is copyright 2010-2017 by Peter Cock, The James Hutton Institute | |
13 (formerly SCRI, Scottish Crop Research Institute), UK. All rights reserved. | |
14 See the licence text below (MIT licence). | |
15 | |
16 This tool is a short Python script (using the Galaxy library functions) which | |
17 divides a FASTQ file in two, those sequences with or without an ID present in | |
18 the specified column(s) of a tabular file. Example uses include filtering based | |
19 on search results from a tool like NCBI BLAST before assembly. | |
20 | |
21 There are just two files to install: | |
22 | |
23 * fastq_filter_by_id.py (the Python script) | |
24 * fastq_filter_by_id.xml (the Galaxy tool definition) | |
25 | |
26 The suggested location is next to the similarly named fastq_filter.py and | |
27 fastq_filter.xml files which are included with Galaxy, i.e. in the Galaxy | |
28 folder tools/fastq | |
29 | |
30 You will also need to modify the tools_conf.xml file to tell Galaxy to offer | |
31 the tool. The suggested location is next to the fastq_filter.xml entry. Simply | |
32 add the line: | |
33 | |
34 <tool file="fastq/fastq_filter_by_id.xml" /> | |
35 | |
36 That's it. | |
37 | |
38 | |
39 History | |
40 ======= | |
41 | |
42 ======= ====================================================================== | |
43 Version Changes | |
44 ------- ---------------------------------------------------------------------- | |
45 v0.0.1 - Initial verion (not publicly released) | |
46 v0.0.2 - Allow both, just pos or just neg output files | |
47 - Preserve the FASTQ variant in the XML wrapper | |
48 v0.0.3 - Fixed bug when generating non-matching FASTQ file only | |
49 v0.0.4 - Deprecated, marked as hidden in the XML | |
50 v0.0.5 - Explicit dependency on ``galaxy_sequence_utils``. | |
51 - Citation information (Cock et al. 2013). | |
52 - Explicitly record version via ``<version_command>``. | |
53 - Use ``format_source``/``metadata_source`` idiom for output format. | |
54 - Use standard MIT license (was previously using the MIT/BSD style | |
55 Biopython Licence Agreement). | |
56 ======= ====================================================================== | |
57 | |
58 | |
59 Developers | |
60 ========== | |
61 | |
62 This script and other tools for filtering FASTA, FASTQ and SFF files were | |
63 initially developed on the following hg branches: | |
64 http://bitbucket.org/peterjc/galaxy-central/src/tools | |
65 http://bitbucket.org/peterjc/galaxy-central/src/fasta_filter | |
66 | |
67 It is now under GitHub https://github.com/peterjc/pico_galaxy/ | |
68 | |
69 For pushing a release to the test or main "Galaxy Tool Shed", use the following | |
70 Planemo commands (which requires you have set your Tool Shed access details in | |
71 ``~/.planemo.yml`` and that you have access rights on the Tool Shed):: | |
72 | |
73 $ planemo shed_update -t testtoolshed --check_diff tools/fastq_filter_by_id/ | |
74 ... | |
75 | |
76 or:: | |
77 | |
78 $ planemo shed_update -t toolshed --check_diff tools/fastq_filter_by_id/ | |
79 ... | |
80 | |
81 To just build and check the tar ball, use:: | |
82 | |
83 $ planemo shed_upload --tar_only tools/fastq_filter_by_id/ | |
84 ... | |
85 $ tar -tzf shed_upload.tar.gz | |
86 tools/fastq_filter_by_id/README.rst | |
87 tools/fastq_filter_by_id/fastq_filter_by_id.py | |
88 tools/fastq_filter_by_id/fastq_filter_by_id.xml | |
89 tools/fastq_filter_by_id/tool_dependencies.xml | |
90 test-data/empty_file.dat | |
91 test-data/sanger-pairs-mixed.fastq | |
92 test-data/sanger-pairs-names.tabular | |
93 | |
94 | |
95 Licence (MIT) | |
96 ============= | |
97 | |
98 Permission is hereby granted, free of charge, to any person obtaining a copy | |
99 of this software and associated documentation files (the "Software"), to deal | |
100 in the Software without restriction, including without limitation the rights | |
101 to use, copy, modify, merge, publish, distribute, sublicense, and/or sell | |
102 copies of the Software, and to permit persons to whom the Software is | |
103 furnished to do so, subject to the following conditions: | |
104 | |
105 The above copyright notice and this permission notice shall be included in | |
106 all copies or substantial portions of the Software. | |
107 | |
108 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR | |
109 IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, | |
110 FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE | |
111 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER | |
112 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, | |
113 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN | |
114 THE SOFTWARE. |