annotate README.md @ 4:e2b68db3177c draft

planemo upload
author mingchen0919
date Sun, 01 Apr 2018 18:19:04 -0400
parents 1aeef205e648
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
1
1aeef205e648 planemo upload
mingchen0919
parents:
diff changeset
1 # Elastic Galaxy Tools
1aeef205e648 planemo upload
mingchen0919
parents:
diff changeset
2
1aeef205e648 planemo upload
mingchen0919
parents:
diff changeset
3 * [What are Elastic Galaxy Tools](#what-are-elastic-galaxy-tools?)
1aeef205e648 planemo upload
mingchen0919
parents:
diff changeset
4 * [How to use Elastic Galaxy Tools](#how-to-use-elastic-galaxy-tools?)
1aeef205e648 planemo upload
mingchen0919
parents:
diff changeset
5 * [How to develop an Elastic Galaxy Tool](#how-to-develop-an-elastic-galaxy-tool?)
1aeef205e648 planemo upload
mingchen0919
parents:
diff changeset
6 + [Publish a Galaxy Tool](#publish-a-galaxy-tool)
1aeef205e648 planemo upload
mingchen0919
parents:
diff changeset
7
1aeef205e648 planemo upload
mingchen0919
parents:
diff changeset
8
1aeef205e648 planemo upload
mingchen0919
parents:
diff changeset
9
1aeef205e648 planemo upload
mingchen0919
parents:
diff changeset
10
1aeef205e648 planemo upload
mingchen0919
parents:
diff changeset
11 ## What are Elastic Galaxy Tools?
1aeef205e648 planemo upload
mingchen0919
parents:
diff changeset
12
1aeef205e648 planemo upload
mingchen0919
parents:
diff changeset
13 **Elastic Galaxy tools** is a type of Galaxy tools that have elastic user interfaces. Users can adjust the
1aeef205e648 planemo upload
mingchen0919
parents:
diff changeset
14 number of input fields a tool can have, just like using a command line tool. When using a command line tool,
1aeef205e648 planemo upload
mingchen0919
parents:
diff changeset
15 users can choose which (non-required) options to use. I hope Galaxy users can do the same thing, but without
1aeef205e648 planemo upload
mingchen0919
parents:
diff changeset
16 actually writing any command line scripts.
1aeef205e648 planemo upload
mingchen0919
parents:
diff changeset
17
1aeef205e648 planemo upload
mingchen0919
parents:
diff changeset
18
1aeef205e648 planemo upload
mingchen0919
parents:
diff changeset
19 ## How to use Elastic Galaxy Tools?
1aeef205e648 planemo upload
mingchen0919
parents:
diff changeset
20
1aeef205e648 planemo upload
mingchen0919
parents:
diff changeset
21 Although any (Elastic) Galaxy tool is a wrapper of a command line tool which enables performing data analysis
1aeef205e648 planemo upload
mingchen0919
parents:
diff changeset
22 through web interfaces without actually writing any command line script, understanding how to read command line
1aeef205e648 planemo upload
mingchen0919
parents:
diff changeset
23 manuals will help you use Elastic Galaxy tools.
1aeef205e648 planemo upload
mingchen0919
parents:
diff changeset
24
1aeef205e648 planemo upload
mingchen0919
parents:
diff changeset
25 Running a command line tool is very simple. You start with the tool name, then you specify options (also called flags)
1aeef205e648 planemo upload
mingchen0919
parents:
diff changeset
26 that the tool can recognize. The tool manual should tell you which options the tool can recognize. An option may or may
1aeef205e648 planemo upload
mingchen0919
parents:
diff changeset
27 not have a value followed. Some options are required and some are optional. You have to use all required options to
1aeef205e648 planemo upload
mingchen0919
parents:
diff changeset
28 successfully run a command line tool. However, you can use as many optional options as you want in a call of a command
1aeef205e648 planemo upload
mingchen0919
parents:
diff changeset
29 line tool.
1aeef205e648 planemo upload
mingchen0919
parents:
diff changeset
30
1aeef205e648 planemo upload
mingchen0919
parents:
diff changeset
31 ## How to develop an Elastic Galaxy Tool?
1aeef205e648 planemo upload
mingchen0919
parents:
diff changeset
32
1aeef205e648 planemo upload
mingchen0919
parents:
diff changeset
33 ### Publish a Galaxy tool
1aeef205e648 planemo upload
mingchen0919
parents:
diff changeset
34
1aeef205e648 planemo upload
mingchen0919
parents:
diff changeset
35 We can use the tool **planemo** to easily publish our Galaxy tools to Tool Shed or test Tool Shed.
1aeef205e648 planemo upload
mingchen0919
parents:
diff changeset
36 More details can be found **[here](http://planemo.readthedocs.io/en/latest/publishing.html)**.
1aeef205e648 planemo upload
mingchen0919
parents:
diff changeset
37
1aeef205e648 planemo upload
mingchen0919
parents:
diff changeset
38 * Publish to test Tool Shed
1aeef205e648 planemo upload
mingchen0919
parents:
diff changeset
39
1aeef205e648 planemo upload
mingchen0919
parents:
diff changeset
40 ```bash
1aeef205e648 planemo upload
mingchen0919
parents:
diff changeset
41 planemo shed_create --shed_target testtoolshed
1aeef205e648 planemo upload
mingchen0919
parents:
diff changeset
42 ```
1aeef205e648 planemo upload
mingchen0919
parents:
diff changeset
43
1aeef205e648 planemo upload
mingchen0919
parents:
diff changeset
44 * Update tool repository in test Tool Shed
1aeef205e648 planemo upload
mingchen0919
parents:
diff changeset
45
1aeef205e648 planemo upload
mingchen0919
parents:
diff changeset
46 ```bash
1aeef205e648 planemo upload
mingchen0919
parents:
diff changeset
47 planemo shed_update --check_diff --shed_target testtoolshed
1aeef205e648 planemo upload
mingchen0919
parents:
diff changeset
48 ```
1aeef205e648 planemo upload
mingchen0919
parents:
diff changeset
49
1aeef205e648 planemo upload
mingchen0919
parents:
diff changeset
50 * Publish to Tool Shed
1aeef205e648 planemo upload
mingchen0919
parents:
diff changeset
51
1aeef205e648 planemo upload
mingchen0919
parents:
diff changeset
52 ```bash
1aeef205e648 planemo upload
mingchen0919
parents:
diff changeset
53 planemo shed_create --shed_target toolshed
1aeef205e648 planemo upload
mingchen0919
parents:
diff changeset
54 ```
1aeef205e648 planemo upload
mingchen0919
parents:
diff changeset
55
1aeef205e648 planemo upload
mingchen0919
parents:
diff changeset
56 * Update tool repository in Tool Shed
1aeef205e648 planemo upload
mingchen0919
parents:
diff changeset
57
1aeef205e648 planemo upload
mingchen0919
parents:
diff changeset
58 ```bash
1aeef205e648 planemo upload
mingchen0919
parents:
diff changeset
59 planemo shed_update --check_diff --shed_target toolshed
1aeef205e648 planemo upload
mingchen0919
parents:
diff changeset
60 ```
1aeef205e648 planemo upload
mingchen0919
parents:
diff changeset
61
1aeef205e648 planemo upload
mingchen0919
parents:
diff changeset
62
1aeef205e648 planemo upload
mingchen0919
parents:
diff changeset
63