Source

tw2.protovis.hierarchies / README.rst

tw2.protovis.hierarchies

Author: Ralph Bean <rbean@redhat.com>

tw2.protovis.hierarchies is a toscawidgets2 (tw2) wrapper for protovis.

Live Demo

Peep the live demonstration.

Description

toscawidgets2 (tw2) aims to be a practical and useful widgets framework that helps people build interactive websites with compelling features, faster and easier. Widgets are re-usable web components that can include a template, server-side code and JavaScripts/CSS resources. The library aims to be: flexible, reliable, documented, performant, and as simple as possible.

protovis composes hierarchies views of data with simple marks such as bars and dots. Unlike low-level graphics libraries that quickly become tedious for visualization, Protovis defines marks through dynamic properties that encode data, allowing inheritance, scales and layouts to simplify construction.

This module, tw2.protovis.hierarchies, provides toscawidgets2 (tw2) widgets that render protovis data visualizations.

Sampling tw2.protovis.hierarchies in the WidgetBrowser

The best way to scope out tw2.protovis.hierarchies is to load its widgets in the tw2.devtools WidgetBrowser. To see the source code that configures them, check out tw2.protovis.hierarchies/samples.py

To give it a try you'll need git, mercurial, python, and virtualenv. Run:

git clone git://github.com/ralphbean/tw2.protovis.hierarchies.git

cd tw2.protovis.hierarchies

The following script will set up all the necessary tw2 dependencies in a python virtualenv:

./develop-tw2-destroy-and-setup.sh

The following will enter the virtualenv and start up paster tw2.browser:

./develop-tw2-start.sh

...and browse to http://localhost:8000/ to check it out.