This repository has been archived by the owner on Feb 6, 2018. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 2
/
README.txt
122 lines (90 loc) · 4.31 KB
/
README.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
DISCLAIMER
-------------------------------------------------------------------------------
MLML has become part of METHPIPE (https://github.com/smithlabcode/methpipe),
and is actively managed in METHPIPE. This stand-alone MLML repository is no
longer maintained as of Feb 2018.
For more details, please read the user manual in docs/manual.pdf
PREREQUISITES
-------------------------------------------------------------------------------
GNU Compiler Collection (GCC)
This software requires a C++ complier to build. The most recent version of
GCC is highly recommended. You can find it at http://gcc.gnu.org/
GNU Scientific Library (GSL)
This software package requires a functioning installation of the GNU
Scientific Library (GSL). If you don't already have this installed, you
will need to download and install it from http://www.gnu.org/software/gsl/
INSTALLATION
-------------------------------------------------------------------------------
This software package is developed in UNIX environment. It has been tested
in Mac OSX and Linux.
(1) To build binaries, type the following command in mlml root directory:
make
(2) To install binaries, after building type the following command:
make install
If no ERROR messages prompts during the two steps, then your copy of mlml
has been installed successfully.
USAGE
-------------------------------------------------------------------------------
-o, -output
Specify the output file path. If this option is not given, then the output
will be directed to screen output.
-u, -bsseq
Specify the input file path for BS-seq file. The input file format should be
BED format.
-h, -tabseq
Specify the input file path for Tab-seq file. The input file format should be
BED format.
-m, -oxbsseq
Specify the input file path for oxBS-seq file. The input file format should be
BED format.
* Note: at least two of -u, -h and -m options are required.
-t, -tolerance
Specify the convergence tolerance of EM algorithm. Default value is 1e-10.
Larger value will yield more accurate result, with the cost of longer runtime.
-a, -alpha
Specify the alpha of binomial test confidence interval. Default value is 0.05.
Smaller value will make the test more stringent.
-v, -verbose
Turn on verbose mode. Default off. If turned on, the program will print
detailed information to the screen of run statistics. Recommended.
EXAMPLES
-------------------------------------------------------------------------------
(1) all 3 types of inputs are available:
mlml -v -u FILE_BS -m FILE_OX -h FILE_TAB -o OUTPUT_FILE
This will make the program load methylation data from FILE_BS, FILE_OX and
FILE_TAB respectively, and write output to OUTPUT_FILE
(2) only BS-seq data and Tab-seq data are available:
mlml -v -u FILE_BS -h FILE_TAB -o OUTPUT_FILE
The program will load methylation data from FILE_BS and FILE_TAB.
INPUT FILE FORMAT
-------------------------------------------------------------------------------
All input files for -u, -m and -h options should be in BED format. Detailed
file format is discussed in manual. Followed is an example:
chr1 3001345 3001346 CpG:9 0.777777777778 +
Here the 4th column indicates that the genomic coordinate is a CpG site, and
the number of reads covering this site is 9. The 5th column is methylation
level of the site.
CONTACTS
-------------------------------------------------------------------------------
Jenny Qu
Meng Zhou
Andrew D. Smith
Copyright and License Information
-------------------------------------------------------------------------------
Copyright (C) 2013
University of Southern California,
Jenny Qu, Meng Zhou and Andrew D. Smith
Authors: Jenny Qu, Meng Zhou and Andrew D. Smith
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.