Skip to content
R scripts to reproduce analyses in our paper comparing clustering methods for high-dimensional cytometry data
R Shell
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
data_preparation
ensemble_clustering
evaluate_results
helpers
plots_and_tables
range_k
run_methods
stability_analysis
supplementary_files
updates/densityCut
.gitignore
LICENSE
README.md add updated results for densityCut Feb 15, 2017

README.md

Comparison of clustering methods for high-dimensional single-cell flow and mass cytometry (CyTOF) data

This repository contains R scripts to reproduce the analyses and figures in our paper comparing clustering methods for high-dimensional flow cytometry and mass cytometry (CyTOF) data.

  • Weber L.M. and Robinson M.D. (2016) Comparison of clustering methods for high-dimensional single-cell flow and mass cytometry data. Cytometry Part A, 89A: 1084–1096. Open access available here.

    Note: Supplementary files (Supporting Information PDF and Supporting Information Table S1) are available via the journal link above, or from the supplementary_files directory (latest version: November 18, 2016).

Overview

In this study, we compared the performance of 18 clustering methods for automated detection of cell populations in high-dimensional flow cytometry and mass cytometry (CyTOF) data, using 6 publicly available data sets from experiments in immunology as benchmarks. These results extend previously published comparisons by focusing on high-dimensional data and including new methods developed for CyTOF data.

A list of the clustering methods can be found in Table 1 in the paper. A list of the data sets is provided in Table 2.

The comparisons showed that several methods performed well, including FlowSOM, X-shift, PhenoGraph, Rclusterpp, and flowMeans. Among these, FlowSOM had extremely fast runtimes, making this method well-suited for interactive, exploratory analysis of large, high-dimensional data sets on a standard laptop or desktop computer.

Based on our results, we recommend the use of FlowSOM (with manual selection of the number of clusters; see paper) as a first choice for this type of analysis, since this method gave best or near-best performance across all data sets, together with extremely fast runtimes.

See the paper for more details, in particular regarding the advantages of the different methods for different clustering tasks (detecting multiple cell populations vs. detecting a single rare population).

FlowSOM and Rtsne example code

FlowSOM (Van Gassen et al., 2015) is available as a Bioconductor package for the R statistical programming language.

A worked example showing how to use FlowSOM for clustering and Rtsne for visualization is available in the FlowSOM-Rtsne-example repository.

Updates

Updated results for new clustering algorithms or new reference data sets will be published on this website.

The following updates are currently available:

Contents of this repository

R scripts are organized into the following subdirectories. All scripts contain comments explaining the overall purpose and individual steps.

Supplementary files from the published paper are included in the following directory:

R scripts and summary reports for updated results are included in the following directory:

  • updates: updated results for new clustering methods or new reference data sets

Data files

Pre-processed data files for the benchmark data sets are available from FlowRepository (repository FR-FCM-ZZPH).

Original data files can be obtained through the references listed in Table 2 in the paper.

You can’t perform that action at this time.