Skip to main content
Help us improve Python packaging – donate today!

Python tools for quantitative, reproducible flow cytometry analysis

Project Description

Welcome to a different style of flow cytometry analysis. Take a look at some example Jupyter notebooks:

What’s wrong with other packages?

Packages such as FACSDiva and FlowJo are focused on primarily on identifying and counting subpopulations of cells in a multi-channel flow cytometry experiment. While this is important for many different applications, it reflects flow cytometry’s origins in separating mixtures of cells based on differential staining of their cell surface markers.

Cytometers can also be used to measure internal cell state, frequently as reported by fluorescent proteins such as GFP. In this context, they function in a manner similar to a high-powered plate-reader: instead of reporting the sum fluorescence of a population of cells, the cytometer shows you the distribution of the cells’ fluorescence. Thinking in terms of distributions, and how those distributions change as you vary an experimental variable, is something existing packages don’t handle gracefully.

What’s different about CytoFlow?

A few things.

  • Free and open-source. Use the software free-of-charge; modify it to suit your own needs, then contribute your changes back so the rest of the community can benefit from them.
  • Provides both Python modules (relatively complete) and a point-and-click interface (still in development)
  • An emphasis on metadata. CytoFlow assumes that you are measuring fluorescence on several samples that were treated differently: either they were collected at different times, treated with varying levels of inducers, etc. You specify the conditions for each sample up front, then use those conditions to facet the analysis.
  • Cytometry analysis conceptualized as a workflow. Raw cytometry data is usually not terribly useful: you may gate out cellular debris and aggregates (using FSC and SSC channels), then compensate for channel bleed-through, and finally select only transfected cells before actually looking at the parameters you’re interested in experimentally. CytoFlow implements a workflow paradigm, where operations are applied sequentially; a workflow can be saved and re-used, or shared with your coworkers.
  • Easy to use. Sane defaults; good documentation; focused on doing one thing and doing it well.
  • Good visualization. I don’t know about you, but I’m getting really tired of FACSDiva plots.
  • Versatile. Built on Python, with a well-defined library of operations and visualizations that are well separated from the user interface. Need an analysis that CytoFlow doesn’t have? Export your workflow to an IPython notebook and use any Python module you want to complete your analysis. Data is stored in a pandas.DataFrame, which is rapidly becoming the standard for Python data management (and will make R users feel right at home.)
  • Extensible. Adding a new analysis module is simple; the interface to implement is only two or three functions.
  • Quantitative and statistically sound. Ready access to useful data-driven tools for analysis, such as fitting 2-dimensional Gaussians for automated gating and mixture modeling.

Note: this is still beta software! Caveat emptor!

Installation

**If you just want the point-and-click version (not the Python modules), you can install it from http://bpteague.github.io/cytoflow/

See the installation notes on ReadTheDocs. Installation has been tested on Linux (Ubuntu Trusty), Windows (x86_64) and Mac.

Documentation

There is some basic documentation at ReadTheDocs. Perhaps of most use is the module index. The example Jupyter notebooks, above, demonstrate how the package is intended to be used interactively.

Required packages

These are all in the setuptools spec.

For the core cytoflow library, you need the following Python packages:

python >= 3.4
pandas >= 0.21.1
numpy >= 1.11.3
numexpr >= 2.6.4
matplotlib >= 1.5.1, <= 1.5.3
scipy >= 1.0.0
scikit-learn >= 0.19.1
seaborn >= 0.8.1
traits >= 4.6.0
nbformat >= 4.2.0
python-dateutil >= 2.6.0
statsmodels >= 0.8.0
fcsparser >= 0.1.3

For the GUI, you additionally need:

faulthandler >= 2.4
pyface == 5.1.0
envisage >= 4.6
pyqt >= 4.10 -- this must be installed separately!  it's not available through PyPI!

Note that many of these packages have additional dependencies, including but not limited to traitsui, decorator, etc. Everything except PyQT should be a well well-behaved PyPI package; you should be able to install all the above with pip install or the Canopy package manager.

Release history Release notifications

This version
History Node

0.8.0

History Node

0.5.2

History Node

0.5.0

History Node

0.4.1

History Node

0.4.0

History Node

0.3.2

History Node

0.3.0

History Node

0.2.0

History Node

0.1.11

History Node

0.1.10

History Node

0.1.9

History Node

0.1.8

History Node

0.1.7

History Node

0.1.5

History Node

0.1.4

History Node

0.1.2

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
cytoflow-0.8.0-cp35-cp35m-macosx_10_6_x86_64.whl (602.8 kB) Copy SHA256 hash SHA256 Wheel cp35 Feb 11, 2018
cytoflow-0.8.0-cp35-cp35m-win32.whl (596.0 kB) Copy SHA256 hash SHA256 Wheel cp35 Feb 11, 2018
cytoflow-0.8.0-cp35-cp35m-win_amd64.whl (600.7 kB) Copy SHA256 hash SHA256 Wheel cp35 Feb 11, 2018
cytoflow-0.8.0.tar.gz (5.4 MB) Copy SHA256 hash SHA256 Source None Feb 11, 2018
cytoflow-0.8.0.win32-py3.5.exe (1.1 MB) Copy SHA256 hash SHA256 Windows Installer 3.5 Feb 11, 2018
cytoflow-0.8.0.win-amd64-py3.5.exe (1.3 MB) Copy SHA256 hash SHA256 Windows Installer 3.5 Feb 11, 2018

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page