RSEM v1.1.8

[rsem.git] / README.md

diff --git a/README.md b/README.md
index 5acd5937db2f573f9e2a3900baa9bb5b84cdec3c..2bb60152c0492f6b8260169a72edfe877b5938c0 100644 (file)
--- a/README.md
+++ b/README.md
@@ -27,7 +27,7 @@ the EM algorithm, single-end and paired-end read data, quality scores,
 variable-length reads and RSPD estimation. It can also generate
 genomic-coordinate BAM files and UCSC wiggle files for visualization. In
 addition, it provides posterior mean and 95% credibility interval
-estimates for expression levels.
+estimates for expression levels. 
 
 ## <a name="compilation"></a> Compilation & Installation
 
@@ -100,6 +100,12 @@ and provide the SAM or BAM file as an argument.  When using an
 alternative aligner, you may also want to provide the --no-bowtie option
 to rsem-prepare-reference so that the Bowtie indices are not built.
 
+However, please note that RSEM does ** not ** support gapped
+alignments. So make sure that your aligner does not produce alignments
+with intersions/deletions. Also, please make sure that you use
+'reference_name.idx.fa' , which is generated by RSEM, to build your
+aligner's indices.
+
 ### III. Visualization
 
 RSEM contains a version of samtools in the 'sam' subdirectory. When
@@ -133,16 +139,16 @@ RSEM provides an R script, 'rsem-plot-model', for visulazing the model learned.
 
 Usage:
     
-    rsem-plot-model modelF outF
+    rsem-plot-model sample_name outF
 
-modelF: the sample_name.model file generated by RSEM    
+sample_name: the name of the sample analyzed    
 outF: the file name for plots generated from the model. It is a pdf file    
 
 The plots generated depends on read type and user configuration. It
 may include fragment length distribution, mate length distribution,
 read start position distribution (RSPD), quality score vs observed
 quality given a reference base, position vs percentage of sequencing
-error given a reference base.
+error given a reference base and histogram of read alignments.
 
 fragment length distribution and mate length distribution: x-axis is fragment/mate length, y axis is the probability of generating a fragment/mate with the associated length
 
@@ -151,6 +157,8 @@ RSPD: Read Start Position Distribution. x-axis is bin number, y-axis is the prob
 Quality score vs. observed quality given a reference base: x-axis is Phred quality scores associated with data, y-axis is the "observed quality", Phred quality scores learned by RSEM from the data. Q = -10log_10(P), where Q is Phred quality score and P is the probability of sequencing error for a particular base
 
 Position vs. percentage sequencing error given a reference base: x-axis is position and y-axis is percentage sequencing error
+
+Histogram of read alignments: x-axis is the number of alignments a read has and y-axis is the number of such reads
  
 ## <a name="example"></a> Example
 
@@ -199,9 +207,7 @@ output_name.sim.isoforms.results, output_name.sim.genes.results : Results estima
 
 ## <a name="acknowledgements"></a> Acknowledgements
 
-RSEM uses randomc.h and mersenne.cpp from
-<http://lxnt.info/rng/randomc.htm> for random number generation. RSEM
-also uses the [Boost C++](http://www.boost.org) and
+RSEM uses the [Boost C++](http://www.boost.org) and
 [samtools](http://samtools.sourceforge.net) libraries.
 
 ## <a name="license"></a> License