annotate README.rst @ 5:14561eb803a5 draft

Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
author peterjc
date Fri, 21 Oct 2016 10:55:40 -0400
parents
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
5
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
1 Galaxy Wrapper for GMAP
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
2 =======================
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
3
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
4 This wrapper is copyright 2011, 2013 by Jim Johnson (Minnesota Supercomputing
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
5 Institute, University of Minnesota).
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
6 Revisions copyright 2016 by Peter Cock (The James Hutton Institute, UK).
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
7
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
8 This Galaxy wrapper is available from the Galaxy Tool Shed at:
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
9
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
10 toolshed.g2.bx.psu.edu/view/jjohnson/gmap
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
11
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
12 GMAP applications and citation info are available from:
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
13 ttp://research-pub.gene.com/gmap/
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
14
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
15 Manual GMAP installation instructions are in the README file in the download,
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
16 and online: http://research-pub.gene.com/gmap/src/README
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
17
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
18
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
19 History
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
20 =======
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
21
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
22 ======= ======================================================================
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
23 Version Changes
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
24 ------- ----------------------------------------------------------------------
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
25 v2.0.0 - Initial release, for GMAP version 2011-10-07 (by JJ, October 2011).
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
26 v2.0.1 - Updated for GMAP version 2011-11-30 (by JJ, November 2011).
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
27 v3.0.0 - Work in progress for GMAP version 2013-05-09 (by JJ, June 2013),
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
28 never released to the main Galaxy Tool Shed.
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
29 v3.0.1 - Various style updates (Peter Cock, October 2016).
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
30 ======= ======================================================================
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
31
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
32
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
33 Automated Installation
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
34 ======================
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
35
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
36 This should be straightforward using the Galaxy Tool Shed, which should be
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
37 able to automatically install GMAP as well.
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
38
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
39
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
40
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
41 Manual Installation
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
42 ===================
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
43
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
44 GMAP and GSNAP use added datatypes:
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
45
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
46 - add datatype definition file: ``lib/galaxy/datatypes/gmap.py``
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
47
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
48 - add the following import line to: ``lib/galaxy/datatypes/registry.py``::
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
49
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
50 import gmap # added for gmap tools
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
51
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
52 - add to ``datatypes_conf.xml``::
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
53
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
54 <!-- Start GMAP Datatypes -->
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
55 <datatype extension="gmapdb" type="galaxy.datatypes.gmap:GmapDB" display_in_upload="False"/>
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
56 <datatype extension="gmapsnpindex" type="galaxy.datatypes.gmap:GmapSnpIndex" display_in_upload="False"/>
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
57 <datatype extension="iit" type="galaxy.datatypes.gmap:IntervalIndexTree" display_in_upload="True"/>
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
58 <datatype extension="splicesites.iit" type="galaxy.datatypes.gmap:SpliceSitesIntervalIndexTree" display_in_upload="True"/>
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
59 <datatype extension="introns.iit" type="galaxy.datatypes.gmap:IntronsIntervalIndexTree" display_in_upload="True"/>
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
60 <datatype extension="snps.iit" type="galaxy.datatypes.gmap:SNPsIntervalIndexTree" display_in_upload="True"/>
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
61 <datatype extension="tally.iit" type="galaxy.datatypes.gmap:TallyIntervalIndexTree" display_in_upload="True"/>
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
62 <datatype extension="gmap_annotation" type="galaxy.datatypes.gmap:IntervalAnnotation" display_in_upload="False"/>
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
63 <datatype extension="gmap_splicesites" type="galaxy.datatypes.gmap:SpliceSiteAnnotation" display_in_upload="True"/>
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
64 <datatype extension="gmap_introns" type="galaxy.datatypes.gmap:IntronAnnotation" display_in_upload="True"/>
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
65 <datatype extension="gmap_snps" type="galaxy.datatypes.gmap:SNPAnnotation" display_in_upload="True"/>
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
66 <datatype extension="gsnap_tally" type="galaxy.datatypes.gmap:TallyAnnotation" display_in_upload="True"/>
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
67 <datatype extension="gsnap" type="galaxy.datatypes.gmap:GsnapResult" display_in_upload="True"/>
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
68 <!-- End GMAP Datatypes -->
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
69
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
70 Tools:
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
71
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
72 - GMAP_Build - create a GmapDB set of index files for a reference sequence and optional set of annotations
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
73 - GMAP - map sequences to a reference sequence GmapDB index
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
74 - GSNAP - align sequences to a reference and detect splicing
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
75
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
76 Add to ``tool_conf.xml`` (probably in the "NGS: Mapping" section)::
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
77
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
78 <tool file="gmap/gmap.xml" />
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
79 <tool file="gmap/gsnap.xml" />
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
80 <tool file="gmap/gmap_build.xml" />
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
81 <tool file="gmap/snpindex.xml" />
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
82 <tool file="gmap/iit_store.xml" />
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
83
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
84 Admin built cached gmapdb indexes defined in ``tool-data/gmap_indices.loc``
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
85
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
86
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
87 TODO
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
88 ====
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
89
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
90 - Add classes to ``gmap.py``
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
91
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
92 - CmetIndex - an index created by cmetindex
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
93 - AtoiIndex - an index created by atoiindex
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
94
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
95 - Add tally creation
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
96
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
97 - gsnap default output -> gsnap_tally -> iit_store
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
98
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
99 - Add goby support
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
100
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
101 - Should add separate tools and datatypes for goby
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
102 - GSNAP goby output relies on goby input, might be better to have a separate gsnap tool for goby
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
103
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
104 - Possibly add Tools:
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
105
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
106 - get_genome - retrieves from a gmapdb
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
107 - cmetindex - create methylcytosine index
14561eb803a5 Uploaded v3.0.1b (still working on this prior to main Tool Shed release)
peterjc
parents:
diff changeset
108 - atoiindex - create A-to-I RNA editing index