Skip to content

QC Report

From Quantified Expression Profiles to QC Report for Metabolomics (targeted and untargeted)

.csv format of quantified expression profiles at metabolite level


You can find the source code on chinese-quartet/quartet-metqc-report

Prepare data & metadata files

Data File

The data file provides quantitative information on Quartet samples at the metabolite level. 1. The data file should be comma separated values (.csv) or tab delimited text (.txt) with a header in the first row.

  1. Samples should be in the columns of the file.

  2. Quantitative results should be given in the form of concentrations or peak intensities and contain only numeric and positive values.

  3. Two columns accurately named "metabolites" and "HMDBID" are needed, which contain the name of the metabolite compound and HMDBID, respectively. If HMDBID is not available, use "NA" for missing values in the data file.

  4. Both sample or metabolite compound names must be unique and consist of a combination of common English letters, underscores and numbers for naming purpose. Sample name should not be started with numbers. Latin/Greek letters are not supported.

More details on

Metadata File

The metadata file has the information of each sample in the data file. With columns accurately named "col_names" (names of samples, identical to their names in the columns of data file), "strategy" (Targeted or Untargeted), "lab" (the name of lab), "sample" (D5, D6, F7 and M8 for Quartet samples), "rep" (the replicates for each sample) and "batch" (the name of batch).

A screenshot of a sample metadata table is shown below.

Metabolomics Sample Data

Step by Step Guide

Analyze your data on your own server

  1. Pull docker image

    More versions on Docker Registry

    docker pull
  2. Run quartet-metqc-report with docker image

    Assuming that your data file is named data.csv and metadata file is named metadata.csv and all files are placed in /your-dir directory.

    docker run -v /your-dir:/data -it -d /data/data.csv -m /data/metadata.csv -o /data
  3. Find your QC report in /your-dir/multiqc_report.html

Analyze your data on Quartet Data Portal

As for running the QC pipeline of metabolomics data, you can:

1) go to;

2) click the upper right button named "New QC report";

3) click "Step 1: Choose Report", please choose "QC Report for Quartet Metabolomics" ;

4) click "Step 2: Upload Files (s)", please upload your data and metadata files (.csv).

5) click "Step 3: Parameters & Submit", please fill in the blanks and submit the job.

See more details on Step by Step Guide

Last update: 2023-06-20
Back to top