Metadata-Version: 2.1
Name: pgdancer
Version: 0.1
Summary: common dynamic data visualization framework for python
Home-page: https://github.com/zgmphoo/pgdancer
Author: zgmphoo
Author-email: zgmphoo@gmail.com
License: BSD License
Platform: any
Classifier: Operating System :: OS Independent
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Description-Content-Type: text/markdown
Requires-Dist: pandas (>=0.20.1)
Requires-Dist: pygame (>=1.9.5)

### pgdancer：一个python的通用动态数据可视化框架
-----

[English](readme-en.md)


## 介绍
这是一个python的动态数据可视化项目，基于pygame游戏引擎。能够将pandas的Dataframe数据结构使用动态的方法展示。

## Requirements
* Anaconda-python 3.61+ and pygame 1.95+
* Works on Linux, windows, Mac OSX

## 效果展示

![image](docs/images/demo.gif)

# 快速开始

```python
pip install pgdancer
```

打开命令行终端

```python
pgdancer startproject my_project
cd my_project
```

在项目目录中，会生成 settings.py 文件作为设置文件，当你需要它的时候
#### 下载示例csv文件,[点我下载](examples/brands_data.csv)
把文件放在命令行终端的文件夹路径中

```python
vim demo.py
```

写入以下内容并保存

```python
import pandas as pd


from pgdancer import histogram


if __name__ == '__main__':
    # example code
    df = pd.read_csv("brands_data.csv", index_col="brands", thousands=",").fillna(0)
    df = df.astype("int")
    h = histogram.Histogram(df, 1600, 900, window_type=0)
    h.run("pgdancer", "Top 15 Best Global Brands Ranking", "---Datasource:https://www.interbrand.com", \
          "Top 15 Best Global Brands Ranking", "Brand Value:$m")

```

运行python脚本
```python
python demo.py
```

## 使用文档
文档正在编写中

## 特别说明
字体问题: pygame默认字体是英文的,显示中文或特殊文字会出现框框,
以下方法可以获取系统字体列表，增加histogram.py源码中getFontStyle函数中的font_list列表可以解决
PS：后续版本会解决字体问题
```python
import pygame
pygame.font.get_fonts()
```
颜色问题：
pgdancer内置了31种颜色，Dataframe.index 超过31个则会报错
PS：后续版本会解决颜色问题

# 未来的版本
1. 加入有图片的动态样式
2. 加入背景音乐功能
3. 组件化
4. 更漂亮


