Installing CellOrganizer for Docker¶
Introduction¶
CellOrganizer for Docker contains binaries for the two main functions which this document will cover
- img2slml, the top-level function to train generative models of cell, and
- slml2img, the top-level function to generate simulated instances from a trained generative model.
- slml2info, the top-level function to generate a report from information extracted from a single generative model.
- slml2report, the top-level function to generate a report from comparing generative models.
Setup¶
The following instructions describe
- How to install Docker, the virtualization engine that will run the container
- How to install Kitematic, a UI for Docker
- How to download the latest cellorganizer-docker image from Docker Hub, i.e. the docker images repository
- How to start a container from the Docker image
- How to connect to the container
- How to run some of the demos included in the container
Source Code¶
For convenience, the Docker image can be found in Docker Hub along with links to the Dockerfile.
The instructions below will show you how to download and use this image.
Installing Docker¶
Before downloading the image and spinning a cotainer, you need to install Docker. Installing Docker is beyond the scope of this document. To learn about Docker Community Edition (CE), click here.
Download the most recent image using Docker command line
Open terminal and enter the command
docker pull murphylab/cellorganizer:latest
Running this command will initiate download and pull the most recent image of cellorganizer-docker from Docker Hub down to your computer.

Once the download is complete, you can confirm the image was downloaded by entering the command:
docker images
You should see a record of a docker image identified by its repository murphylabs/cellorganizer and the tag latest.
Installing Kitematic¶
The easiest way to download an image and run a container is to use Kitematic. Kitematic is a tool for downloading images and running containers.
- To install Kitematic, click here.
Attention
Kitematic is not necessary but it is reccomended to streamline installation and deployment
Download the most recent image using Kitematic
Start Kitematic. It should open a window similar to the screenshot below

Demos included in the distribution¶
There are several demos included within the CellOrganizer software bundle. These demos are intended to illustrate CellOrganizer’s functionality, and should be used to familiarize the user with the input/output format of various top-level functions such as img2slml and slml2img.
Demo | Training | Synthesis |
---|---|---|
demo2D00 | True | |
demo2D01 | True | |
demo2D02 | True | |
demo2D03 | True | |
demo2D04 | True | |
demo2D05 | True | |
demo3D00 | True | |
demo3D01 | True | |
demo3D02 | True | |
demo3D03 | True | |
demo3D04 | True | |
demo3D06 | True | |
demo3D07 | True | |
demo3D08 | True | |
demo3D09 | True | |
demo3D10 | True | |
demo3D11 | True | |
demo3D12 | True | |
demo3D20 | True | |
demo3D21 | True |