Skip to content
CellOrganizer for Docker + Jupyter Notebook
Branch: master
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.
cellorganizer-python @ 2bf604f
Dockerfile Added Dockerfile Apr 15, 2019
logo.png Added logo file Apr 15, 2019


Build Status Release Status GitHub issues GitHub forks GitHub stars GitHub license

About CellOrganizer

CellOrganizer Logo

The CellOrganizer project provides tools for

  • learning generative models of cell organization directly from images
  • storing and retrieving those models
  • synthesizing cell images (or other representations) from one or more models

Model learning captures variation among cells in a collection of images. Images used for model learning and instances synthesized from models can be two- or three-dimensional static images or movies.

CellOrganizer can learn models of

  • cell shape
  • nuclear shape
  • chromatin texture
  • vesicular organelle size, shape and position
  • microtubule distribution.

These models can be conditional upon each other. For example, for a given synthesized cell instance, organelle position is dependent upon the cell and nuclear shape of that instance.

Cell types for which generative models for at least some organelles have been built include human HeLa cells, mouse NIH 3T3 cells, and Arabidopsis protoplasts. Planned projects include mouse T lymphocytes and rat PC12 cells.

CellOrganizer v2.8.0


  • Added improved model for generating protein distributions during T cell synapse formation that only requires annotation of cell couples at a single time point model and improves synapse alignment. Includes training, synthesis and info demos.
  • Added outline PCA model for 2D cell and nuclear shapes. Includes training, synthesis and info demos.
  • Added SPHARM-RPDM model for 3D cell and nuclear shapes (see Includes training, synthesis and info demos.


  • Fixed issues with options.train.flag. Valid options should be nuclear, cell, framework, and protein.


  • Modularized and cleaned up img2slml.

Demo List

The following demo scripts are included in the image.

Demo Name Training Synthesis
demo2D00 X
demo2D01 X
demo3D00 X
demo3D11 X
demo3D12 X

The demos in the table above are the same demos included in the Matlab distribution.


Installing Docker

Installing Docker is beyond the scope of this document. To learn about Docker Community Edition (CE), click here.

  • To install Docker-for-Mac, click here.
  • To install Docker-for-Windows, click here.

Installing Kitematic

The easiest way to download an image and run a container is to use Kitematic.

  • To install Kitematic, click here.

About the Docker container

Downloading image and running container using Kitematic

Running Kitematic will open a window that looks like this


Use the searchbar to search for cellorganizer


and click Create.

Downloading image and running container

To build an image using the Dockerfile in this repository, run the command

➜ docker build -t "murphylab/cellorganizer" .

The previous step should build an image

➜  docker container ls -a

CONTAINER ID        IMAGE               COMMAND                  CREATED             STATUS                        PORTS               NAMES
48dde52f2bc8        murphylab/cellorganizer     "/bin/bash -c 'pyt..."   45 seconds ago      Exited (0) 39 seconds ago                         frosty_wescoff

To run a container using the image above

➜  docker run -i -t murphylab/cellorganizer

Additional files

The container comes with


When contributing to this repository, please first discuss the change you wish to make via issue, email, or any other method with the owners of this repository before making a change.

Support for CellOrganizer has been provided by grants GM075205, GM090033 and GM103712 from the National Institute of General Medical Sciences, grants MCB1121919 and MCB1121793 from the U.S. National Science Foundation, by a Forschungspreis from the Alexander von Humboldt Foundation, and by the Freiburg Institute for Advanced Studies.


Copyright (c) 2007-2019 by the Murphy Lab at the Computational Biology Department in Carnegie Mellon University

You can’t perform that action at this time.