Skip to main content

Python SVG Charting Library

Project description

Status and License

svg.charts is a pure-python library for generating charts and graphs in SVG, originally based on the SVG::Graph Ruby package by Sean E. Russel.

svg.charts supercedes svg_charts 1.1 and 1.2.

svg.charts is written by Jason R. Coombs. It is licensed under an MIT-style permissive license.

You can install it with easy_install or pip:

easy_install svg.charts
pip install svg.charts

Or, check out the mercurial repository source.

Tests are continuously run by Travis-CI: BuildStatus

To run the tests, refer to the .travis.yml file for the steps run on the Travis-CI hosts.

Acknowledgements

svg.charts depends heavily on lxml and cssutils. Thanks to the contributors of those projects for stable, performant, standards-based packages.

Sean E. Russel for creating the SVG::Graph Ruby package from which this Python port was originally derived.

Leo Lapworth for creating the SVG::TT::Graph package which the Ruby port was based on.

Stephen Morgan for creating the TT template and SVG.

Getting Started

svg.charts has some examples (taken directly from the reference implementation) in tests/samples.py. These examples show sample usage of the various chart types. They should provide a good starting point for learning the usage of the library.

An example of using svg.charts in a CherryPy web app can be found in jaraco.site.charts. If the site is working, you can see the rendered output here.

svg.charts also provides API documentation.

Upgrade Notes

Upgrading from 1.x to 2.0

I suggest removing SVG 1.0 from the python installation. This involves removing the SVG directory (or svg_chart*) from site-packages.

Change import statements to import from the new namespace, so:

from SVG import Bar
Bar.VerticalBar(...)

becomes:

from svg.charts.bar import VerticalBar
VerticalBar(...)

More To-Dos

  • Documentation! This package desperately needs some high-level, tutorial-style how-tos, and not just links to example code.

  • Implement javascript-based animation (See JellyGraph for a Silverlight example of what simple animation can do for a charting library).

Reporting Bugs and Getting Help

This project is hosted at BitBucket. Please use that site for reporting bugs and requesting help. Patches are also welcome.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

svg.charts-3.2.tar.gz (32.8 kB view details)

Uploaded Source

Built Distribution

svg.charts-3.2-py2.py3-none-any.whl (32.5 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file svg.charts-3.2.tar.gz.

File metadata

  • Download URL: svg.charts-3.2.tar.gz
  • Upload date:
  • Size: 32.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for svg.charts-3.2.tar.gz
Algorithm Hash digest
SHA256 8c4b3fe02cae7af6dd809169f8209d812a286de4f2c5f8caa9e8c062b00f8811
MD5 66290840c4d7253017658b57db281465
BLAKE2b-256 2514dc769cbd9f01838e5c8afc0e30bed3d32ba292d447033ed96f2d0a999e62

See more details on using hashes here.

Provenance

File details

Details for the file svg.charts-3.2-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for svg.charts-3.2-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 b41b22a3472c76f9e70a016a1f8485e69f24dbfc3de1e2ff63ab4dd2b6dfd9ff
MD5 ac65cbab3b47d60d751b710fd7fb2199
BLAKE2b-256 1e26c171a3f2e67edb58fa61835f263feba94ec536d480e1757eb96557dae95c

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page