{ "cells": [ { "cell_type": "markdown", "metadata": {}, "source": [ "![](images/jupyter_logo.png)\n", "\n", "![](images/cy3logoOrange.svg)\n", " \n", "\n", "# Welcome to cyREST Examples for Python Users!\n", "\n", "![](http://cl.ly/aPle/jupyter-sample1.png)\n", "\n", "\n", "## What is Cytoscape?\n", "[Cytoscape](http://www.cytoscape.org/) is an open source software platform for visualizing complex networks and integrating them with any type of attributes. A lot of [Apps](http://apps.cytoscape.org/) are available for various kinds of problem domains, including bioinformatics, social network analysis, and semantic web.\n", "\n", "## Introduction to cyREST\n", "[cyREST](http://apps.cytoscape.org/apps/cyrest) is a Cytoscape App providing access to Cytoscape core data objects including networks, tables, and Styles via RESTful API, which is totally platform/language independent. This means you can write your own workflows using Cytoscape in programming language of your choice.\n", "\n", "### Target Audience\n", "\n", "* Computational Biologists\n", "* Data Scientists\n", "* And all people who use graph data!\n", "\n", "We assume you have basic knowlege of Cytoscape and Python. Some of the examples require third party libraries, and you need to know how to setup your own Python environment to satisfy the dependencies.\n", "\n", "### Docker Containers for Python Examples\n", "We have a Docker container with standard libraries for network analysis:\n", "\n", "* [Docker Image for Basic Network Analysis](https://registry.hub.docker.com/u/idekerlab/vizbi-2015/)\n", "\n", "And of course, you can use your own environment if you want." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "# Table of Contents\n", "\n", "## Warning: you need Cytoscape 3.2.1 and [cyREST 0.9.17](http://apps.cytoscape.org/apps/cyrest) and newer to run these examples\n", "\n", "----\n", "\n", "## New! Examples Using py2cytoscape\n", "\n", "Although cyREST provides a set of language-agnostic API, it requires some _boilarplate code_ to access raw REST API. To avoid lots of duplicate code, we've released [py2cytoscape](https://github.com/idekerlab/py2cytoscape), a Python wrapper for cyREST. If you use cyREST with py2cytoscape, you can signisicantly reduce lines of code in your workflow. Please visit the link below to see how _natural_ the API is for Python users.\n", "\n", "* [py2cytoscape project web site](https://github.com/idekerlab/py2cytoscape)\n", "* [Sample Notebook using py2cytoscape](http://nbviewer.ipython.org/github/idekerlab/py2cytoscape/blob/develop/examples/New_wrapper_api_sample.ipynb)\n", "\n", "\n", "----\n", "\n", "## Examples Using Raw cyREST API\n", "\n", "----\n", "\n", "### Note: You need to run IPython Notebook server to view the actual results. GitHub may not render notebooks linked from the following list.\n", "\n", " * [How to run these sample notebooks](https://github.com/idekerlab/cy-rest-python/blob/develop/README.md)\n", "\n", "----\n", "\n", "### Basic Exercises\n", "\n", "* [Introduction to cyREST API](basic/CytoscapeREST_Basic1.ipynb)\n", "* [NetworkX and Cytoscape](basic/CytoscapeREST_Basic2.ipynb)\n", "* [Visual Style as a Python Object](basic/CytoscapeREST_Basic3.ipynb)\n", "* [Import KEGG pathways from web service](basic/CytoscapeREST_Basic4_KEGG_API.ipynb)\n", "\n", "\n", "* [Embed your networks as interactive Cytoscape.js widgets](basic/CytoscapeJS_visualization.ipynb)\n", "\n", "\n", "* [RECOMB/Cytoscape 2014 Demo](basic/RECOMB2014_demo-final.ipynb)\n", "\n", "\n", "### [cyREST Cookbook](basic/CyREST_Cookbook.ipynb)\n", "\n", "\n", "### Advanced Exercises\n", "\n", "* [Visualizing differentially expressed transcritome profile](advanced/CytoscapeREST_KEGG_f1000.ipynb)\n", "* [Visualizing time series metabolome profile](advanced/CytoscapeREST_KEGG_time_series.ipynb)\n", "* [Mapping DRUGBANK drug targets to KEGG pathway](advanced/integratingDrugbank.ipynb)\n", "* [Mapping Path2Models whole genome metabolism model to KEGG pathway](advanced/path2models.ipynb)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "# More Information\n", "\n", "\n", "## Workshop Materials\n", "* [VIZBI 2015 Tutorial: Cytoscape, IPython, Docker and Reproducible Data Visualization Workflow](https://github.com/idekerlab/vizbi-2015) - 3/24/2015\n", " * [Lecture slides](http://www.slideshare.net/keiono/vizbi-2015-tutorial-cytoscape-ipython-docker-and-reproducible-network-data-visualization-workflows)\n", "\n", "\n", "* [SDCSB Cytoscape Advanced Tutorial](https://github.com/idekerlab/sdcsb-advanced-tutorial/wiki) - 4/17/2015\n", " * [Lecture slides](http://www.slideshare.net/keiono/sdcsb-cytoscape-advanced-tutorial)\n", "\n", "\n", "## Links to cyREST Resources\n", "\n", "* [User Guide for cyREST](https://github.com/idekerlab/cyREST/wiki)\n", "* [cyREST Page at Cytoscape App Store](http://apps.cytoscape.org/apps/cyrest)\n", "* [Source Code](https://github.com/idekerlab/cyREST)\n", "\n", "\n", "## For R Users\n", "[R example scripts are available here](https://github.com/idekerlab/cy-rest-R).\n", "\n", "\n", "----\n", "\n", "Be sure to follow us on Twitter [@cytoscape](https://twitter.com/cytoscape)! When you tweet about your Cytoscape workflows, please use _#cytoscape_ tag.\n", "\n", "## Contact\n", "For questions, please join the [cytoscape-discuss mailing list](https://groups.google.com/forum/#!forum/cytoscape-discuss)\n", "\n", "Or directly to me (kono at ucsd dot edu)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "" ] } ], "metadata": { "kernelspec": { "display_name": "Python 2", "language": "python", "name": "python2" }, "language_info": { "codemirror_mode": { "name": "ipython", "version": 2 }, "file_extension": ".py", "mimetype": "text/x-python", "name": "python", "nbconvert_exporter": "python", "pygments_lexer": "ipython2", "version": "2.7.10" } }, "nbformat": 4, "nbformat_minor": 0 }