annotate README.rst @ 3:df54f8fcc7a7 draft

Version 1.0.2-3: move to conda-based dependency resolution.
author pjbriggs
date Wed, 28 Feb 2018 10:22:32 -0500
parents d2283cca00cd
children cd6a48ffd093
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
1 CEAS: Cis-regulatory Element Annotation System
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
2 ==============================================
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
3
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
4 Galaxy tool wrapper for the CEAS (Cis-regulatory Element Annotation System), which
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
5 can be used to annotate intervals and scores with genome features.
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
6
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
7 This tool uses the Cistrome version of the package, which provides two versions of
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
8 the core program: in addition to the ``ceas`` program (the same as that available
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
9 from the main CEAS website), it also includes the ``ceasBW`` program (which can handle
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
10 bigwig input).
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
11
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
12 The tool assumes that the ``ceas`` and ``ceasBW`` programs are on the Galaxy user's
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
13 path.
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
14
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
15 The official CEAS website is at:
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
16
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
17 - http://liulab.dfci.harvard.edu/CEAS/index.html
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
18
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
19 The Cistrome version can be found via
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
20
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
21 - https://bitbucket.org/cistrome/cistrome-applications-harvard/overview
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
22
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
23 Automated installation
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
24 ======================
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
25
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
26 Installation via the Galaxy Tool Shed will take care of installing the tool wrapper
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
27 and the CEAS programs, and setting the appropriate environment variables.
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
28
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
29 In addition this will also install a data manager which can be used to install
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
30 reference GDB data files necessary for the tool.
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
31
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
32 Manual Installation
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
33 ===================
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
34
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
35 There are two files to install:
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
36
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
37 - ``ceas_wrapper.xml`` (the Galaxy tool definition)
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
38 - ``ceas_wrapper.sh`` (the shell script wrapper)
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
39
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
40 The suggested location is in a ``tools/ceas/`` folder. You will then
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
41 need to modify the ``tools_conf.xml`` file to tell Galaxy to offer the tool
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
42 by adding the line:
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
43
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
44 <tool file="ceas/ceasbw_wrapper.xml" />
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
45
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
46 You also need to make a copy of the ``ceas.loc`` file (a sample version is
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
47 provided here) which points to the available GDB files for different genomes.
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
48
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
49 This file should be placed in the ``tool-data`` directory of your Galaxy
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
50 installation.
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
51
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
52 Reference Data
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
53 ==============
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
54
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
55 CEAS requires reference data in the form of GDB files (essentially, SQLite database
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
56 files) containing the RefSeq genes for the genome in question.
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
57
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
58 A limited number of GDB files are available for download from the CEAS website; to
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
59 make new ones, see the section "Build a sqlite3 file with a gene annotation table
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
60 and genome background annotation for CEAS" in the CEAS manual:
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
61
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
62 - http://liulab.dfci.harvard.edu/CEAS/usermanual.html
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
63
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
64 History
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
65 =======
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
66
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
67 ========== ======================================================================
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
68 Version Changes
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
69 ---------- ----------------------------------------------------------------------
3
df54f8fcc7a7 Version 1.0.2-3: move to conda-based dependency resolution.
pjbriggs
parents: 2
diff changeset
70 1.0.2-3 - Updated to fetch all dependencies from conda
0
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
71 1.0.2-2 - Major updates to fix various bugs, add tests and enable ceasBW to
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
72 be used without an existing chromosome sizes file.
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
73 1.0.2-1 - Modified to work with Cistrome-version of CEAS (includes additional
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
74 'ceasBW' program which can take bigWig input)
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
75 1.0.2-0 - Initial version.
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
76 ========== ======================================================================
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
77
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
78 Developers
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
79 ==========
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
80
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
81 This tool is developed on the following GitHub repository:
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
82 https://github.com/fls-bioinformatics-core/galaxy-tools/tree/master/ceas
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
83
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
84 For making the "Galaxy Tool Shed" http://toolshed.g2.bx.psu.edu/ tarball I use
f411ce97a351 Uploaded initial version 1.0.2-2
pjbriggs
parents:
diff changeset
85 the ``package_ceas.sh`` script.