diff --git a/README.md b/README.md
index 1a2a66e..6901abf 100644
--- a/README.md
+++ b/README.md
@@ -57,7 +57,7 @@ Configuration for error model:
 | `error_model`      | Custom error model file (optional)                            | `null`                                        |
 | `qscore_model`     | Custom Q-score model file (optional)                          | `null`                                        |
 | `build_model`      | to build your own error/Qscor model                           | `false`                                       |
-| `model_fastq`      | reference real read (.fastq) to train error model   (optional)      | `false`                                       |
+| `fastq_model`      | reference real read (.fastq) to train error model   (optional)      | `false`                                       |
 | `ref_genome`       | reference genome .fasta file (optional)                       | `false`                                       |
 
 ### Additional Parameters
@@ -78,17 +78,7 @@ Configuration for running the workflow:
 | `container`       | Docker container for the workflow  | `'hamraouii/wf-SLSim'`    |
 | `docker.runOptions` | Docker run options to use       | `'-u $(id -u):$(id -g)'`  |
 
-## Execution
-
-To run the workflow with basic example:
-
-You can simulate a realistic disribution of per barcodes UMI counts by providing in addition to the filtered counts matrix a .csv file of BC counts.  AsaruSim will add a random transcrips count to fit the real distribution.
-```bash
-nextflow run main.nf --matrix test_data/matrix.csv \
-                     --bc_counts test_data/test_bc.csv \
-                     --transcriptome test_data/transcriptome.fa \
-
-```
+## Usage
 User can choose among 4 ways to simulate template reads.
 - use a real count matrix
 - estimated the parameter from a real count matrix to simulate synthetic count matrix 
@@ -97,10 +87,72 @@ User can choose among 4 ways to simulate template reads.
 
 We use SPARSIM tools to simulate count matrix. for more information a bout synthetic count matrix, please read [SPARSIM](https://gitlab.com/sysbiobig/sparsim/-/blob/master/vignettes/sparsim.Rmd?ref_type=heads#Sec_Input_parameter_estimated_from_data) documentaion.
 
-#### use a real count matrix
+### EXAMPLES 
+##### Sample data
+A demonstration dataset to initiate this workflow is accessible on zenodo DOI : [10.5281/zenodo.12731408](https://zenodo.org/records/12731409). This dataset is a subsample from a Nanopore run of the [10X 5k human pbmcs](https://www.10xgenomics.com/datasets/5k-human-pbmcs-3-v3-1-chromium-controller-3-1-standard).
+
+The human GRCh38 [reference transcriptome](https://ftp.ensembl.org/pub/release-112/fasta/homo_sapiens/cdna/), [gtf annotation](https://ftp.ensembl.org/pub/release-112/gtf/homo_sapiens/) and [fasta referance genome](https://ftp.ensembl.org/pub/release-112/fasta/homo_sapiens/dna/) can be downloaded from Ensembl.
+
+
+##### BASIC WORKFLOW
+
+```bash
+ nextflow run main.nf --matrix dataset/sub_pbmc_matrice.csv \
+                      --transcriptome dataset/Homo_sapiens.GRCh38.cdna.all.fa \
+                      --features gene_name \
+                      --gtf dataset/genes.gtf
+```
+
+##### WITH PCR AMPLIFICTION
+
+```bash
+ nextflow run main.nf --matrix dataset/sub_pbmc_matrice.csv \
+                      --transcriptome dataset/Homo_sapiens.GRCh38.cdna.all.fa \
+                      --features gene_name \
+                      --gtf dataset/GRCh38-2020-A-genes.gtf \
+                      --pcr_cycles 2 \
+                      --pcr_dup_rate 0.7 \
+                      --pcr_error_rate 0.00003
+```
+
+##### WITH SIMULATED CELL TYPE COUNTS
+
+```bash
+ nextflow run main.nf --matrix dataset/sub_pbmc_matrice.csv \
+                      --transcriptome dataset/Homo_sapiens.GRCh38.cdna.all.fa \
+                      --features gene_name \
+                      --gtf dataset/GRCh38-2020-A-genes.gtf \
+                      --sim_celltypes true \
+                      --cell_types_annotation dataset/sub_pbmc_cell_type.csv
+```
+
+##### WITH PERSONALIZED ERROR MODEL
+
+```bash
+nextflow run main.nf --matrix dataset/sub_pbmc_matrice.csv \
+                     --transcriptome dataset/Homo_sapiens.GRCh38.cdna.all.fa \
+                     --features gene_name \
+                     --gtf dataset/GRCh38-2020-A-genes.gtf \
+                     --build_model true \
+                     --fastq_model dataset/sub_pbmc_reads.fq \
+                     --ref_genome dataset/GRCh38-2020-A-genome.fa 
+```
+
+##### COMPLETE WORKFLOW
+
 ```bash
-nextflow run main.nf --matrix test_data/matrix.csv \
-                     --transcriptome test_data/transcriptome.fa
+ nextflow run main.nf --matrix dataset/sub_pbmc_matrice.csv \
+                      --transcriptome dataset/Homo_sapiens.GRCh38.cdna.all.fa \
+                      --features gene_name \
+                      --gtf dataset/GRCh38-2020-A-genes.gtf \
+                      --sim_celltypes true \
+                      --cell_types_annotation dataset/sub_pbmc_cell_type.csv
+                      --build_model true \
+                      --fastq_model dataset/sub_pbmc_reads.fq \
+                      --ref_genome dataset/GRCh38-2020-A-genome.fa 
+                      --pcr_cycles 2 \
+                      --pcr_dup_rate 0.7 \
+                      --pcr_error_rate 0.00003
 ```
 
 ## Results
diff --git a/index.html b/index.html
deleted file mode 100644
index a1ec6ce..0000000
--- a/index.html
+++ /dev/null
@@ -1,175 +0,0 @@
-<!DOCTYPE html>
-<html class="writer-html5" lang="en" >
-<head>
-    <meta charset="utf-8" />
-    <meta http-equiv="X-UA-Compatible" content="IE=edge" />
-    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="description" content="None" />
-      <link rel="shortcut icon" href="img/favicon.ico" />
-    <title>AsaruSim</title>
-    <link rel="stylesheet" href="css/theme.css" />
-    <link rel="stylesheet" href="css/theme_extra.css" />
-        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/styles/github.min.css" />
-    
-      <script>
-        // Current page data
-        var mkdocs_page_name = "Installation";
-        var mkdocs_page_input_path = "index.md";
-        var mkdocs_page_url = null;
-      </script>
-    
-    <!--[if lt IE 9]>
-      <script src="js/html5shiv.min.js"></script>
-    <![endif]-->
-      <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/highlight.min.js"></script>
-      <script>hljs.highlightAll();</script> 
-</head>
-
-<body class="wy-body-for-nav" role="document">
-
-  <div class="wy-grid-for-nav">
-    <nav data-toggle="wy-nav-shift" class="wy-nav-side stickynav">
-    <div class="wy-side-scroll">
-      <div class="wy-side-nav-search">
-          <a href="." class="icon icon-home"> AsaruSim
-        </a><div role="search">
-  <form id ="rtd-search-form" class="wy-form" action="./search.html" method="get">
-      <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" title="Type search term here" />
-  </form>
-</div>
-      </div>
-
-      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
-              <ul>
-                <li class="toctree-l1"><a class="reference internal" href="introduction/">Introduction</a>
-                </li>
-              </ul>
-              <ul class="current">
-                <li class="toctree-l1 current"><a class="reference internal current" href="#">Installation</a>
-    <ul class="current">
-    <li class="toctree-l2"><a class="reference internal" href="#requirements">Requirements</a>
-    </li>
-    <li class="toctree-l2"><a class="reference internal" href="#install-nextflow">Install nextflow</a>
-    </li>
-    <li class="toctree-l2"><a class="reference internal" href="#install-docker">Install docker</a>
-    </li>
-    <li class="toctree-l2"><a class="reference internal" href="#run-asarusim">Run AsaruSim</a>
-    </li>
-    </ul>
-                </li>
-              </ul>
-              <ul>
-                <li class="toctree-l1"><a class="reference internal" href="parameters/">Input parameters</a>
-                </li>
-              </ul>
-              <ul>
-                <li class="toctree-l1"><a class="reference internal" href="examples/">Use example</a>
-                </li>
-              </ul>
-      </div>
-    </div>
-    </nav>
-
-    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
-      <nav class="wy-nav-top" role="navigation" aria-label="Mobile navigation menu">
-          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
-          <a href=".">AsaruSim</a>
-        
-      </nav>
-      <div class="wy-nav-content">
-        <div class="rst-content"><div role="navigation" aria-label="breadcrumbs navigation">
-  <ul class="wy-breadcrumbs">
-    <li><a href="." class="icon icon-home" aria-label="Docs"></a></li>
-      <li class="breadcrumb-item active">Installation</li>
-    <li class="wy-breadcrumbs-aside">
-    </li>
-  </ul>
-  <hr/>
-</div>
-          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
-            <div class="section" itemprop="articleBody">
-              
-                <h1 id="welcome-to-asarusim">Welcome to AsaruSim</h1>
-<p>AsaruSim is an automated <a href="https://www.nextflow.io/">Nextflow</a> workflow designed for simulating 10x single-cell Nanopore reads. It allows to benchmark and optimize single-cell Nanopore long read data processing pipelines.</p>
-<p>Github repository <a href="https://github.com/alihamraoui/AsaruSim">AsaruSim</a>.</p>
-<h2 id="requirements">Requirements</h2>
-<ul>
-<li><code>Nextflow</code> - A workflow engine for complex data pipelines.</li>
-<li><code>Docker</code> or <code>Singularity</code> - Containers for packaging necessary software, ensuring reproducibility.</li>
-</ul>
-<h2 id="install-nextflow">Install nextflow</h2>
-<p>Ensure you have the following installed on your system:</p>
-<p><code>Java 8 or later</code>: Nextflow requires Java. Install it from Oracle or use a package manager like apt, brew, or yum depending on your OS.</p>
-<pre><code class="language-bash">curl -s https://get.nextflow.io | bash
-chmod +x nextflow
-sudo mv nextflow /usr/local/bin/
-</code></pre>
-<p>Nextflow is now installed and ready to use on your system. For further details on using Nextflow, refer to the <a href="https://www.nextflow.io/docs/latest/index.html">official documentation</a>.</p>
-<h2 id="install-docker">Install docker</h2>
-<p><a href="https://docs.docker.com/engine/install/">Install Docker</a>.</p>
-<h2 id="run-asarusim">Run AsaruSim</h2>
-<ul>
-<li>1 - Clone the github repository</li>
-</ul>
-<pre><code class="language-bash">git clone https://github.com/alihamraoui/AsaruSim.git
-
-cd AsaruSim
-</code></pre>
-<ul>
-<li>2 - Run using nextflow</li>
-</ul>
-<pre><code class="language-bash">nextflow run main.nf --help
-</code></pre>
-              
-            </div>
-          </div><footer>
-    <div class="rst-footer-buttons" role="navigation" aria-label="Footer Navigation">
-        <a href="introduction/" class="btn btn-neutral float-left" title="Introduction"><span class="icon icon-circle-arrow-left"></span> Previous</a>
-        <a href="parameters/" class="btn btn-neutral float-right" title="Input parameters">Next <span class="icon icon-circle-arrow-right"></span></a>
-    </div>
-
-  <hr/>
-
-  <div role="contentinfo">
-    <!-- Copyright etc -->
-  </div>
-
-  Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
-</footer>
-          
-        </div>
-      </div>
-
-    </section>
-
-  </div>
-
-  <div class="rst-versions" role="note" aria-label="Versions">
-  <span class="rst-current-version" data-toggle="rst-current-version">
-    
-    
-      <span><a href="introduction/" style="color: #fcfcfc">&laquo; Previous</a></span>
-    
-    
-      <span><a href="parameters/" style="color: #fcfcfc">Next &raquo;</a></span>
-    
-  </span>
-</div>
-    <script src="js/jquery-3.6.0.min.js"></script>
-    <script>var base_url = ".";</script>
-    <script src="js/theme_extra.js"></script>
-    <script src="js/theme.js"></script>
-      <script src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.0/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
-      <script src="search/main.js"></script>
-    <script>
-        jQuery(function () {
-            SphinxRtdTheme.Navigation.enable(true);
-        });
-    </script>
-
-</body>
-</html>
-
-<!--
-MkDocs version : 1.6.0
-Build Date UTC : 2024-06-24 15:16:33.822496+00:00
--->