Skip to content
This repository has been archived by the owner before Nov 9, 2022. It is now read-only.


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?


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

COVID-19 immunological profiling with flow cytometry

Source code for manuscript:

"Longitudinal immune profiling of mild and severe COVID-19 reveals innate and adaptive immune dysfunction and provides an early prediction tool for clinical progression"

Posted on medRxiv, 2020/09/09:

Published on Life Science Alliance, 2020/12/24: as

"Profiling of immune dysfunction in COVID-19 patients allows early prediction of disease progression"


  • This CSV file contains the original manually curated data
  • The metadata directory contains parsed/further curated metadata
  • Raw data (e.g. CSV, FCS and H5ad files) will be under the data directory.
  • The src directory contains source code used to analyze the data
  • A Makefile is provided to allow easy execution of task blocks.
  • Outputs from the analysis will be present in a results directory, with subfolders pertaining to each part of the analysis described below.

FCS files are hosted on Cytobank. An account is needed to download the files, which can be made programmatically with the make get_fcs command (see below). To connect with your account, simply add your credentials to a file named ~/.cytobank.auth.json containing the fields username and password:

{"username": "username", "password": "ABCD1234"}

Be sure to make the file read-only (e.g. chmod 400 ~/.cytobank.auth.json).



To see all available steps type:

make help
Makefile for the covid-flowcyto package/project.
Available commands:
help            Display help and quit
requirements    Install software requirements with pip
get_fcs         Download FCS files from Cytobank
get_h5ad        Download H5ad files
get_batch       Parse processing date from FCS metadata
parse           Parse original data into metadata and matrix data
impute          Imputation of missing FACS data
clinical        Run analysis of clinial data
unsupervised    Run unsupervised analysis
supervised      Run supervised analysis
temporal        Run temporal analysis
single_cell     Run single-cell analysis
all             Run all analysis steps in order

To reproduce analysis, simply do:

make requirements


  • Python 3.7+ (was run on 3.8.2)
  • Python packages as specified in the requirements file - install with make requirements or pip install -r requirements.txt.

Virtual environment

It is recommended to compartimentalize the analysis software from the system's using virtual environments, for example.

Here's how to create one with the repository and installed requirements:

git clone
cd covid-flowcyto
virtualenv .venv
source activate .venv/bin/activate
pip install -r requirements.txt


COVID19 profiling of peripheral immune system with flow cytometry