sjvisualizer 📊

sjvisualizer is a data visualization and animation library for Python for time-series data.

Like this project? Please consider starring ⭐ the project on GitHub!

Or buying me a coffee. It will make my day! Buy me a Coffee

Installation

sjvisualizer is now available on pypi! Simply use pip to install it:

pip install sjvisualizer

Basic examples

Using sjvisualizer, you can create a basic data animation with one simple line of code.

Bar Race

Basic.Bar.mp4

from sjvisualizer import plot as plt

plt.bar(excel="data/DesktopOS.xlsx", 
        title="Desktop Operating System Market Share", 
        unit="%")

Pie Race

Basic.Pie.mp4

from sjvisualizer import plot as plt

plt.pie(excel="data/browsers.xlsx", 
        title="Desktop Browser Market Share", 
        unit="%")

Animated Line Chart

Basic.Line.mp4

from sjvisualizer import plot as plt

colors = {
    "United States": [
        23,
        60,
        154
    ],
	"Russia": [
        255,
        50,
        50
    ]
}

plt.line(excel="data/military budget.xlsx",
        title="Military Budget of Selected Countries",
        sub_title="in millions of US$",
        colors=colors)

Animated Area Chart

Basic.Area.mp4

from sjvisualizer import plot as plt

colors = {
    "United States": [
        23,
        60,
        154
    ],
	"Russia": [
        255,
        50,
        50
    ]
}

plt.stacked_area(excel="data/Nuclear.xlsx",
        title="Nuclear Warheads by Country",
        colors=colors)

More advanced animations

Using sjvisualizer, you can also mix and match chart types and positions like in the following example:

Cheese.mp4

Learn sjvisualizer

Want to learn more about sjvisualizer:

• Find additional examples and full documentation on my website
• Or follow my course on Udemy

Roadmap

If you like this project, please concider supporting me using PayPal PayPal.

Usage

sjvisualizer is a free and open-source data animation library, please include the following attribution in any publications you use it in.

Made with sjvisualizer, the open-source data animation library for Python

Support this project

If you like this project, please concider supporting me using PayPal PayPal.

Contributing

Contributions are always welcome! A couple of ideas to contribute:

• Improve documentation of this project. I have been thinking of setting up a readthedocs page.
• Add additional example scripts. If you do so, please includy any data files and image files so that the example is fully running
• Add new chart types. I have uploaded an example skeleton of new chart types in Empty.py, this is a setup that should serve as a good starting point. (https://github.com/SjoerdTilmans/sjvisualizer/blob/main/sjvisualizer/Empty.py)

Before making any changes, please create your own development branch here on GitHub. Once ready submit a pull request and set me as reviewer!

License

sjvisualizer is released under the MIT License. See the LICENSE file for more details.

Contact

If you have any questions or suggestions regarding sjvisualizer, post it on my forum.