Public | Automated Build

Last pushed: 3 years ago
Short Description
Network analysis and visualization toolkit for VIZBI 2015 tutorial session
Full Description

VIZBI 2015 Tutorial: Cytoscape, IPython, Docker and Reproducible Data Visualization Workflow

Release History

  • 3/27/2015: Rev. 0.5.0. Samples used in VIZBI tutorials

Please read this wiki first!


This is the repository for the course material used in VIZBI 2015 tutorial session. By following these lessons, you will learn:

  • How to use basic features of IPython Notebook (or Jupyter. Essentially those two are the same.)
  • Basics of RESTful API for Cytoscape (cyREST)
  • Data round trip between cyREST-compatible JSON (same as the one used in Cytoscape.js. See the example below) and NetworkX
  • Simple data analysis with NetowrkX and other libraries (igraph and graph-tool)
  • How to creaet reproducible data visualization scripts in Python

Quick Start Guide

Required Software Pakcages

Make sure your machine has the following to run these notebooks:

  • Git (Tested on 2.3.3)
  • Docker (Tested on 1.5)

For the cyREST part, you also need the following:

Option 1: Run the container

If you just want to run these workflows, simply follow this instruction:

  1. (Optional) Fork this repo to your own account
  2. Clone this repo: git clone
  3. cd vizbi-2015
  4. Run Docker image:
    docker run -d -p 80:8888 -v $PWD:/notebooks -e "PASSWORD=you_can_use_your_own_pw" -e "USE_HTTP=1" idekerlab/vizbi-2015
  5. Mac & Windows users: If you use boot2docker to run Docker commands, check the VM's IP address: boot2docker ip
  6. Open the URL: or http://localhost
  7. Type your password and start rom Lesson 0 in tutorials directory

Option 2: Hack the container

If you want to edit the container image first, follow this instruction:

  1. Fork this repo to your own account
  2. Clone the repo you just forked to your account
  3. cd into the dir
  4. Edit Dockerfile and add whatever you want to add to this sample image
  5. Build the image: docker build -t cyrest-tutorials .
  6. Run Docker image:
    docker run -d -p 80:8888 -v $PWD:/notebooks -e "PASSWORD=you_can_use_your_own_pw" -e "USE_HTTP=1" cyrest-tutorials
  7. Follow the instruction above from #4

For more information and backgrounds, please read this page.

Sample Cytoscape.js style object

    data: {name: 'network_name'},
    elements: {
    nodes: [
      { data: { id: 'foo' } }, // NB no group specified

      { data: { id: 'bar' } },

        data: { weight: 100 }, // elided id => autogenerated id 
        group: 'nodes',
        position: {
          x: 100,
          y: 100

    edges: [
      { data: { id: 'baz', source: 'foo', target: 'bar' } } // NB no group specified


Send them to me (kono ucsd edu).

Docker Pull Command
Source Repository