ParticleStats: Open source software for the analysis of intracellular particle motility and cytoskeletal polarity
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

 ____            _   _      _      ____  _        _                   
|  _ \ __ _ _ __| |_(_) ___| | ___/ ___|| |_ __ _| |_ ___             
| |_) / _` | '__| __| |/ __| |/ _ \___ \| __/ _` | __/ __|            
|  __/ (_| | |  | |_| | (__| |  __/___) | || (_| | |_\__ \            
|_|   \__,_|_|   \__|_|\___|_|\___|____/ \__\__,_|\__|___/            


Open source software for the analysis of particle motility and cytoskelteal polarity

ParticleStats was created by Russell Hamilton (Centre for Trophoblast Research, University of Cambridge) and Ilan Davis (Department of Biochemistry, University of Oxford) and in collaboration with the Micron Advanced Imaging Facility.

Project Page

If you have ideas or request for new features please submit them as issues.


Hamilton, R.S., Parton, R.M., Oliveira, R.A., Ball, G., Vendra, G., Nasmyth, K. & Davis, I. (2010) ParticleStats: Open source software for the analysis of intracellular particle motility and cytoskeletal polarity. Nucleic Acids Research (Web Server Edition) [DOI]


The study of dynamic cellular processes in living cells is central to biology and is particularly powerful when the motility characteristics of individual objects within cells can be determined and analysed statistically. However, commercial programs only offer a very limited range of inflexible analysis modules and there are currently no open source programs for extensive analysis of particle motility. Here, we describe ParticleStats (, a web server and open source programs, which input the X,Y co-ordinate positions of objects in time, and outputs novel analyses, graphical plots and statistics for motile objects. ParticleStats comprises three separate analysis programs. Firstly ParticleStats:Directionality, for the global analysis of polarity, for example microtubule plus end growth in Drosophila oocytes. Secondly, ParticleStats:Compare for the analysis of saltatory movement in terms of runs and pauses. This can be applied to chromosome segregation and molecular motor based movements. Thirdly, ParticleStats:Kymographs for the analysis of kymograph images, for example as applied to separation of chromosomes in mitosis. These analyses have provided key insights into molecular mechanisms that are not possible from qualitative analysis alone and are widely applicable to many other cell biology problems.

Command Line Version

ParticleStats depends on several external packages to run, to simpify the installation there is a Docker version (see below).

The command line version has been tested on Linux and MacOSX

Dependency Source
Python Modules Source
pillow, scipy, boot, xlwt, matplotlib, rpy2, xlrd
R libraries Source

For the command line version, once the dependencies are met, ParticleStats can be installed and run as follows.

git clone

cd ParticleStats

The three main tools, plus basic usage are: --help --help --help
Docker Version

The Docker version of ParticleStats requires only Docker to be pre-installed. And the ParticleStats repository to be cloned - actually the only requirement from the ParticleStats repositoru is the Dockerfile. The Docker version compiles all the required packages automatically. Download and install Docker and then follow the steps below:

  1. git clone

  2. cd ParticleStats

  3. docker build -t particlestats_docker .

  4. docker run -it particlestats_docker

A Docker Hub version is planned to further similify the installation and usage of the Docker Version of ParticleStats.

Publications Citing ParticleStats
  • Oliveira, R.A., Hamilton, R.S., Pauli, A., Davis, I., Nasmyth, K. (2010) Cohesin cleavage and Cdk inhibition trigger formation of daughter nuclei. Nature Cell Biology, 12, 185-192 [DOI]

  • Vendra, G., Hamilton, R.S. & Davis, I. (2007) Dynactin suppresses the retrograde movement of apically localized mRNA in Drosophila blastoderm embryos. RNA, 13, 1-8. [DOI]

  • Parton, R.M., Hamilton, R.S., Ball, G., Yang, L., Cullen, F., Lu, W., Ohkura, H. & Davis, I. (2011) A PAR-1 dependent orientation gradient of dynamic microtubules establishes cell polarity in the Drosophila oocyte. Journal of Cell Biology, 194, 121-135. [DOI]

  • Hartswood. E., Brodie, J., Vendra, G., Davis, I. and Finnegan. D.J. (2012) RNA:RNA interaction can enhance RNA localization in Drosophila oocytes. RNA, 18, 1-9. [DOI]

GNU License

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see

This software is still being developed so beware of bugs and feel free to suggest features