@@ -125,7 +125,7 @@ def layout(app):
125125 value = "data" ,
126126 children = [
127127 dcc .Tab (
128- label = "Data " ,
128+ label = "Volcano plot " ,
129129 value = "data" ,
130130 children = html .Div (
131131 className = "control-tab" ,
@@ -166,8 +166,52 @@ def layout(app):
166166 ],
167167 ),
168168 ),
169+
170+ dcc .Tab (
171+ label = "About this tutorial" ,
172+ value = "description" ,
173+ children = html .Div (
174+ className = "control-tab" ,
175+ children = [
176+ html .H4 (
177+ className = "description" ,
178+ children = """Visualizing RNA-seq data with pileup.js
179+ and volcano plots""" ,
180+ ),
181+ dcc .Markdown (
182+ """
183+ In this example, we use the pileup.js and volcano plot components from dash-bio
184+ to visualize two RNA-sequencing
185+ (RNA-seq) samples from two conditions. RNA-seq allows us to learn how the expression
186+ of genes changes between different samples of interest. Here, we are looking at
187+ RNA-seq from two samples that are taken from two different mouse cell types.
188+ We refer to these different cell types as basal and luminal cell types.
189+
190+ On the right, we use pileup.js to visualize aligned reads from RNA-seq samples.
191+ On the left, we have a volcano plot, that visualizes the magnitude of change
192+ in gene expression between the two samples. On the x-axis, the `Effect Size`
193+ indicates the log2 fold change in expression
194+ between the two conditions. On the y-axis, `-log10(p)` indicates the -log10(p-value)
195+ for each gene. This p-value, along with the effect size,
196+ can help determine whether each gene is significantly
197+ differentially expressed between the conditions of interest.
198+
199+ To explore a gene, you can click on a gene in the volcano plot. After clicking on
200+ a gene, the genomic region overlapping that gene will show up in the pileup.js
201+ browser on the right. Now, you can investigate RNA-seq alignments at each
202+ gene of interest. You may notice that genes with a negative effect size in the volcano
203+ plot have more RNA-seq reads in the top sample (the basal cell type), while genes
204+ with a positive effect size have more reads in the bottom sample
205+ (the luminal cell type).
206+ """
207+ ),
208+ ],
209+ ),
210+ ),
211+
212+
169213 dcc .Tab (
170- label = "About" ,
214+ label = "About pileup.js " ,
171215 value = "what-is" ,
172216 children = html .Div (
173217 className = "control-tab" ,
@@ -181,7 +225,7 @@ def layout(app):
181225 The Dash pileup.js component is a high-performance genomics
182226 data visualization component developed originally by the Hammer Lab
183227 (https://github.com/hammerlab/pileup.js). pileup.js
184- supports visualization of genomic file formats, such as vcfs ,
228+ supports visualization of genomic file formats, such as vcf ,
185229 bam, and bigbed files. pileup.js additionally allows flexible
186230 interaction with non-standard data formats. Users can visualize
187231 GA4GH JSON formatted alignments, features and variants. Users can
0 commit comments