nfcore/imcyto is a bioinformatics analysis pipeline used for Image Mass Cytometry analysis.

The pipeline is built using Nextflow, a workflow tool to run tasks across multiple compute infrastructures in a very portable manner. It comes with docker containers making installation trivial and results highly reproducible.

Pipeline summary

  1. Split mcd file by ROI, and save full and ilastik stacks separately based on specification in metadata.csv (imctools)
  2. Apply preprocessing filters to full stack tiff files (CellProfiler; --full_stack_cppipe parameter)
  3. Merge images from ilastik stack to obtain RGB image of cell nuclei and membranes to generate a composite tiff (CellProfiler; --ilastik_stack_cppipe parameter)
  4. Use composite tiff to classify pixels as membrane, nuclei or background, and save probabilities map as tiff (Ilastik; optional)
  5. Use probability tiffs and preprocessed full stack tiffs for single cell segmentation to generate a cell mask as tiff and then overlay cell mask onto full stack tiff images to extract single cell information generating a csv file (CellProfiler; --segmentation_cppipe parameter)


The nf-core/imcyto pipeline comes with documentation about the pipeline, found in the docs/ directory:

  1. Installation
  2. Pipeline configuration
  3. Running the pipeline
  4. Output and how to interpret the results
  5. Troubleshooting


The pipeline was originally written by the The Bioinformatics & Biostatistics Group for use at The Francis Crick Institute, London.

The pipeline was developed by Harshil Patel and Nourdine Bah in collaboration with Karishma Valand, Febe van Maldegem, Emma Colliver and Mihaela Angelova.

Many thanks to others who contributed as a result of the Crick Data Challenge (Jan 2019) - Gavin Kelly, Becky Saunders, Katey Enfield, Alix Lemarois, Nuria Folguera Blasco, Andre Altmann.

It would not have been possible to develop this pipeline without the guidelines, scripts and plugins provided by the Bodenmiller Lab. Thank you too!


You can cite the nf-core pre-print as follows:
Ewels PA, Peltzer A, Fillinger S, Alneberg JA, Patel H, Wilm A, Garcia MU, Di Tommaso P, Nahnsen S. nf-core: Community curated bioinformatics pipelines. bioRxiv. 2019. p. 610741. doi: 10.1101/610741.