BioJS component for PCViz embedded widget
PCViz is a web-based binary interaction visualizer that pulls in data from Pathway Commons. PCViz has an embedded widget option that can be used by other developers to easily show network on their web sites. This module wraps this functionality around BioJS framework for better and easier integration by developers.
Here some useful PCViz links:
- PCViz Homepage: http://www.pathwaycommons.org/pcviz
- PCViz on BioJS Registry: http://biojs.io/d/biojs-pcviz
- Pathway Commons: http://www.pathwaycommons.org/about/
Install the module with: npm install biojs-pcviz
or you can use the browser version from the latest build:
https://github.com/PathwayCommons/biojs-pcviz/tree/master/build
The following code sample shows how to use this component in a simple way:
var biojspcviz = require('biojs-pcviz');
// Create an instance of PCViz
// and visualize the neighborhood of "BRCA1" gene in a div using this new instance
var yourDiv = document.getElementById('yourDiv');
var pcviz = new biojspcviz({ el: yourDiv, query: "BRCA1"});
pcviz.neighborhood();You can find more examples under the examples folder:
https://github.com/PathwayCommons/biojs-pcviz/tree/master/examples
var opts = {
// Target HTML element
el: document.createElement("div"),
// Base URL for the target PCViz instance
baseurl: "http://sanderlab.org/pcviz/",
// Width of the iframe
width: "100%",
// Height of the iframe
height: "100%",
// Query gene(s); delimited by comma (",") if more than one
query: "MDM2",
// If PCViz doesn't get loaded in this time, onFail will be called
timeout: 20 * 1000,
// Callback function for network load event
onLoad: function(msg) {},
// Callback function for node clicks; msg contains information about the node
onNodeClick: function(msg) {},
// Callback function for edge clicks; msg contains information about the edge
onEdgeClick: function(msg) {},
// Callback function for background clicks; msg containts no information
onBackgroundClick: function(msg) {},
// Callback function to be called if network doesn't get loaded in timeout miliseconds.
onFail: function() {}
}Visualizes the neighborhood of all query genes.
Example:
// Loads neighborhood of BRCA2
var pcviz = new biojspcviz({ el: thatEl, query: "BRCA2"});
pcviz.neighborhood();Queries the path between two or more genes.
Returns a less dense network compared to neighborhood.
Example:
// Loads paths between TP53,MDM2
var pcviz = new biojspcviz({ el: thatEl, query: "TP53,MDM2" });
pcviz.pathsbetween();Please submit all issues and pull requests to the PathwayCommons/biojs-pcviz repository!
If you have any problem or suggestion please open an issue here.
This program is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public License along with this program. If not, see http://www.gnu.org/licenses/.