annotate README.rst @ 5:4726b640f221 draft default tip

Uploaded revision to update the citation
author peterjc
date Fri, 25 Oct 2013 10:20:46 -0400
parents 3c280e01b920
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
3
1a1ab2f2b5b5 README file with clearer citation instructions.
peterjc
parents:
diff changeset
1 This is package is a Galaxy workflow for comparing three RXLR prediction
1a1ab2f2b5b5 README file with clearer citation instructions.
peterjc
parents:
diff changeset
2 methods with a Venn Diagram, and creates a FASTA file of any proteins
1a1ab2f2b5b5 README file with clearer citation instructions.
peterjc
parents:
diff changeset
3 passing all three methods.
1a1ab2f2b5b5 README file with clearer citation instructions.
peterjc
parents:
diff changeset
4
1a1ab2f2b5b5 README file with clearer citation instructions.
peterjc
parents:
diff changeset
5 See http://www.galaxyproject.org for information about the Galaxy Project.
1a1ab2f2b5b5 README file with clearer citation instructions.
peterjc
parents:
diff changeset
6
1a1ab2f2b5b5 README file with clearer citation instructions.
peterjc
parents:
diff changeset
7
1a1ab2f2b5b5 README file with clearer citation instructions.
peterjc
parents:
diff changeset
8 Availability
1a1ab2f2b5b5 README file with clearer citation instructions.
peterjc
parents:
diff changeset
9 ============
1a1ab2f2b5b5 README file with clearer citation instructions.
peterjc
parents:
diff changeset
10
1a1ab2f2b5b5 README file with clearer citation instructions.
peterjc
parents:
diff changeset
11 This workflow is available to download and/or install from the main
1a1ab2f2b5b5 README file with clearer citation instructions.
peterjc
parents:
diff changeset
12 Galaxy Tool Shed:
1a1ab2f2b5b5 README file with clearer citation instructions.
peterjc
parents:
diff changeset
13
1a1ab2f2b5b5 README file with clearer citation instructions.
peterjc
parents:
diff changeset
14 http://toolshed.g2.bx.psu.edu/view/peterjc/rxlr_venn_workflow
1a1ab2f2b5b5 README file with clearer citation instructions.
peterjc
parents:
diff changeset
15
1a1ab2f2b5b5 README file with clearer citation instructions.
peterjc
parents:
diff changeset
16 Test releases (which should not normally be used) are on the Test Tool Shed:
1a1ab2f2b5b5 README file with clearer citation instructions.
peterjc
parents:
diff changeset
17
1a1ab2f2b5b5 README file with clearer citation instructions.
peterjc
parents:
diff changeset
18 http://testtoolshed.g2.bx.psu.edu/view/peterjc/rxlr_venn_workflow
1a1ab2f2b5b5 README file with clearer citation instructions.
peterjc
parents:
diff changeset
19
1a1ab2f2b5b5 README file with clearer citation instructions.
peterjc
parents:
diff changeset
20 Development is being done on github here:
1a1ab2f2b5b5 README file with clearer citation instructions.
peterjc
parents:
diff changeset
21
5
4726b640f221 Uploaded revision to update the citation
peterjc
parents: 4
diff changeset
22 https://github.com/peterjc/pico_galaxy/tree/master/workflows/rxlr_venn_workflow
4726b640f221 Uploaded revision to update the citation
peterjc
parents: 4
diff changeset
23
4726b640f221 Uploaded revision to update the citation
peterjc
parents: 4
diff changeset
24
4726b640f221 Uploaded revision to update the citation
peterjc
parents: 4
diff changeset
25 Sample Data
4726b640f221 Uploaded revision to update the citation
peterjc
parents: 4
diff changeset
26 ===========
4726b640f221 Uploaded revision to update the citation
peterjc
parents: 4
diff changeset
27
4726b640f221 Uploaded revision to update the citation
peterjc
parents: 4
diff changeset
28 This workflow was developed and run on several *Phytophthora* species.
4726b640f221 Uploaded revision to update the citation
peterjc
parents: 4
diff changeset
29 For example, try the "Phyca11" protein set for *Phytophthora capsici*:
4726b640f221 Uploaded revision to update the citation
peterjc
parents: 4
diff changeset
30
4726b640f221 Uploaded revision to update the citation
peterjc
parents: 4
diff changeset
31 http://genome.jgi-psf.org/Phyca11/download/Phyca11_filtered_proteins.fasta.gz
4726b640f221 Uploaded revision to update the citation
peterjc
parents: 4
diff changeset
32
4726b640f221 Uploaded revision to update the citation
peterjc
parents: 4
diff changeset
33 You can upload this directly into Galaxy via this URL. Galaxy will handle
4726b640f221 Uploaded revision to update the citation
peterjc
parents: 4
diff changeset
34 removing the gzip compression to give you the FASTA protein file which
4726b640f221 Uploaded revision to update the citation
peterjc
parents: 4
diff changeset
35 has 19,805 protein sequences. The expected results:
4726b640f221 Uploaded revision to update the citation
peterjc
parents: 4
diff changeset
36
4726b640f221 Uploaded revision to update the citation
peterjc
parents: 4
diff changeset
37 * 89 RXLRs using Whisson et al. (2007)
4726b640f221 Uploaded revision to update the citation
peterjc
parents: 4
diff changeset
38 * 124 RXLRs using Win et al. (2007)
4726b640f221 Uploaded revision to update the citation
peterjc
parents: 4
diff changeset
39 * 162 RXLRs using Bhattacharjee et al. (2006)
4726b640f221 Uploaded revision to update the citation
peterjc
parents: 4
diff changeset
40
4726b640f221 Uploaded revision to update the citation
peterjc
parents: 4
diff changeset
41 Of these, only 79 sequences pass all three of the RXLR prediction tools,
4726b640f221 Uploaded revision to update the citation
peterjc
parents: 4
diff changeset
42 while 19643 have no RXLR matches at all.
4726b640f221 Uploaded revision to update the citation
peterjc
parents: 4
diff changeset
43
4726b640f221 Uploaded revision to update the citation
peterjc
parents: 4
diff changeset
44 .. image:: Phyca11_example_output.png
4726b640f221 Uploaded revision to update the citation
peterjc
parents: 4
diff changeset
45 :height: 400px
4726b640f221 Uploaded revision to update the citation
peterjc
parents: 4
diff changeset
46 :width: 400px
4726b640f221 Uploaded revision to update the citation
peterjc
parents: 4
diff changeset
47
4726b640f221 Uploaded revision to update the citation
peterjc
parents: 4
diff changeset
48
4726b640f221 Uploaded revision to update the citation
peterjc
parents: 4
diff changeset
49 Citation
4726b640f221 Uploaded revision to update the citation
peterjc
parents: 4
diff changeset
50 ========
4726b640f221 Uploaded revision to update the citation
peterjc
parents: 4
diff changeset
51
4726b640f221 Uploaded revision to update the citation
peterjc
parents: 4
diff changeset
52 If you use this workflow directly, or a derivative of it, in work leading
4726b640f221 Uploaded revision to update the citation
peterjc
parents: 4
diff changeset
53 to a scientific publication, please cite:
4726b640f221 Uploaded revision to update the citation
peterjc
parents: 4
diff changeset
54
4726b640f221 Uploaded revision to update the citation
peterjc
parents: 4
diff changeset
55 Cock, P.J.A. and Pritchard, L. (2014). Galaxy as a platform for identifying
4726b640f221 Uploaded revision to update the citation
peterjc
parents: 4
diff changeset
56 candidate pathogen effectors. Chapter 1 in "Plant-Pathogen Interactions:
4726b640f221 Uploaded revision to update the citation
peterjc
parents: 4
diff changeset
57 Methods and Protocols (Second Edition)"; P. Birch, J. Jones, and J.I. Bos, eds.
4726b640f221 Uploaded revision to update the citation
peterjc
parents: 4
diff changeset
58 Methods in Molecular Biology. Humana Press, Springer. ISBN 978-1-62703-985-7.
4726b640f221 Uploaded revision to update the citation
peterjc
parents: 4
diff changeset
59 http://www.springer.com/life+sciences/plant+sciences/book/978-1-62703-985-7
4726b640f221 Uploaded revision to update the citation
peterjc
parents: 4
diff changeset
60
4726b640f221 Uploaded revision to update the citation
peterjc
parents: 4
diff changeset
61 For the associated RXLR Galaxy tool, please cite:
4726b640f221 Uploaded revision to update the citation
peterjc
parents: 4
diff changeset
62
4726b640f221 Uploaded revision to update the citation
peterjc
parents: 4
diff changeset
63 Peter J.A. Cock, Björn A. Grüning, Konrad Paszkiewicz and Leighton Pritchard (2013).
4726b640f221 Uploaded revision to update the citation
peterjc
parents: 4
diff changeset
64 Galaxy tools and workflows for sequence analysis with applications
4726b640f221 Uploaded revision to update the citation
peterjc
parents: 4
diff changeset
65 in molecular plant pathology. PeerJ 1:e167
4726b640f221 Uploaded revision to update the citation
peterjc
parents: 4
diff changeset
66 http://dx.doi.org/10.7717/peerj.167
4726b640f221 Uploaded revision to update the citation
peterjc
parents: 4
diff changeset
67
4726b640f221 Uploaded revision to update the citation
peterjc
parents: 4
diff changeset
68 For the three underlying methods, please cite:
4726b640f221 Uploaded revision to update the citation
peterjc
parents: 4
diff changeset
69
4726b640f221 Uploaded revision to update the citation
peterjc
parents: 4
diff changeset
70 Whisson, S.C., Boevink, C.V., Moleleki, L., et al. (2007)
4726b640f221 Uploaded revision to update the citation
peterjc
parents: 4
diff changeset
71 A translocation signal for delivery of oomycete effector proteins into
4726b640f221 Uploaded revision to update the citation
peterjc
parents: 4
diff changeset
72 host plant cells. Nature 450:115-118.
4726b640f221 Uploaded revision to update the citation
peterjc
parents: 4
diff changeset
73 http://dx.doi.org/10.1038/nature06203
4726b640f221 Uploaded revision to update the citation
peterjc
parents: 4
diff changeset
74
4726b640f221 Uploaded revision to update the citation
peterjc
parents: 4
diff changeset
75 Win, J., Morgan, W., Bos, J., et al. (2007)
4726b640f221 Uploaded revision to update the citation
peterjc
parents: 4
diff changeset
76 Adaptive evolution has targeted the C-terminal domain of the RXLR effectors
4726b640f221 Uploaded revision to update the citation
peterjc
parents: 4
diff changeset
77 of plant pathogenic oomycetes. The Plant Cell 19:2349-2369.
4726b640f221 Uploaded revision to update the citation
peterjc
parents: 4
diff changeset
78 http://dx.doi.org/10.1105/tpc.107.051037
4726b640f221 Uploaded revision to update the citation
peterjc
parents: 4
diff changeset
79
4726b640f221 Uploaded revision to update the citation
peterjc
parents: 4
diff changeset
80 Bhattacharjee, S., Luisa Hiller, N., Liolios, K., et al. (2006)
4726b640f221 Uploaded revision to update the citation
peterjc
parents: 4
diff changeset
81 The malarial host-targeting signal is conserved in the Irish potato famine
4726b640f221 Uploaded revision to update the citation
peterjc
parents: 4
diff changeset
82 pathogen. PLoS Pathogens 2(5):e50.
4726b640f221 Uploaded revision to update the citation
peterjc
parents: 4
diff changeset
83 http://dx.doi.org/10.1371/journal.ppat.0020050
3
1a1ab2f2b5b5 README file with clearer citation instructions.
peterjc
parents:
diff changeset
84
1a1ab2f2b5b5 README file with clearer citation instructions.
peterjc
parents:
diff changeset
85
1a1ab2f2b5b5 README file with clearer citation instructions.
peterjc
parents:
diff changeset
86 Dependencies
1a1ab2f2b5b5 README file with clearer citation instructions.
peterjc
parents:
diff changeset
87 ============
1a1ab2f2b5b5 README file with clearer citation instructions.
peterjc
parents:
diff changeset
88
1a1ab2f2b5b5 README file with clearer citation instructions.
peterjc
parents:
diff changeset
89 These dependencies should be resolved automatically via the Galaxy Tool Shed:
1a1ab2f2b5b5 README file with clearer citation instructions.
peterjc
parents:
diff changeset
90
1a1ab2f2b5b5 README file with clearer citation instructions.
peterjc
parents:
diff changeset
91 * http://toolshed.g2.bx.psu.edu/view/peterjc/tmhmm_and_signalp
1a1ab2f2b5b5 README file with clearer citation instructions.
peterjc
parents:
diff changeset
92 * http://toolshed.g2.bx.psu.edu/view/peterjc/seq_filter_by_id
1a1ab2f2b5b5 README file with clearer citation instructions.
peterjc
parents:
diff changeset
93 * http://toolshed.g2.bx.psu.edu/view/peterjc/venn_list
1a1ab2f2b5b5 README file with clearer citation instructions.
peterjc
parents:
diff changeset
94
1a1ab2f2b5b5 README file with clearer citation instructions.
peterjc
parents:
diff changeset
95 However, at the time of writing those Galaxy tools have their own dependencies
1a1ab2f2b5b5 README file with clearer citation instructions.
peterjc
parents:
diff changeset
96 required for this workflow which require manual installation (SignalP v3.0,
1a1ab2f2b5b5 README file with clearer citation instructions.
peterjc
parents:
diff changeset
97 HMMER v2.0, and the R/Bioconductor package limma).
1a1ab2f2b5b5 README file with clearer citation instructions.
peterjc
parents:
diff changeset
98
1a1ab2f2b5b5 README file with clearer citation instructions.
peterjc
parents:
diff changeset
99
4
3c280e01b920 Uploaded v0.0.2, bump tool version numbers to fix warning about Filter1 parameter, adding link to Tool Shed in annotation. No functional changes.
peterjc
parents: 3
diff changeset
100 History
3c280e01b920 Uploaded v0.0.2, bump tool version numbers to fix warning about Filter1 parameter, adding link to Tool Shed in annotation. No functional changes.
peterjc
parents: 3
diff changeset
101 =======
3c280e01b920 Uploaded v0.0.2, bump tool version numbers to fix warning about Filter1 parameter, adding link to Tool Shed in annotation. No functional changes.
peterjc
parents: 3
diff changeset
102
3c280e01b920 Uploaded v0.0.2, bump tool version numbers to fix warning about Filter1 parameter, adding link to Tool Shed in annotation. No functional changes.
peterjc
parents: 3
diff changeset
103 ======= ======================================================================
3c280e01b920 Uploaded v0.0.2, bump tool version numbers to fix warning about Filter1 parameter, adding link to Tool Shed in annotation. No functional changes.
peterjc
parents: 3
diff changeset
104 Version Changes
3c280e01b920 Uploaded v0.0.2, bump tool version numbers to fix warning about Filter1 parameter, adding link to Tool Shed in annotation. No functional changes.
peterjc
parents: 3
diff changeset
105 ------- ----------------------------------------------------------------------
3c280e01b920 Uploaded v0.0.2, bump tool version numbers to fix warning about Filter1 parameter, adding link to Tool Shed in annotation. No functional changes.
peterjc
parents: 3
diff changeset
106 v0.0.1 - Initial release to Tool Shed (May, 2013)
3c280e01b920 Uploaded v0.0.2, bump tool version numbers to fix warning about Filter1 parameter, adding link to Tool Shed in annotation. No functional changes.
peterjc
parents: 3
diff changeset
107 - Expanded README file to include example data
3c280e01b920 Uploaded v0.0.2, bump tool version numbers to fix warning about Filter1 parameter, adding link to Tool Shed in annotation. No functional changes.
peterjc
parents: 3
diff changeset
108 v0.0.2 - Updated versions of the tools used, inclulding core Galaxy Filter
3c280e01b920 Uploaded v0.0.2, bump tool version numbers to fix warning about Filter1 parameter, adding link to Tool Shed in annotation. No functional changes.
peterjc
parents: 3
diff changeset
109 tool to avoid warning about new ``header_lines`` parameter.
3c280e01b920 Uploaded v0.0.2, bump tool version numbers to fix warning about Filter1 parameter, adding link to Tool Shed in annotation. No functional changes.
peterjc
parents: 3
diff changeset
110 - Added link to Tool Shed in the workflow annotation explaining there
3c280e01b920 Uploaded v0.0.2, bump tool version numbers to fix warning about Filter1 parameter, adding link to Tool Shed in annotation. No functional changes.
peterjc
parents: 3
diff changeset
111 is a README file with sample data, and a requested citation.
5
4726b640f221 Uploaded revision to update the citation
peterjc
parents: 4
diff changeset
112 - Bundle sample output image for display in this README file.
4
3c280e01b920 Uploaded v0.0.2, bump tool version numbers to fix warning about Filter1 parameter, adding link to Tool Shed in annotation. No functional changes.
peterjc
parents: 3
diff changeset
113 ======= ======================================================================
3c280e01b920 Uploaded v0.0.2, bump tool version numbers to fix warning about Filter1 parameter, adding link to Tool Shed in annotation. No functional changes.
peterjc
parents: 3
diff changeset
114
3c280e01b920 Uploaded v0.0.2, bump tool version numbers to fix warning about Filter1 parameter, adding link to Tool Shed in annotation. No functional changes.
peterjc
parents: 3
diff changeset
115
3
1a1ab2f2b5b5 README file with clearer citation instructions.
peterjc
parents:
diff changeset
116 Developers
1a1ab2f2b5b5 README file with clearer citation instructions.
peterjc
parents:
diff changeset
117 ==========
1a1ab2f2b5b5 README file with clearer citation instructions.
peterjc
parents:
diff changeset
118
1a1ab2f2b5b5 README file with clearer citation instructions.
peterjc
parents:
diff changeset
119 This workflow is under source code control here:
1a1ab2f2b5b5 README file with clearer citation instructions.
peterjc
parents:
diff changeset
120
5
4726b640f221 Uploaded revision to update the citation
peterjc
parents: 4
diff changeset
121 https://github.com/peterjc/pico_galaxy/tree/master/workflows/rxlr_venn_workflow
3
1a1ab2f2b5b5 README file with clearer citation instructions.
peterjc
parents:
diff changeset
122
1a1ab2f2b5b5 README file with clearer citation instructions.
peterjc
parents:
diff changeset
123 To prepare the tar-ball for uploading to the Tool Shed, I use this:
1a1ab2f2b5b5 README file with clearer citation instructions.
peterjc
parents:
diff changeset
124
5
4726b640f221 Uploaded revision to update the citation
peterjc
parents: 4
diff changeset
125 $ tar -cf rxlr_venn_workflow.tar.gz README.rst repository_dependencies.xml rxlr_venn_workflow.ga Phyca11_example_output.png
3
1a1ab2f2b5b5 README file with clearer citation instructions.
peterjc
parents:
diff changeset
126
1a1ab2f2b5b5 README file with clearer citation instructions.
peterjc
parents:
diff changeset
127 Check this,
1a1ab2f2b5b5 README file with clearer citation instructions.
peterjc
parents:
diff changeset
128
1a1ab2f2b5b5 README file with clearer citation instructions.
peterjc
parents:
diff changeset
129 $ tar -tzf rxlr_venn_workflow.tar.gz
1a1ab2f2b5b5 README file with clearer citation instructions.
peterjc
parents:
diff changeset
130 README.rst
1a1ab2f2b5b5 README file with clearer citation instructions.
peterjc
parents:
diff changeset
131 repository_dependencies.xml
1a1ab2f2b5b5 README file with clearer citation instructions.
peterjc
parents:
diff changeset
132 rxlr_venn_workflow.ga
5
4726b640f221 Uploaded revision to update the citation
peterjc
parents: 4
diff changeset
133 Phyca11_example_output.png