Table of Contents
There are currently no required Pythom modules for the core Cell Browser script:
Installation instructions for a variety of methods are below, with pip being the
With pip (recommended)¶
To install the Cell Browser using pip, you will need Python2.5+ or Python3+ and pip. With these setup, on a Mac or any Linux system, simply run:
sudo pip install cellbrowser
On Linux, if you are not allowed to run the sudo command, you can install the Cell Browser into your user home directory:
pip install --user cellbrowser export PATH=$PATH:~/.local/bin
You can add the second command to your ~/.profile or ~/.bashrc, this will allow you to run the Cell Browser commands without having to specify their location.
On OSX, if running
sudo pip outputs command not found, you will need to setup pip first by running:
sudo easy_install pip
If you would prefer to install the Cell Browser through bioconda, you can run:
conda install -c bioconda ucsc-cell-browser
There should be conda versions for release 0.4.23 onwards. Please indicate in any bug reports if you used conda to install.
With git clone¶
Pip is not required to install the Cell Browser. As an alternative to pip or conda, you can also git clone the repo and run the command line scripts under cellbrowser/src:
git clone https://github.com/maximilianh/cellBrowser.git --depth=10 cd cellBrowser/src
With wget or curl¶
You don’t use pip, conda or git? You can also download the current master branch:
wget https://github.com/maximilianh/cellBrowser/archive/master.zip unzip master.zip cellBrowser-master/src/cbBuild
Notes on Windows Installation¶
First install the Windows Linux subsystem. Then open the Windows Linux Subsystem bash terminal and run these commands:
sudo apt-get update sudo apt-get install python-pip sudo pip install cellbrowser
To take advantage of some of the advanced features or specialized scripts
cbSeurat, you will need to install some extra packages or tools.
To get the image sizes, cbBuild uses either the “file” command or the “identify” command (for JPEGs). You may have to install the ImageMagick package to get the identify command.
In your cellbrowser.conf you can specify a file with custom colors for your metadata values. If this file contains HTML color names instead of color codes, you have to install the module webcolors:
pip install webcolors
Matrices in mtx format¶
To read expression matrices in .mtx format, you have to install scipy:
pip install scipy