Skip to content
Branch: master
Go to file

Latest commit


Failed to load latest commit information.
Latest commit message
Commit time

MultiQC_NGI is a plugin for MultiQC, providing additional tools which are specific to the National Genomics Infrastructure at the Science for Life Laboratory in Stockholm, Sweden.

Build Status

For more information about NGI, see

For more information about MultiQC, see



This plugin provides two extra templates - ngi and genstat. ngi is a stand-alone template, much like the default MultiQC template but with additional branding. genstat produces a template suitable for tornado, allowing reports to be directly integrated into our internal sample tracking website, Genomics Status. Both are able to print data specific to this plugin (see below).

Pulling from StatusDB

This plugin connects MultiQC to our internal sample tracking database, statusdb.

Firstly, it retrieves information from statusdb to put into the report:

  1. Looks at sample names in the General Stats table for something that looks like an NGI project number (eg. P1234). Bails if none or more than one are found.
  2. Connects to statusdb and searches projects for this. Bails if not found.
  3. Retrieves project level information to be printed at the top of the report (ngi template only).
  4. Goes through general stats table looking for sample identifiers (P1234_001)
  5. Searches statusdb for each of these and tries to pull interesting fields if possible:
  • Initial QC RIN score
  • Amount of sample taken for library prep
  • Concentration of prepared library
    • NB: These are skipped if multiple library preps are found.

Pushing to StatusDB

As well as retrieving data, MultiQC_NGI can push data back to statusdb. This is helpful as it allows us to do cross-project meta analyses, tracking the bioinformatics statistics across everything we run.

  1. If pulling data has worked, we already know the project and sample IDs
  2. Either pushes or updates records in the analysis database, using data saved by all MultiQC modules available in report.saved_raw_data

This is dependent on either --push or config.push_statusdb being true, so doesn't run by default.

Saving reports to a server

Once the MultiQC report is complete and has been saved to disk, MultiQC_NGI can transfer the report to a remote server by using the scp command. We use this to store reports in a central backed up location. Once there, we are able to integrate them into our sample tracking website.


To run this tool, you must have MultiQC installed. You can install both MultiQC and this package with the following command:

pip install multiqc git+


To use the new templates, specify their name with the -t flag in MultiQC:

multiqc -t ngi .

There are two new command line flags introduced by the plugin:

  • --project
    • Specify a Project ID number, instead of automatically searching for one in sample names
  • --push/--no-push
    • Override the config file default for whether to push results to StatusDB.
  • --test-db
    • Specify a JSON file to use for testing instead of StatusDB. For example, this one
  • --disable-ngi
    • Disable the MultiQC_NGI plugin for this run


The MultiQC_NGI plugin has some configuration options which you can add to the main MultiQC config files (inst_dir/multiqc_config.yaml, ~/.multiqc_config.yaml and ./multiqc_config.yaml).

The available config options with some suggested values can be found in multiqc_ngi_config.yaml

Code structure

The new templates are held in multiqc_ngi/. The code that interacts with statusdb is in multiqc_ngi/ and the new command line options are defined in multiqc_ngi/

The way that all of these plugin functions work is defined in, in the entry_points section.


If you're developing this code, you'll want to clone it locally and install it manually instead of using pip:

git clone
cd MultiQC_NGI
python develop

Note that you can use test data specifically for MultiQC_NGI, found within the MultiQC_TestData repository.

This dataset includes a JSON file with contents that emulate statusdb, so that these features can be developed locally. To use this, tell MultiQC where to find it using the --test-db flag:

multiqc data -t ngi --test-db ngi_db_data.json
You can’t perform that action at this time.