Skip to content

Commit 9920e67

Browse files
authored
Update README.md
1 parent f51819b commit 9920e67

1 file changed

Lines changed: 91 additions & 51 deletions

File tree

README.md

Lines changed: 91 additions & 51 deletions
Original file line numberDiff line numberDiff line change
@@ -5,49 +5,6 @@ to examine the utility of further sequencing, optimize the sequencing
55
depth, or to screen multiple libraries to avoid low complexity
66
samples.
77

8-
UPDATES TO VERSION 3.0
9-
========================================================================
10-
The main change to this version is that if BAM/SAM format will be used
11-
as input, the HTSLib library must be installed on the system when
12-
preseq is built. Installation instructions below have been updated
13-
correspondingly. We also updated to use C++11, so a more recent
14-
compiler is required, but these days C++11 is usually supported.
15-
16-
UPDATES TO VERSION 2.0.3
17-
========================================================================
18-
A bug in defect mode was fixed and a rng seed was added to allow for
19-
reproducibility.
20-
21-
UPDATES TO VERSION 2.0.0
22-
========================================================================
23-
We have added a new module, `bound_pop`, to estimate a lower bound of
24-
the population sampled from. Interpolation is calculated by
25-
expectation rather than subsampling, dramatically improving the speed.
26-
27-
UPDATES TO VERSION 1.0.2
28-
========================================================================
29-
We have switched the dependency on the BamTools API to SAMTools, which
30-
we believe will be more convenient for most users of preseq. Minor
31-
bugs have been fixed, and algorithms have been refined to more
32-
accurately construct counts histograms and extrapolate the complexity
33-
curve. More options have been added to `lc_extrap`. `c_curve` and
34-
`lc_extrap` are now both under a single binary for easier use, and
35-
commands will now be written as `preseq lc_extrap [OPTIONS]`
36-
Furthermore, there are updates to the manual for any minor issues
37-
encountered when compiling the preseq binary.
38-
39-
We released an R package called
40-
[preseqR](http://cran.r-project.org/web/packages/preseqR/index.html)
41-
along with the preseq. It makes the preseq available in the R statistical
42-
environment. The submodule preseqR contains all required source code
43-
to build the R package.
44-
45-
CONTACT INFORMATION:
46-
========================================================================
47-
Timothy Daley
48-
tdaley@stanford.edu
49-
http://smithlabresearch.org
50-
518
SYSTEM REQUIREMENTS:
529
========================================================================
5310
The preseq software will only run on 64-bit UNIX-like operating
@@ -56,17 +13,57 @@ requires a C++ compiler that supports C++11.
5613

5714
INSTALLATION:
5815
========================================================================
59-
This should be easy: unpack the archive and change into the archive
60-
directory. Then type `make`. The programs will be in the archive
61-
directory. These can be moved around, and also do not depend on any
62-
dynamic libraries, so they should simply work when executed. If the
63-
desired input is in `.bam` format, `htslib` is required. Type
16+
### Installing from a release
17+
18+
1. Download preseq-3.0.tar.gz from the releases tab of this repository.
19+
2. Unpack the archive:
20+
```
21+
$ tar -zxvf preseq-3.0.tar.gz
22+
```
23+
3. Move into the methpipe directory and create a build directory:
24+
```
25+
$ cd preseq-3.0
26+
$ mkdir build && cd build
27+
```
28+
4. Run the configuration script:
29+
```
30+
$ ../configure
31+
```
32+
If you do not want to install preseq system-wide, or if you do
33+
not have admin privileges, specify a prefix directory:
34+
```
35+
$ ../configure --prefix=/some/reasonable/place
36+
```
37+
Finally, if you want to build with HTSlib support (for the `to-mr`
38+
program) then you need to specify the following:
6439
```
65-
make HAVE_HTSLIB=1 all
40+
$ ../configure --enable-hts
41+
```
42+
And if you installed HTSlib yourself in some non-standard directory,
43+
you must specify the location like this:
44+
```
45+
$ ../configure --enable-hts CPPFLAGS='-I /path/to/htslib/headers' \
46+
LDFLAGS='-L/path/to/htslib/lib'
47+
```
48+
5. Compile and install the tools:
49+
```
50+
$ make
51+
$ make install
6652
```
67-
to make the programs.
6853

69-
The HTSLib library can be obtained here: http://www.htslib.org/download
54+
### Installing from source
55+
56+
Developers looking to use the latest commits can compile the cloned repository using the `Makefile`
57+
within the `src` directory. The process is simple:
58+
```
59+
$ cd src/
60+
$ make
61+
```
62+
If the desired input is in `.bam` format, `htslib` is required. Type
63+
```
64+
make HAVE_HTSLIB=1 all
65+
```
66+
to make the programs. The HTSLib library can be obtained here: http://www.htslib.org/download
7067

7168
INPUT FILE FORMATS:
7269
========================================================================
@@ -119,6 +116,49 @@ first column gives the total number of reads in a theoretically
119116
smaller experiment and the second gives the corresponding number of
120117
distinct reads.
121118

119+
UPDATES TO VERSION 3.0
120+
========================================================================
121+
The main change to this version is that if BAM/SAM format will be used
122+
as input, the HTSLib library must be installed on the system when
123+
preseq is built. Installation instructions below have been updated
124+
correspondingly. We also updated to use C++11, so a more recent
125+
compiler is required, but these days C++11 is usually supported.
126+
127+
UPDATES TO VERSION 2.0.3
128+
========================================================================
129+
A bug in defect mode was fixed and a rng seed was added to allow for
130+
reproducibility.
131+
132+
UPDATES TO VERSION 2.0.0
133+
========================================================================
134+
We have added a new module, `bound_pop`, to estimate a lower bound of
135+
the population sampled from. Interpolation is calculated by
136+
expectation rather than subsampling, dramatically improving the speed.
137+
138+
UPDATES TO VERSION 1.0.2
139+
========================================================================
140+
We have switched the dependency on the BamTools API to SAMTools, which
141+
we believe will be more convenient for most users of preseq. Minor
142+
bugs have been fixed, and algorithms have been refined to more
143+
accurately construct counts histograms and extrapolate the complexity
144+
curve. More options have been added to `lc_extrap`. `c_curve` and
145+
`lc_extrap` are now both under a single binary for easier use, and
146+
commands will now be written as `preseq lc_extrap [OPTIONS]`
147+
Furthermore, there are updates to the manual for any minor issues
148+
encountered when compiling the preseq binary.
149+
150+
We released an R package called
151+
[preseqR](http://cran.r-project.org/web/packages/preseqR/index.html)
152+
along with preseq. It makes preseq available in the R statistical
153+
environment. The submodule preseqR contains all required source code
154+
to build the R package.
155+
156+
CONTACT INFORMATION:
157+
========================================================================
158+
Timothy Daley
159+
tdaley@stanford.edu
160+
http://smithlabresearch.org
161+
122162
HISTORY
123163
========================================================================
124164
preseq was originally developed by Timothy Daley and Andrew Smith

0 commit comments

Comments
 (0)