# echartspy

**Repository Path**: yiliuyan161/echartspy

## Basic Information

- **Project Name**: echartspy
- **Description**: 帮助用户在python环境使用echarts
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: https://echartspy.icopy.site
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2021-08-02
- **Last Updated**: 2021-11-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Echarts, Python, 数据可视化, pyecharts, echartspy

## README

# chartspy

[English documents](https://chartspy.icopy.site/en/)
[中文文档](https://chartspy.icopy.site)

帮助用户在python环境使用echarts  g2plot 绘图


不同于pyecharts，不对echarts 概念和属性进行python映射和二次抽象，保证库不依赖于特定echarts版本

* 实现了 python配置<=>JavaScript配置的**双向互转**

* 同时借鉴**plotly.express** 封装了简单图表类型可视化函数


## 使用说明

### 简单模式

```python
import chartspy.express as ex

ex.scatter_echarts(df, x='数量', y='价格', size='数量', group='水果', size_max=50, height='250px', title='scatter')

ex.pie_echarts(df, name='水果', value='数量', rose_type='area', title="pie2", height='350px')

ex.candlestick_echarts(df, left='5%', mas=[5, 10, 30], title='平安银行')
```
!!! note ""
    ![scatter](https://github.com/yiliuyan161/echartspy/blob/master/docs/images/scatter.png?raw=true)

!!! note ""
    ![line](https://github.com/yiliuyan161/echartspy/blob/master/docs/images/pie.png?raw=true)

!!! note ""
    ![kline](https://github.com/yiliuyan161/echartspy/blob/master/docs/images/kline.png?raw=true)

### 高级模式

#### 同js写法

手工书写，参考 [echarts配置手册](https://echarts.apache.org/zh/option.html#title)

```python
from chartspy import Echarts, Tools

options = {
    'xAxis': {},
    'yAxis': {},
    'series': [{
        'symbolSize': 20,
        'data': [
            [10.0, 8.04],
            [8.07, 6.95],
            [13.0, 7.58],
            [9.05, 8.81],
            [11.0, 8.33]
        ],
        'type': 'scatter'
    }]
}
Echarts(options, height='600px', title='散点图测试').render_notebook()

```

```python
from chartspy import G2PLOT, Tools

# G2PLOT
df= ...
# Echarts
options = {
    'xField':'time',
    'yField':'close'
}
G2PLOT(df,plot_type='Line',options=options).render_notebook()
```


#### 半自动JavaScript配置->Python配置

半自动，从[echarts示例](https://echarts.apache.org/examples/zh/index.html) 拷贝js配置，自动生成对应的python配置

convert_js_to_dict(js_str,**print_dict=True**) 会在控制台打印python 配置, 粘贴进行二次加工

```python
from chartspy import Echarts, Tools, Js

js_str = """
{
    xAxis: {
        type: 'category',
        data: ['Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat', 'Sun']
    },
    yAxis: {
        type: 'value'
    },
    series: [{
        data: [820, 932, 901, 934, 1290, 1330, 1320],
        type: 'line',
        smooth: true
    }]
}
"""
options = Tools.convert_js_to_dict(js_str, print_dict=False)
Echarts(options, height='300px', width='300px').render_notebook()
```



## 安装&升级

### 安装

```shell
pip install chartspy
```

### 升级 echartspy
```shell
pip uninstall chartspy -y  && pip install chartspy
```


## 修改echarts版本
默认指向最新版，可以修改成指定版本
```python
from  chartspy import  echarts
from chartspy import g2plot

echarts.ECHARTS_JS_URL = "https://unpkg.com/echarts@latest/dist/echarts.min.js"
g2plot.G2PLOT_JS_URL = "..."
```

## 其他说明参见[chartspy文档](https://chartspy.icopy.site)

## 感谢Jetbrain
![JetBrains 徽标（主要） logo](https://resources.jetbrains.com/storage/products/company/brand/logos/jb_beam.png)