/causalpath

A project for exploring differentially active signaling paths related to proteomics datasets

Primary LanguageJavaGNU Lesser General Public License v3.0LGPL-3.0

CausalPath build status

This is a tool for pathway analysis of proteomic and phosphoproteomic datasets. CausalPath aims to identify mechanistic pathway relations that can explain observed correlations in experiments. In the below example, the mesenchymal subtype of ovarian cancer is compared against other subtypes. This graph is focused on the downregulation of MAPK3 in this subtype, suggesting several mechanisms that probably caused it (upstream), and showing its likely downstream effect.

CausalPath sample output network

To analyze your dataset, please visit our web-service that runs an instance of CausalPath.

Alternatively, users can locally run the Java code in this project on their datasets, and visualize the results in ChiBE. But in both cases, to use this tool, users need to prepare input files to feed into the analysis. You can also find a description of output files here.

To get a copy of the project and build it, first make sure you have git, maven and JDK8 in your system, then while in your projects folder, do:

git pull https://github.com/PathwayAndDataAnalysis/causalpath.git
cd causalpath
mvn clean install
mvn assembly:single

The last command should create causalpath.jar under causalpath/target directory. Then you can run the code by

java -jar target/causalpath.jar path/to/input/directory

The input directory has to contain a parameters.txt file which provides the necessary parameters and links to the input data files. Please refer to this page for preparation of inputs.

After CausalPath runs on your input data, it generates output in the same input directory where the parameters.txt is. Among those output files, causal.sif and causal.format are two files that ChiBE needs for displaying the result graph. To display, please open ChiBE and from the menu, do SIF -> Load SIF File. Navigate to the directory and select causal.sif.

A manuscript describing this method is available here. Additionally, another manuscript that use CausalPath to explore platelet activation pathways is available here.