IsoProt is a fully reproducible one-stop-shop for the analysis of iTRAQ/TMT data.
Read the IsoProt manuscript at JPR (open access)
Installation
The easiest way to install and run IsoProt is by using our docker-launcher tool. For more information on how to install a ProtProtocol image like IsoProt using docker-launcher have a look at this documentation.
The rest of this document only refers to running the IsoProt image without using docker-launcher. All of these steps are otherwise automatically taken care of by docker-launcher.
Manual installation
IsoProt is a Docker image and can also manually be installed using the docker
command line tool. As a prerequestite, Docker needs to be installed on the system. For more information, please have a look at our help pages on installing Docker.
Note: The following instructions refer to your operating system’s command line.
Download the image:
# Download version 0.2 of the image
docker pull protprotocols/isoprot:release-0.2
# Download the latest version of the image
docker pull protprotocols/isoprot:latest
Manually run the image
docker run -it -p 8888:8888 protprotocols/isoprot:release-0.2
Note: Replace the release-0.2
portion with the version of the image you downloaded and want to launch.
This will launch the image and make it available to access on http://localhost:8888.
In order to directly access your computer’s folders through the docker image (recommended option) map local directories to the containers /data (for input data) and OUT (for output data) folders:
docker run -it -p 8888:8888 -v /path/to/my/mgf/files:/data/ -v /path/to/my/result/folder:/home/biodocker/OUT protprotocols/isoprot
Note: When running Docker Toolbox (ie. only available version on Windows 7), local paths must be below C:\Users. Additionally, paths need to specified in the following format:
# to map C:\Users\Johannes\Downloads
docker run -it -p 8888:8888 -v /c/users/johannes/downloads:/data/ -v /c/users/johannes/results:/home/biodocker/OUT protprotocols/isoprot
Access the Notebook
If you launched the image as described above, the Jupyter notebook is available at http://localhost:8888. Simply open the link and access the Jupyter server.
You can start with the example use case by clicking on the file Isobaric_Workflow.ipynb