Statistiques
| Branche: | Révision :

root / doc / sphinx_doc / readme.rst @ e5603c3f

Historique | Voir | Annoter | Télécharger (3,78 ko)

1 935a568c Florent Chuffart
*****************************************
2 935a568c Florent Chuffart
Readme / Documentation for `NucleoMiner2`
3 935a568c Florent Chuffart
*****************************************
4 935a568c Florent Chuffart
5 e5603c3f Florent Chuffart
`NucleoMiner2` offers Python API and R package allowing to perform quantitative analysis of epigenetic marks on individual nucleosomes. It was developed to detect natural Single-Nucleosome Epi-Polymorphisms (SNEP) from MNase-seq and ChIP-seq data.
6 935a568c Florent Chuffart
7 935a568c Florent Chuffart
License
8 935a568c Florent Chuffart
=======
9 935a568c Florent Chuffart
10 e5603c3f Florent Chuffart
Copyright CNRS 2012-2013
11 e5603c3f Florent Chuffart
12 e5603c3f Florent Chuffart
- Florent CHUFFART
13 e5603c3f Florent Chuffart
- Jean-Baptiste VEYRIERAS
14 e5603c3f Florent Chuffart
- Gael YVERT
15 e5603c3f Florent Chuffart
16 935a568c Florent Chuffart
This software is a computer program which purpose is to perform quanti-
17 e5603c3f Florent Chuffart
tative analysis of epigenetic marks at single nucleosome resolution.
18 e5603c3f Florent Chuffart
19 e5603c3f Florent Chuffart
This software is governed by the CeCILL license under French law and
20 e5603c3f Florent Chuffart
abiding by the rules of distribution of free software.  You can  use,
21 e5603c3f Florent Chuffart
modify and/ or redistribute the software under the terms of the CeCILL
22 e5603c3f Florent Chuffart
license as circulated by CEA, CNRS and INRIA at the following URL
23 e5603c3f Florent Chuffart
"http://www.cecill.info".
24 e5603c3f Florent Chuffart
25 e5603c3f Florent Chuffart
As a counterpart to the access to the source code and  rights to copy,
26 e5603c3f Florent Chuffart
modify and redistribute granted by the license, users are provided only
27 e5603c3f Florent Chuffart
with a limited warranty  and the software's author,  the holder of the
28 e5603c3f Florent Chuffart
economic rights,  and the successive licensors  have only  limited
29 e5603c3f Florent Chuffart
liability.
30 e5603c3f Florent Chuffart
31 e5603c3f Florent Chuffart
This software is provided with absolutely NO WARRANTY. The authors can not be held responsible, even partially, for any damage, loss, financial loss or any other undesired facts resulting from the use of the software.
32 e5603c3f Florent Chuffart
In this respect, the user's attention is drawn to the risks associated
33 e5603c3f Florent Chuffart
with loading,  using,  modifying and/or developing or reproducing the
34 e5603c3f Florent Chuffart
software by the user in light of its specific status of free software,
35 e5603c3f Florent Chuffart
that may mean  that it is complicated to manipulate,  and  that  also
36 e5603c3f Florent Chuffart
therefore means  that it is reserved for developers  and  experienced
37 e5603c3f Florent Chuffart
professionals having in-depth computer knowledge. Users are therefore
38 e5603c3f Florent Chuffart
encouraged to load and test the software's suitability as regards their
39 e5603c3f Florent Chuffart
requirements in conditions enabling the security of their systems and/or
40 e5603c3f Florent Chuffart
data to be ensured and,  more generally, to use and operate it in the
41 e5603c3f Florent Chuffart
same conditions as regards security.
42 e5603c3f Florent Chuffart
43 e5603c3f Florent Chuffart
The fact that you are presently reading this means that you have had
44 e5603c3f Florent Chuffart
knowledge of the CeCILL license and that you accept its terms.
45 935a568c Florent Chuffart
46 935a568c Florent Chuffart
Installation Instructions
47 935a568c Florent Chuffart
=========================
48 935a568c Florent Chuffart
49 935a568c Florent Chuffart
Links
50 935a568c Florent Chuffart
-----
51 935a568c Florent Chuffart
52 e5603c3f Florent Chuffart
`NucleoMiner2` home page and documentation are available here:
53 e5603c3f Florent Chuffart
54 e5603c3f Florent Chuffart
  - https://forge.cbp.ens-lyon.fr/redmine/projects/nucleominer
55 e5603c3f Florent Chuffart
56 e5603c3f Florent Chuffart
The Yvert lab web page is accessible here:
57 935a568c Florent Chuffart
58 e5603c3f Florent Chuffart
  - http://www.ens-lyon.fr/LBMC/gisv/
59 935a568c Florent Chuffart
60 935a568c Florent Chuffart
61 935a568c Florent Chuffart
Installation
62 935a568c Florent Chuffart
------------
63 935a568c Florent Chuffart
64 e5603c3f Florent Chuffart
The first installation step is to retrieve the source code of MyLabStocks. You can do this by typing the following command in a terminal.
65 e5603c3f Florent Chuffart
66 e5603c3f Florent Chuffart
.. code:: bash
67 e5603c3f Florent Chuffart
68 e5603c3f Florent Chuffart
  git clone http://forge.cbp.ens-lyon.fr/git/nucleominer
69 e5603c3f Florent Chuffart
..
70 e5603c3f Florent Chuffart
71 e5603c3f Florent Chuffart
72 e5603c3f Florent Chuffart
Prerequisites
73 e5603c3f Florent Chuffart
^^^^^^^^^^^^^
74 e5603c3f Florent Chuffart
75 e5603c3f Florent Chuffart
To work properly, NucleoMiner2 needs that the following free software are installed and made available on your system:
76 e5603c3f Florent Chuffart
77 e5603c3f Florent Chuffart
 - Bowtie2 http://bowtie-bio.sourceforge.net/bowtie2
78 e5603c3f Florent Chuffart
 - SAMtools http://samtools.sourceforge.net
79 e5603c3f Florent Chuffart
 - bedtools http://code.google.com/p/bedtools/
80 e5603c3f Florent Chuffart
 - TemplateFilter http://compbio.cs.huji.ac.il/NucPosition/TemplateFiltering
81 e5603c3f Florent Chuffart
82 e5603c3f Florent Chuffart
It also requires the following R packages to be installed on your system:
83 935a568c Florent Chuffart
84 dadb6a4d Florent Chuffart
 - fork
85 935a568c Florent Chuffart
 - rjson
86 935a568c Florent Chuffart
 - seqinr
87 e5603c3f Florent Chuffart
 - cachecache https://forge.cbp.ens-lyon.fr/redmine/projects/cachecache
88 e5603c3f Florent Chuffart
 - bot https://forge.cbp.ens-lyon.fr/redmine/projects/bot
89 e5603c3f Florent Chuffart
 - nucleominer https://forge.cbp.ens-lyon.fr/redmine/projects/nucleominer
90 e5603c3f Florent Chuffart
 
91 e5603c3f Florent Chuffart
The first packages could be installed by typing the following command in an R console:
92 e5603c3f Florent Chuffart
93 e5603c3f Florent Chuffart
94 e5603c3f Florent Chuffart
 
95 e5603c3f Florent Chuffart
The last packages are available in the git repository they could be install by typing the following command in your terminal:
96 935a568c Florent Chuffart
97 935a568c Florent Chuffart
.. code:: bash
98 935a568c Florent Chuffart
99 e5603c3f Florent Chuffart
  cd nucleominer
100 e5603c3f Florent Chuffart
   R CMD INSTALL doc/Chuffart_NM2_workdir/deps/bot_0.14.tar.gz\
101 e5603c3f Florent Chuffart
      doc/Chuffart_NM2_workdir/deps/cachecache_0.1.tar.gz\
102 e5603c3f Florent Chuffart
      build/nucleominer_2.XXX.tar.gz 
103 e5603c3f Florent Chuffart
      
104 e5603c3f Florent Chuffart