<commit_before># pyecharts 文档

pyecharts 是一个用于生成 Echarts 图表的类库。实际上就是 Echarts 与 Python 的对接。  

[![Build Status](https://travis-ci.org/chenjiandongx/pyecharts.svg?branch=master)](https://travis-ci.org/chenjiandongx/pyecharts)  


* [开始使用](https://github.com/chenjiandongx/pyecharts/blob/master/document/zh-cn/documentation.md#开始使用)
* [通用配置项](https://github.com/chenjiandongx/pyecharts/blob/master/document/zh-cn/documentation.md#通用配置项)
    * xyAxis：直角坐标系中的 x、y 轴(Line、Bar、Scatter、EffectScatter、Kline)
    * dataZoom：dataZoom 组件 用于区域缩放，从而能自由关注细节的数据信息，或者概览数据整体，或者去除离群点的影响。(Line、Bar、Scatter、EffectScatter、Kline)
    * legend：图例组件。图例组件展现了不同系列的标记(symbol)，颜色和名字。可以通过点击图例控制哪些系列不显示。
    * label：图形上的文本标签，可用于说明图形的一些数据信息，比如值，名称等。
    * lineStyle：带线图形的线的风格选项(Line、Polar、Radar、Graph、Parallel)
    * grid3D：3D笛卡尔坐标系组配置项，适用于 3D 图形。（Bar3D, Line3D, Scatter3D)
    * axis3D：3D 笛卡尔坐标系 X，Y，Z 轴配置项，适用于 3D 图形。（Bar3D, Line3D, Scatter3D)
    * visualMap：是视觉映射组件，用于进行『视觉编码』，也就是将数据映射到视觉元素（视觉通道）

* [图表详细](https://github.com/chenjiandongx/pyecharts/blob/master/document/zh-cn/documentation.md#图表详细)
    * Bar（柱状图/条形图）
    * Bar3D（3D 柱状图）
    * EffectScatter（带有涟漪特效动画的散点图）
    * Funnel（漏斗图）
    * Gauge（仪表盘）
    * Geo（地理坐标系）
    * Graph（关系图）
    * HeatMap（热力图）
    * Kline（K线图）
    * Line（折线/面积图）
    * Line3D（3D 折线图）
    * Liquid（水球图）
    * Map（地图）
    * Parallel（平行坐标系）
    * Pie（饼图）
    * Polar（极坐标系）
    * Radar（雷达图）
    * Scatter（散点图）
    * Scatter3D（3D 散点图）
    * WordCloud（词云图）
* [用户自定义](https://github.com/chenjiandongx/pyecharts/blob/master/document/zh-cn/documentation.md#用户自定义)
    * Grid 类：并行显示多张图
    * Overlap 类：结合不同类型图表叠加画在同张图上
    * Page 类：同一网页按顺序展示多图
    * Timeline 类：提供时间线轮播多张图
* [集成Flask&Django](https://github.com/chenjiandongx/pyecharts/blob/master/document/zh-cn/documentation.md#集成Flask&Django)
* [更多示例](https://github.com/chenjiandongx/pyecharts/blob/master/document/zh-cn/documentation.md#更多示例)
* [关于项目](https://github.com/chenjiandongx/pyecharts/blob/master/document/zh-cn/documentation.md#关于项目)


# 开始使用
### 确认你已安装了最新版本的 pyecharts
> `print(pyecharts.__version__)` 可查看当前 pyecharts 版本

首先开始来绘制你的第一个图表
```python
from pyecharts import Bar

bar = Bar("我的第一个图表", "这里是副标题")
bar.add("服装", ["衬衫", "羊毛衫", "雪纺衫", "裤子", "高跟鞋", "袜子"], [5, 20, 36, 10, 75, 90])
bar.show_config()
bar.render()
```
![guide-0](https://github.com/chenjiandongx/pyecharts/blob/master/images/guide-0.png)

**Tip：** 可以按右边的下载按钮将图片下载到本地  

* ```add()```  
    主要方法，用于添加图表的数据和设置各种配置项  
* ```show_config()```  
    打印输出图表的所有配置项
* ```render()```  
    默认将会在根目录下生成一个 render.html 的文件，支持 path 参数，设置文件保存位置，如 render(r"e:\my_first_chart.html")，文件用浏览器打开。  


### Jupyter notebook 小贴士

对本库的现有用户来说，新版本(0.1.9.5)的离线模式要求：1）老版本已完全卸载 2）你现有的notebook文档需要刷新并重新运行。

离线模式工作原理：pyecharts自动把echarts脚本文件装在了jupyter nbextensions文件夹下面。以下代码可以告诉你pyecharts网页脚本是否装到了Jupyter里面：
<commit_msg>:handshake: upstreaming<commit_after># pyecharts 文档

pyecharts 是一个用于生成 Echarts 图表的类库。实际上就是 Echarts 与 Python 的对接。  

[![Build Status](https://travis-ci.org/chenjiandongx/pyecharts.svg?branch=master)](https://travis-ci.org/chenjiandongx/pyecharts)  


* [开始使用](https://github.com/chenjiandongx/pyecharts/blob/master/document/zh-cn/documentation.md#开始使用)
* [通用配置项](https://github.com/chenjiandongx/pyecharts/blob/master/document/zh-cn/documentation.md#通用配置项)
    * xyAxis：直角坐标系中的 x、y 轴(Line、Bar、Scatter、EffectScatter、Kline)
    * dataZoom：dataZoom 组件 用于区域缩放，从而能自由关注细节的数据信息，或者概览数据整体，或者去除离群点的影响。(Line、Bar、Scatter、EffectScatter、Kline)
    * legend：图例组件。图例组件展现了不同系列的标记(symbol)，颜色和名字。可以通过点击图例控制哪些系列不显示。
    * label：图形上的文本标签，可用于说明图形的一些数据信息，比如值，名称等。
    * lineStyle：带线图形的线的风格选项(Line、Polar、Radar、Graph、Parallel)
    * grid3D：3D笛卡尔坐标系组配置项，适用于 3D 图形。（Bar3D, Line3D, Scatter3D)
    * axis3D：3D 笛卡尔坐标系 X，Y，Z 轴配置项，适用于 3D 图形。（Bar3D, Line3D, Scatter3D)
    * visualMap：是视觉映射组件，用于进行『视觉编码』，也就是将数据映射到视觉元素（视觉通道）

* [图表详细](https://github.com/chenjiandongx/pyecharts/blob/master/document/zh-cn/documentation.md#图表详细)
    * Bar（柱状图/条形图）
    * Bar3D（3D 柱状图）
    * EffectScatter（带有涟漪特效动画的散点图）
    * Funnel（漏斗图）
    * Gauge（仪表盘）
    * Geo（地理坐标系）
    * Graph（关系图）
    * HeatMap（热力图）
    * Kline（K线图）
    * Line（折线/面积图）
    * Line3D（3D 折线图）
    * Liquid（水球图）
    * Map（地图）
    * Parallel（平行坐标系）
    * Pie（饼图）
    * Polar（极坐标系）
    * Radar（雷达图）
    * Scatter（散点图）
    * Scatter3D（3D 散点图）
    * WordCloud（词云图）
* [用户自定义](https://github.com/chenjiandongx/pyecharts/blob/master/document/zh-cn/documentation.md#用户自定义)
    * Grid 类：并行显示多张图
    * Overlap 类：结合不同类型图表叠加画在同张图上
    * Page 类：同一网页按顺序展示多图
    * Timeline 类：提供时间线轮播多张图
* [集成Flask&Django](https://github.com/chenjiandongx/pyecharts/blob/master/document/zh-cn/documentation.md#集成Flask&Django)
* [更多示例](https://github.com/chenjiandongx/pyecharts/blob/master/document/zh-cn/documentation.md#更多示例)
* [关于项目](https://github.com/chenjiandongx/pyecharts/blob/master/document/zh-cn/documentation.md#关于项目)


# 开始使用
### 确认你已安装了最新版本的 pyecharts
> `print(pyecharts.__version__)` 可查看当前 pyecharts 版本

首先开始来绘制你的第一个图表
```python
from pyecharts import Bar

bar = Bar("我的第一个图表", "这里是副标题")
bar.add("服装", ["衬衫", "羊毛衫", "雪纺衫", "裤子", "高跟鞋", "袜子"], [5, 20, 36, 10, 75, 90])
bar.show_config()
bar.render()
```
![guide-0](https://github.com/chenjiandongx/pyecharts/blob/master/images/guide-0.png)

**Tip：** 可以按右边的下载按钮将图片下载到本地  

* ```add()```  
    主要方法，用于添加图表的数据和设置各种配置项  
* ```show_config()```  
    打印输出图表的所有配置项
* ```render()```  
    默认将会在根目录下生成一个 render.html 的文件，支持 path 参数，设置文件保存位置，如 render(r"e:\my_first_chart.html")，文件用浏览器打开。  


### Jupyter notebook 小贴士
对本库的现有用户来说，0.1.9.5 版本的离线模式要求：
1）老版本已完全卸载 
2）您现有的 notebook 文档需要刷新并重新运行。

离线模式工作原理：pyecharts自动把echarts脚本文件装在了jupyter nbextensions文件夹下面。以下代码可以告诉你pyecharts网页脚本是否装到了Jupyter里面：

{'fraction_non_alphanumeric': 0.159248093633623, 'fraction_numerical': 0.013122894130164924, 'mean_word_length': 5.0127931769722816, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 5, 'https://': 20, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 2, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 2, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '7367682', 'n_tokens_mistral': 3275, 'n_tokens_neox': 3495, 'n_words': 257}