Installing the software required for the OneCellPipe system
Here are more detailed instruction for installing and running the OneCellPipe software and its requirements. These instructions are for a Linux Ubuntu system where you have sudo rights, please adjust accordingly if you are using a different flavor of a Unix-based operating system! This is a sub-page of the multi-page documentation for the OneCellPipe pipeline of OneCellBio.
- If necessary, update your system and install Python 2 and build packages – or ask your system administrator for it if you are not allowed to run sudo commands.
python –version should show something like:
sudo apt update sudo apt install -y python build-essential
- If necessary, update / install Java 8 or ask your system administrator for it.
sudo apt install -y default-jre --fix-missing
- Install NextFlow
wget -qO- get.nextflow.io | bash
You can of course use curl if wget is not available. In order to run the software from anywhere in the file system move it to a directory specified in your path settings:
sudo mv nextflow /usr/local/bin/
or add the current location to your path if you do not have sudo permissions. For the bash shell this could be:
echo export PATH=$PATH:$PWD >> ~/.bashrc; source ~/.bashrc
You can print out your current path settings with: echo $PATH
- Install Singularity
We are using the version 2.5.1 at this time (check other versions here, but there might occur format incompatibilities). The installation of Singularity requires sudo rights to work properly.
VERSION=2.5.1 wget https://github.com/singularityware/singularity/releases/download/$VERSION/singularity-$VERSION.tar.gz tar xvf singularity-$VERSION.tar.gz cd singularity-$VERSION ./configure --prefix=/usr/local make sudo make install cd .. rm singularity-$VERSION.tar.gz
In case there is an error like “configure: error: Unable to find the libarchive headers”, please also install:
sudo apt install -y libarchive-dev
- Install the OneCellBio pipeline
We are using the current version 1.21, adjust if necessary.
VERSION=1.21 wget https://s3.amazonaws.com/gt-datastorage/onecellpipe/onecellpipe.$VERSION.tgz tar xzf onecellpipe.$VERSION.tgz rm onecellpipe.$VERSION.tgz
Run the test pipeline
Use the sample data provided to test that everything is working:
cd ~/onecellpipe nextflow onecellpipe.nf --dir sampledata
This will start the process producing out like the following:
N E X T F L O W ~ version 0.27.0 Launching `onecellpipe.nf` [lonely_ekeblad] - revision: 4daa120f75 ====================================== O N E C E L L B I O P I P E L I N E ====================================== Pipeline version : 1.21 Pipeline directory: /home/ubuntu/onecellpipe Project directory : sampledata Log file path : /home/ubuntu/onecellpipe/sampledata/indrop_log.txt Timestamp : Mon Jan 15 12:29:08 UTC 2018 [warm up] executor > local [18/fe30f8] Submitted process > setup (Setup procedure)
This will run in about 5-20 minutes, depending on your number of CPUs/core. An example timeline for a machine with 8 cores can bee seen here.
You can interrupt and end the pipeline by hitting <Ctrl>C.
You can try to resume the pipeline by adding -resume to your command.