tw2.protovis.hierarchies / README.rst

tw2.protovis.hierarchies

Author: Ralph Bean <ralph.bean@gmail.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.

Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.