Skip to contents

Overview

While generate_report() bundles everything into one HTML file, every plot and table in NanoQuRe is also available as a standalone function. This is useful when you want to embed a specific plot in your own R Markdown report, tweak parameters, or inspect a single metric interactively.

library(NanoQuRe)

data(sample_data)

Summary tables

sequencing_stats()

Returns a one-row summary of the run: duration, total bases sequenced, pass rate, and average translocation speed.

sequencing_stats(sample_data)
#> # A tibble: 1 × 6
#>   `sample id`     `duration [h]` `number of reads` `total bases sequenced [Gb]`
#>   <chr>                    <dbl>             <int>                        <dbl>
#> 1 experiment_0001           88.6              1000                        0.001
#> # ℹ 2 more variables: `passed reads [%]` <dbl>, `average speed [bp/s]` <dbl>

quality_stats()

Returns key quality metrics: total and passed read counts, N50, mean Q score, longest read, and mean length of passed reads.

quality_stats(sample_data)
#> # A tibble: 1 × 7
#>   `sample id`     `all reads` `passed reads` `n50 value` `mean qscore`
#>   <chr>                 <int>          <int>       <dbl>         <dbl>
#> 1 experiment_0001        1000            885        1201          10.9
#> # ℹ 2 more variables: `longest read` <dbl>, `passed mean length` <dbl>

Yield plots

plot_cumulative_yield()

Shows how total sequenced bases accumulate over the run, split by pass/fail status. A flattening curve indicates the run is winding down.

plot_seq_throughput()

Shows yield per hour rather than cumulative yield — useful for spotting periods of low pore activity or blockages during the run.

plot_seq_throughput(sample_data)

Speed

plot_average_speed()

Shows the average translocation speed of DNA through the pore in bases per second, split by pass/fail. A drop in speed can indicate pore aging or buffer issues.

plot_average_speed(sample_data)

Read length distribution

plot_read_lengths()

Plots the read length distribution with vertical lines for the mean read length and the N50 value. The upper_limit parameter controls the x axis maximum — useful when a small number of very long reads would compress the rest of the distribution.

# default upper limit is 4000 bp
plot_read_lengths(sample_data)
# zoom out to see the full long-read tail
plot_read_lengths(sample_data, upper_limit = 20000)

Quality distribution

plot_quality_distribution()

Plots the Q score distribution split by pass/fail. Two vertical lines are shown: the basecaller’s own pass/fail threshold (derived from the data) and a user-defined cutoff for downstream analysis.

# default user-defined cutoff is Q7
plot_quality_distribution(sample_data, qscore_cutoff = 7)

Channel activity

plot_active_channels()

Shows how many pore channels remain active over the course of the run. A steep early drop suggests many pores became blocked or inactive quickly.

pore_activity_heatmap()

Shows two complementary views of pore activity: a time × channel heatmap and a spatial heatmap overlaid on the flowcell layout. Darker colour means more bases sequenced through that channel.

pore_activity_heatmap(sample_data, platform = "minion")

N50 directly

calculate_n50()

If you just need the N50 value without any plot:

calculate_n50(sample_data)
#> [1] 1201

Session info

sessionInfo()
#> R version 4.6.1 (2026-06-24)
#> Platform: x86_64-pc-linux-gnu
#> Running under: Ubuntu 24.04.4 LTS
#> 
#> Matrix products: default
#> BLAS:   /usr/lib/x86_64-linux-gnu/openblas-pthread/libblas.so.3 
#> LAPACK: /usr/lib/x86_64-linux-gnu/openblas-pthread/libopenblasp-r0.3.26.so;  LAPACK version 3.12.0
#> 
#> locale:
#>  [1] LC_CTYPE=C.UTF-8       LC_NUMERIC=C           LC_TIME=C.UTF-8       
#>  [4] LC_COLLATE=C.UTF-8     LC_MONETARY=C.UTF-8    LC_MESSAGES=C.UTF-8   
#>  [7] LC_PAPER=C.UTF-8       LC_NAME=C              LC_ADDRESS=C          
#> [10] LC_TELEPHONE=C         LC_MEASUREMENT=C.UTF-8 LC_IDENTIFICATION=C   
#> 
#> time zone: UTC
#> tzcode source: system (glibc)
#> 
#> attached base packages:
#> [1] stats     graphics  grDevices utils     datasets  methods   base     
#> 
#> other attached packages:
#> [1] NanoQuRe_1.0
#> 
#> loaded via a namespace (and not attached):
#>  [1] gtable_0.3.6       jsonlite_2.0.0     dplyr_1.2.1        compiler_4.6.1    
#>  [5] tidyselect_1.2.1   tidyr_1.3.2        jquerylib_0.1.4    scales_1.4.0      
#>  [9] systemfonts_1.3.2  textshaping_1.0.5  yaml_2.3.12        fastmap_1.2.0     
#> [13] ggplot2_4.0.3      R6_2.6.1           generics_0.1.4     knitr_1.51        
#> [17] htmlwidgets_1.6.4  tibble_3.3.1       desc_1.4.3         RColorBrewer_1.1-3
#> [21] bslib_0.11.0       pillar_1.11.1      rlang_1.2.0        utf8_1.2.6        
#> [25] DT_0.34.0          cachem_1.1.0       xfun_0.59          S7_0.2.2          
#> [29] fs_2.1.0           sass_0.4.10        lazyeval_0.2.3     otel_0.2.0        
#> [33] viridisLite_0.4.3  plotly_4.12.0      cli_3.6.6          withr_3.0.3       
#> [37] pkgdown_2.2.0      magrittr_2.0.5     crosstalk_1.2.2    digest_0.6.39     
#> [41] grid_4.6.1         lifecycle_1.0.5    vctrs_0.7.3        evaluate_1.0.5    
#> [45] glue_1.8.1         data.table_1.18.4  farver_2.1.2       ragg_1.5.2        
#> [49] purrr_1.2.2        httr_1.4.8         rmarkdown_2.31     tools_4.6.1       
#> [53] pkgconfig_2.0.3    htmltools_0.5.9