如何在 Django 项目中使用 pyecharts

本指南是 pyecharts 库的开发者仿照 Django 官方教程撰写的，通过完成一个 Django 小项目来说明如何在 Django 中使用 pyecharts。

如果对 Django 还不太熟悉的开发者，可仔细阅读官方提供的最新文档。

作者：chenjiandongx 来源：https://github.com/chenjiandongx/pyecharts/blob/master/docs/zh-cn/doc_django.md

Step 0: 使用新的 virtualenv 环境

建议开发者使用 1.11.4 版本的 Django

$ virtualenv --no-site-packages pyecharts-env
$ source pyecharts-env/bin/activate
$ pip install django==1.11.4
$ pip install pyecharts

Step 1: 新建一个 django 项目

$ django-admin startproject myechartsite

创建一个应用程序

$ python manage.py startapp myfirstvis
$ ls
db.sqlite3      manage.py       myechartsite    myfirstvis

在 myechartsite/settings.py 中注册应用程序

    
# myechartsite/settings.py
...
INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'myfirstvis'  # 
]
...

我们先编辑 urls.py.这文件在 Django 里的功能是把前段的 HTTP 需求和后台服务函数挂钩。在 Step3，我们再引入后端服务函数

# myfirstvis/urls.py
from django.conf.urls import url
from . import views



    
urlpatterns = [
    url(r'^$', views.index, name='index'),
]

在 myechartsite/urls.py 中新增 'myfirstvis.urls'

myechartsite/urls.py
from django.conf.urls import include, url
from django.contrib import admin
urlpatterns = [
    url(r'^admin/', admin.site.urls),
    url(r'myfirstvis/', include('myfirstvis.urls'))  # 



    
]

Step 2: 处理视图功能部分

将下列代码保存到 myfirstvis/views.py 中。

from __future__ import unicode_literals
import math
from django.http import HttpResponse
from django.template import loader
from pyecharts import Line3D
from pyecharts.constants import DEFAULT_HOST
def index(request):
    template = loader.get_template('myfirstvis/pyecharts.html')
    l3d = line3d()



    
    context = dict(
        myechart=l3d.render_embed(),
        host=DEFAULT_HOST,
        script_list=l3d.get_js_dependencies()
    )
    return HttpResponse(template.render(context, request))
def line3d():
    _data = []
    for t in range(0, 25000):
        _t = t / 1000
        x = (1 + 0.25 * math.


    
cos(75 * _t)) * math.cos(_t)
        y = (1 + 0.25 * math.cos(75 * _t)) * math.sin(_t)
        z = _t + 2.0 * math.sin(75 * _t)
        _data.append([x, y, z])
    range_color = [
        '#313695', '#4575b4', '#74add1', '#abd9e9', '#e0f3f8', '#ffffbf',
        '#fee090',


    
 '#fdae61', '#f46d43', '#d73027', '#a50026']
    line3d = Line3D("3D line plot demo", width=1200, height=600)
    line3d.add("", _data, is_visualmap=True,
               visual_range_color=range_color, visual_range=[0, 30],
               is_grid3D_rotate=True, grid3D_rotate_speed=180)
    return line3d

script_list 是 Page() 类渲染网页所需要依赖的 echarts js 库，依赖的库的数量取决于所要渲染的图形种类。

host 是 echarts js 库的地址，默认的地址为 http://chfw.github.io/jupyter-echarts/echarts 当然，如果你愿意你也可以改变这个地址，先克隆 https://github.com/chfw/jupyter-echarts 然后将 echarts 文件夹挂载在你自己的服务器上即可。

Step 3: 为项目提供自己的模板

前面的步骤是按照 tutorial part 1，接下来我们跳到 tutorial part 3

Linux/macos 系统

$ mkdir templates/


    
myfirstvis -p

Windows 系统 
在 myfirstvis 目录下，新建 templates/myfirstvis 子目录

myfirstvis 目录

─ myfirstvis
    ├── admin.py
    ├── apps.py
    ├── __init__.py
    ├── migrations
    │   ├── __init__.py
    ├── models.py
    ├── templates
    │   └── myfirstvis
    │       └── pyecharts.html
    ├── tests.py
    ├── urls.py
    └── views.py



    

将下面 html 模板代码保存为 pyecharts.html，请确保 pyecharts.html 文件的绝对路径为  root>/myfirstvis/templates/myfirstvis

     charset="utf-8">