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.
- 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 https://doi.org/10.1093/bioinformatics/bty983). 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.
The following demo scripts are included in the image.
The demos in the table above are the same demos included in the Matlab distribution.
Installing Docker is beyond the scope of this document. To learn about Docker Community Edition (CE), click here.
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
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
The container comes with
- CellOrganizer binaries
- Generative models
- Murphy Lab 2D/3D HeLa datasets
- BioFormats tools
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.