annotate readme.md @ 3:75537a09e9fa draft

Uploaded
author bgruening
date Wed, 13 May 2015 18:33:49 -0400
parents 3070d71e0e5c
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
1 Galaxy wrapper for OpenMS
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
2 =========================
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
3
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
4 OpenMS is an open-source software C++ library for LC/MS data management and analyses.
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
5 It offers an infrastructure for the rapid development of mass spectrometry related software.
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
6 OpenMS is free software available under the three clause BSD license and runs under Windows, MacOSX and Linux.
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
7
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
8 More informations are available at:
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
9
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
10 * https://github.com/OpenMS/OpenMS
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
11 * http://open-ms.sourceforge.net
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
12
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
13
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
14 Installation
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
15 ============
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
16
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
17 Galaxy should be able to automatically install the dependencies, i.e.
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
18 'package_openms_2_0' or 'package_qt_4_8' repository.
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
19
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
20 The wrappers are included in https://testtoolshed.g2.bx.psu.edu/view/bgruening/openms.
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
21
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
22
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
23 Generating OpenMS wrappers
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
24 ==========================
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
25
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
26 * install OpenMS (you can do this automatically through the Tool Shed)
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
27 * create a folder called CTD
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
28 * inside of your new installed openms/bin folder, execute the following command:
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
29
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
30 ```bash
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
31 for binary in `ls`; do ./$binary -write_ctd /PATH/TO/YOUR/CTD; done;
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
32 ```
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
33
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
34 * clone or install CTDopts
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
35
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
36 ```bash
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
37 git clone https://github.com/genericworkflownodes/CTDopts
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
38 ```
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
39
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
40 * add CTDopts to your `$PYTHONPATH`
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
41
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
42 ```bash
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
43 export PYTHONPATH=/home/user/CTDopts/
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
44 ```
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
45
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
46 * clone or install GalaxyConfigGenerator
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
47
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
48 ```bash
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
49 git clone https://github.com/TorHou/GalaxyConfigGenerator.git
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
50 ```
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
51
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
52 * If you have CTDopts and GalaxyConfigGenerator installed you are ready to generate Galaxy Tools from CTD definitions
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
53
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
54 ```bash
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
55 python ./galaxyconfiggenerator/generator.py \
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
56 -i /PATH/TO/YOUR/CTD*.ctd \
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
57 -o ./wrappers -t tool.conf \
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
58 -d OpenMS -g proteomics \
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
59 -b version log debug test no_progress threads \
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
60 in_type exe executable myrimatch_executable \
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
61 omssa_executable pepnovo_executable \
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
62 xtandem_executable \
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
63 -l ListOfNeededTools.txt
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
64 ```
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
65
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
66 The list of needed Tools is a whitelist of all Tools that you want to create. It's simply a list of all tools separated by line breaks.
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
67 An example file is located under https://gist.github.com/bgruening/421f97d36c27443e5f35
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
68
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
69
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
70 * As last step you need to change manually the binary names of all external binaries you want to use in OpenMS. For example:
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
71
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
72 ```
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
73 sed -i '10 a\-exe fido' wrappers/FidoAdapter.xml
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
74 sed -i '10 a\-executable msgfplus.jar' wrappers/MSGFPlusAdapter.xml
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
75 sed -i '10 a\-myrimatch_executable myrimatch' wrappers/MyriMatchAdapter.xml
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
76 sed -i '10 a\-omssa_executable omssa' wrappers/OMSSAAdapter.xml
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
77 sed -i '10 a\-pepnovo_executable pepnovo' wrappers/PepNovoAdapter.xml
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
78 sed -i '10 a\-xtandem_executable xtandem' wrappers/XTandemAdapter.xml
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
79 ```
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
80
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
81 Licence (MIT)
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
82 =============
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
83
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
84 Permission is hereby granted, free of charge, to any person obtaining a copy
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
85 of this software and associated documentation files (the "Software"), to deal
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
86 in the Software without restriction, including without limitation the rights
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
87 to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
88 copies of the Software, and to permit persons to whom the Software is
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
89 furnished to do so, subject to the following conditions:
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
90
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
91 The above copyright notice and this permission notice shall be included in
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
92 all copies or substantial portions of the Software.
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
93
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
94 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
95 IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
96 FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
97 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
98 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
99 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
100 THE SOFTWARE.
3070d71e0e5c Uploaded
bgruening
parents:
diff changeset
101