This git repo contains the companion code the manuscript Statistical Assessment and Visualization of Synergies for Large-Scale Sparse Drug Combination Datasets, by Arnaud Amzallag, Sridhar Ramaswamy, Cyril H. Benes, from the MGH Cancer Center.
This script allows to reproduce, from raw data, the statistical analysis for the significance assessment of synergies in the systematic drug screen performed at the MGH Cancer Center. The script is thoroughly commented and is intended to be read and executed on the R prompt. It produces several diagnostic and explainatory figures. this code should:
- provide a transparent description of the methods used in the study
- expose a novel way of estimating single drugs viability for estimation of drug synergy
- facilitate follow-up analysis and exploration of the large combination data published with the study
In addition, it provide the code of a web app for rapid interactive visualization of the 439,128 drug combination viabilities provided, which is available at http://www.cmtlab.org:3000/combo_app.html
We recommand running the R analysis on a machine with at least 8 Gb of memory.
The following packages must be installed: dplyr
, reshape2
, readr
and ggplot2
.
To understand the processing and analysis steps from raw data, we recommand to follow the commented script combos_script.R
and execute it line by line.
However, if you just want to obtain all the output files at once (including the necessary files to run the web app),
you can run the full script with
Rscript combos_script.R
on the command line. It should take between 5 and 10 minutes to run.
- Run
combos_script.R
(see above) to produce the summarized data files that are used for the web visualization. - Install npm, since the web app is running on Node.js, a lightweight web server written in javascript.
- From the directory
combo_web
, runnpm install
(you might needsudo npm install
, on ubuntu for instance). - Run
node server.js
- In a web browser, go to
http://localhost:3000/combo_app.html
For convenience, a docker image is available on dockerhub.org, and the current web application can be started with the following command:
docker run --rm -p 3000:3000 -d arnaudmgh/synergy-screen-app
The Dockerfile is available in this repository.
Additionally, the script aws-init.sh can be used as User Data to start an AWS instance (from a standard Amazon AMI) to host the web application in a private AWS cloud.
- The security group should allow TCP port 3000 inbound from anywhere;
- The web application will be accessible at
http://<your-instance-IP>:3000/combo_app.html
node server.js
returnsError: ENOENT: no such file or directory, open './combo_all_combos2.csv'
. Have you run the R scriptcombos_script.R
, and did it write the filecombo_all_combos2.csv
in the right directory (combo_web
)?- The script does not finish: It could be that your machine does not have enough memory. We recommend at least 8 Gb of memory.