ico v0.3.3

h2. Introduction

Ico is a JavaScript graph library that uses "Raphael":http://raphaeljs.com/ to draw. This means it can draw graphs in multiple browsers (including IE).

Raphael is the only dependency. I've tested the examples with Raphael 2.0 and they appear to work correctly, but please report bugs through GitHub.

• "Documentation":http://alexyoung.github.com/ico
• "Examples":http://alexyoung.github.com/ico/examples.html

h3. Support

Donations to support future development are welcome and appreciated: "Donate":https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=support%40helicoid%2enet&lc=GB&item_name=Helicoid%20Limited&no_note=0&cn=Add%20special%20instructions%20to%20the%20seller&no_shipping=2¤cy_code=USD&bn=PP%2dDonationsBF%3abtn_donateCC_LG%2egif%3aNonHosted

h3. Targeted graph types

• Sparklines
• Line graphs
• Bar graphs

h3. Design considerations and goals

• Clarity: Use of white-space to help lend clarity to graphs, nominal scale vs. ordinal scale
• Simplicity: Minimal use of decorations and lines, reliance on the Gestalt principle of closure
• Conciseness: Avoidance of graph types that don't efficiently present data (pie charts, radar maps)

These goals are based on recommendations in Stephen Few's books:

• Show Me the Numbers: Designing Tables and Graphs to Enlighten
• Information Dashboard Design

Which was generally in turn based on Edward Tufte's work.

h3. Test-Driven

Built with QUnit and Node unit tests.

h3. Todo

• Humanize labels: rather than showing 1,000,000 optionally show "1m"

h2. Examples

See index.html for current API usage. This will change as I evolve the API to support the targeted graph types.

h2. Requirements

• "Raphael":http://raphaeljs.com

h3. License

MIT License.