sjvisualizer 📊

sjvisualizer 是一个用于时间序列数据的 Python 数据可视化和动画库。

喜欢这个项目吗？请考虑在 GitHub 上为项目点亮星星 ⭐！

或者给我买杯咖啡。这会让我非常开心！给我买杯咖啡

安装

sjvisualizer 现已在 pypi 上提供！只需使用 pip 即可安装：

pip install sjvisualizer

基本示例

使用 sjvisualizer，你可以用一行简单的代码创建基本的数据动画。

条形图竞赛

https://github.com/SjoerdTilmans/sjvisualizer/assets/37220662/9340572c-56f8-4abd-97c5-e8ed674a6751

from sjvisualizer import plot as plt

plt.bar(excel="data/DesktopOS.xlsx", 
        title="桌面操作系统市场份额", 
        unit="%")

饼图竞赛

https://github.com/SjoerdTilmans/sjvisualizer/assets/37220662/5db0d056-578e-4070-b1ba-713e590acd3d

from sjvisualizer import plot as plt

plt.pie(excel="data/browsers.xlsx", 
        title="桌面浏览器市场份额", 
        unit="%")

动态折线图

https://github.com/SjoerdTilmans/sjvisualizer/assets/37220662/deae9c3c-8a90-4e64-a036-39fd636746a7

from sjvisualizer import plot as plt

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

plt.line(excel="data/military budget.xlsx",
        title="选定国家的军事预算",
        sub_title="单位：百万美元",
        colors=colors)

动态面积图

https://github.com/SjoerdTilmans/sjvisualizer/assets/37220662/6304bb63-1076-4da8-b044-595f763d3546

from sjvisualizer import plot as plt

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

plt.stacked_area(excel="data/Nuclear.xlsx",
        title="各国核弹头数量",
        colors=colors)

数据格式

目前 sjvisualizer 从 Excel 文件读取数据。格式应如下图所示：

<img width="377" alt="示例数据格式" src="https://github.com/SjoerdTilmans/sjvisualizer/assets/37220662/fb5b0665-77f0-4d08-81d5-05c84e02804e">

在这个文件中，第一列应包含日期，随后的每一列包含数据类别的数据，在这个例子中是不同的国家。

日期可以仅显示年份，或如下所示的完整日期。在这种情况下，请确保 Excel 将单元格识别为日期。

<img width="651" alt="示例数据格式_长" src="https://github.com/SjoerdTilmans/sjvisualizer/assets/37220662/999d1f19-60d6-4a16-a5fb-ea2d17671013">

更高级的动画

使用 sjvisualizer，你还可以像以下示例那样混合搭配图表类型和位置：

https://github.com/SjoerdTilmans/sjvisualizer/assets/37220662/420ed4a0-5bfb-436a-8f61-4e77c640f78f

学习 sjvisualizer

想了解更多关于 sjvisualizer 的信息：

• 在我的网站上查找其他示例和完整文档
• 或者在 Udemy 上学习我的课程

路线图

使用

sjvisualizer 是一个免费开源的数据动画库，请在使用它的任何出版物中包含以下署名。

使用 sjvisualizer 制作，这是一个开源的 Python 数据动画库

支持这个项目

如果你喜欢这个项目，请考虑通过 PayPal 给我买杯咖啡 来支持我。

贡献

欢迎随时贡献！一些贡献的想法：

• 改进这个项目的文档。我一直在考虑建立一个 readthedocs 页面。
• 添加额外的示例脚本。如果这样做，请包含任何数据文件和图像文件，以便示例可以完全运行。
• 添加新的图表类型。我已经在 Empty.py 中上传了新图表类型的示例框架，这是一个应该作为良好起点的设置。(https://github.com/SjoerdTilmans/sjvisualizer/blob/main/sjvisualizer/Empty.py)

在进行任何更改之前，请在 GitHub 上创建你自己的开发分支。准备就绪后，提交拉取请求并将我设为审核者！

许可证

sjvisualizer 在 MIT 许可证下发布。有关更多详细信息，请参阅 LICENSE 文件。

联系

如果你对 sjvisualizer 有任何问题或建议，请在我的论坛上发布。