collapse = TRUE,
  comment = "#>",
  eval = TRUE,
  crop = NULL


The purpose of the r Biocpkg("alevinQC") package is to generate a summary QC report based on the output of an alevin [@Srivastava2019-fz] run. The QC report can be generated as a html or pdf file, or launched as a shiny application.


alevinQC can be installed using the BiocManager CRAN package.

if (!requireNamespace("BiocManager", quietly = TRUE))

After installation, load the package into the R session.


Note that in order to process output from Salmon v0.14 or later, you need Alevin v1.1 or later.

Assumed output directory structure

For more information about running alevin, we refer to the documentation. When invoked, alevin generates several output files in the specified output directory. r Biocpkg("alevinQC") assumes that this structure is retained, and will return an error if it isn't - thus, it is not recommended to move or rename the output files from alevin. r Biocpkg("alevinQC") assumes that the following files (in the indicated structure) are available in the provided baseDir (note that currently, in order to generate the full set of files, alevin must be invoked with the --dumpFeatures flag).

For alevin versions before 0.14:

  |    |--featureDump.txt
  |    |--filtered_cb_frequency.txt
  |    |--MappedUmi.txt
  |    |--quants_mat_cols.txt
  |    |--quants_mat_rows.txt
  |    |--quants_mat.gz
  |    |--raw_cb_frequency.txt
  |    |--whitelist.txt
  |    |--meta_info.json

For alevin version 0.14 and later:

  |    |--featureDump.txt
  |    |--raw_cb_frequency.txt
  |    |--whitelist.txt  (depending on how alevin was run)
  |    |--meta_info.json
  |    |--alevin_meta_info.json

Check that all required alevin files are available

The report generation functions (see below) will check that all the required files are available in the provided base directory. However, you can also call the function checkAlevinInputFiles() to run the check manually. If one or more files are missing, the function will raise an error indicating the missing file(s).

baseDir <- system.file("extdata/alevin_example_v0.14", package = "alevinQC")
checkAlevinInputFiles(baseDir = baseDir)

Generate QC report

The alevinQCReport() function generates the QC report from the alevin output. Depending on the file extension of the outputFile argument, and the value of outputFormat, the function can generate either an html report or a pdf report.

outputDir <- tempdir()
alevinQCReport(baseDir = baseDir, sampleId = "testSample", 
               outputFile = "alevinReport.html", 
               outputFormat = "html_document",
               outputDir = outputDir, forceOverwrite = TRUE)

Create shiny app

In addition to static reports, r Biocpkg("alevinQC") can also generate a shiny application, containing the same summary figures as the pdf and html reports.

app <- alevinQCShiny(baseDir = baseDir, sampleId = "testSample")

Once created, the app can be launched using the runApp() function from the r CRANpkg("shiny") package.


Generate individual plots

The individual plots included in the QC reports can also be independently generated. To do so, we must first read the alevin output into an R object.

alevin <- readAlevinQC(baseDir = baseDir)

The resulting list contains four entries:


The plots can now be generated using the dedicated plotting functions provided with r Biocpkg("alevinQC") (see the help file for the respective function for more information).


Session info



Try the alevinQC package in your browser

Any scripts or data that you put into this service are public.

alevinQC documentation built on Feb. 4, 2021, 2:01 a.m.