@@ -5,49 +5,6 @@ to examine the utility of further sequencing, optimize the sequencing
55depth, or to screen multiple libraries to avoid low complexity
66samples.
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-
518SYSTEM REQUIREMENTS:
529========================================================================
5310The preseq software will only run on 64-bit UNIX-like operating
@@ -56,17 +13,57 @@ requires a C++ compiler that supports C++11.
5613
5714INSTALLATION:
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
7168INPUT FILE FORMATS:
7269========================================================================
@@ -119,6 +116,49 @@ first column gives the total number of reads in a theoretically
119116smaller experiment and the second gives the corresponding number of
120117distinct 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+
122162HISTORY
123163========================================================================
124164preseq was originally developed by Timothy Daley and Andrew Smith
0 commit comments