annotate hub-archive-creator/README.md @ 6:9193fe3ee73f draft default tip

Uploaded
author yating-l
date Thu, 22 Dec 2016 15:59:24 -0500
parents
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
6
9193fe3ee73f Uploaded
yating-l
parents:
diff changeset
1 # Hub Archive Creator
9193fe3ee73f Uploaded
yating-l
parents:
diff changeset
2 This Galaxy tool permits to prepare your files to be ready for Assembly Hub visualization.
9193fe3ee73f Uploaded
yating-l
parents:
diff changeset
3
9193fe3ee73f Uploaded
yating-l
parents:
diff changeset
4 Into a publicly accessible Galaxy (Linux for maximum tools compatibility), you will be able to use UCSC Genome Browser fonctionality to see your tracks.
9193fe3ee73f Uploaded
yating-l
parents:
diff changeset
5
9193fe3ee73f Uploaded
yating-l
parents:
diff changeset
6 ## Features
9193fe3ee73f Uploaded
yating-l
parents:
diff changeset
7 1. Create a structure for your tracks, and convert them to more efficient datatypes (e.g Bed => BigBed)
9193fe3ee73f Uploaded
yating-l
parents:
diff changeset
8 2. Benefits from Galaxy strong features as well as UCSC Genome Browser's ones without the hassle to move your data from one to another
9193fe3ee73f Uploaded
yating-l
parents:
diff changeset
9 3. Download and store, as a zip file, your tracks structured for UCSC TrackHub use
9193fe3ee73f Uploaded
yating-l
parents:
diff changeset
10 4. Create workflows within Galaxy to automatize pipeline analysis and get them ready to visualization inside UCSC Genome Browser...in a few clicks!
9193fe3ee73f Uploaded
yating-l
parents:
diff changeset
11
9193fe3ee73f Uploaded
yating-l
parents:
diff changeset
12 At the moment, Supported datatypes are:
9193fe3ee73f Uploaded
yating-l
parents:
diff changeset
13 - Bam
9193fe3ee73f Uploaded
yating-l
parents:
diff changeset
14 - Bed (Generic and Simple Repeats)
9193fe3ee73f Uploaded
yating-l
parents:
diff changeset
15 - BigWig
9193fe3ee73f Uploaded
yating-l
parents:
diff changeset
16 - Gff3
9193fe3ee73f Uploaded
yating-l
parents:
diff changeset
17 - Gtf
9193fe3ee73f Uploaded
yating-l
parents:
diff changeset
18 - Psl
9193fe3ee73f Uploaded
yating-l
parents:
diff changeset
19
9193fe3ee73f Uploaded
yating-l
parents:
diff changeset
20 ## Installation:
9193fe3ee73f Uploaded
yating-l
parents:
diff changeset
21 1. You would need to add this tool into your Galaxy.
9193fe3ee73f Uploaded
yating-l
parents:
diff changeset
22 1. (strongly preferred) **ToolShed Installation**: Tool is in [toolshed](https://toolshed.g2.bx.psu.edu/view/rmarenco/hubarchivecreator/fb5e60d4d18a)
9193fe3ee73f Uploaded
yating-l
parents:
diff changeset
23 2. OR **Local Installation**: See https://wiki.galaxyproject.org/Admin/Tools/AddToolTutorial
9193fe3ee73f Uploaded
yating-l
parents:
diff changeset
24 2. The tool can be used with or without Conda (activate it in your galaxy.ini)
9193fe3ee73f Uploaded
yating-l
parents:
diff changeset
25 3. If installed without TS (by downloading on GitHub), you need to have all the binaries accessible within Galaxy.
9193fe3ee73f Uploaded
yating-l
parents:
diff changeset
26 You can use the script [install_linux_binaries](util/install_linux_binaries) with a linux x86-64 (64bits)
9193fe3ee73f Uploaded
yating-l
parents:
diff changeset
27 4. Install the UCSC Track Hub datatype:
9193fe3ee73f Uploaded
yating-l
parents:
diff changeset
28 1. **Easy** => Use Galaxy 16.07 or latest to directly have Track Hub Datatype (See [this Galaxy Pull Request](https://github.com/galaxyproject/galaxy/pull/2348) for more information)
9193fe3ee73f Uploaded
yating-l
parents:
diff changeset
29 2. OR Look into [trackHub README](trackHub/README.md) for more information or if you want to use Galaxy < 16.07
9193fe3ee73f Uploaded
yating-l
parents:
diff changeset
30
9193fe3ee73f Uploaded
yating-l
parents:
diff changeset
31 ### Binaries used by HAC:
9193fe3ee73f Uploaded
yating-l
parents:
diff changeset
32 - bedToBigBed
9193fe3ee73f Uploaded
yating-l
parents:
diff changeset
33 - faToTwoBit
9193fe3ee73f Uploaded
yating-l
parents:
diff changeset
34 - genePredToBed
9193fe3ee73f Uploaded
yating-l
parents:
diff changeset
35 - genePredToBigGenePred
9193fe3ee73f Uploaded
yating-l
parents:
diff changeset
36 - gff3ToGenePred
9193fe3ee73f Uploaded
yating-l
parents:
diff changeset
37 - gtfToGenePred
9193fe3ee73f Uploaded
yating-l
parents:
diff changeset
38 - pslToBigPsl
9193fe3ee73f Uploaded
yating-l
parents:
diff changeset
39 - samtools
9193fe3ee73f Uploaded
yating-l
parents:
diff changeset
40 - sort
9193fe3ee73f Uploaded
yating-l
parents:
diff changeset
41 - twoBitInfo
9193fe3ee73f Uploaded
yating-l
parents:
diff changeset
42 See `<requirements` in [tool_dependencies.xml](tool_dependencies.xml) for an up-to-date used binaries list
9193fe3ee73f Uploaded
yating-l
parents:
diff changeset
43
9193fe3ee73f Uploaded
yating-l
parents:
diff changeset
44 ## Future
9193fe3ee73f Uploaded
yating-l
parents:
diff changeset
45 See [TODO.md](todo.md) for more information
9193fe3ee73f Uploaded
yating-l
parents:
diff changeset
46
9193fe3ee73f Uploaded
yating-l
parents:
diff changeset
47 ## Contribute
9193fe3ee73f Uploaded
yating-l
parents:
diff changeset
48
9193fe3ee73f Uploaded
yating-l
parents:
diff changeset
49 - Issue Tracker: https://github.com/remimarenco/hub-archive-creator/issues
9193fe3ee73f Uploaded
yating-l
parents:
diff changeset
50 - Source Code: https://github.com/remimarenco/hub-archive-creator
9193fe3ee73f Uploaded
yating-l
parents:
diff changeset
51
9193fe3ee73f Uploaded
yating-l
parents:
diff changeset
52 ## Support
9193fe3ee73f Uploaded
yating-l
parents:
diff changeset
53
9193fe3ee73f Uploaded
yating-l
parents:
diff changeset
54 If you are having issues, please let us know.
9193fe3ee73f Uploaded
yating-l
parents:
diff changeset
55
9193fe3ee73f Uploaded
yating-l
parents:
diff changeset
56 - For more information about how to use G-OnRamp:
9193fe3ee73f Uploaded
yating-l
parents:
diff changeset
57 - [Wilson Leung](wleung@wustl.edu) - Product owner and developer
9193fe3ee73f Uploaded
yating-l
parents:
diff changeset
58 - [Yating Liu](yliu41@wustl.edu) - Community manager and Developer
9193fe3ee73f Uploaded
yating-l
parents:
diff changeset
59 - [Remi Marenco](remimarenco@gmail.com) - Main developer and Scrum Master
9193fe3ee73f Uploaded
yating-l
parents:
diff changeset
60
9193fe3ee73f Uploaded
yating-l
parents:
diff changeset
61 - For more information about the project vision, or for partneship:
9193fe3ee73f Uploaded
yating-l
parents:
diff changeset
62 - [Elgin, Sarah](selgin@wustl.edu) - PI
9193fe3ee73f Uploaded
yating-l
parents:
diff changeset
63 - [Jeremy Goecks](jgoecks@gwu.edu) - PI
9193fe3ee73f Uploaded
yating-l
parents:
diff changeset
64
9193fe3ee73f Uploaded
yating-l
parents:
diff changeset
65 ## License
9193fe3ee73f Uploaded
yating-l
parents:
diff changeset
66
9193fe3ee73f Uploaded
yating-l
parents:
diff changeset
67 The project is licensed under the Academic Free License 3.0. See [LICENSE.txt](LICENSE.txt).