pyecharts

BACA Bahasa Inggris

Perkenalan

Apache ECharts adalah visualisasi data bersumber terbuka oleh Baidu. Ia telah diakui oleh banyak pengembang karena interaktivitasnya yang baik dan desain bagannya yang indah. Python merupakan bahasa ekspresif dan sangat cocok untuk pengolahan data. Ketika analisis data bertemu dengan visualisasi data, lahirlah diagram lingkaran.

ciri

• Desain API sederhana, penggunaan sehalus sutra, mendukung panggilan berantai
• Berisi 30+ grafik umum, semua yang Anda butuhkan
• Mendukung lingkungan Notebook mainstream, Jupyter Notebook, JupyterLab, dan marimo
• Dapat dengan mudah diintegrasikan ke dalam kerangka web arus utama seperti Flask, Sanic, dan Django
• Item konfigurasi yang sangat fleksibel dapat dengan mudah mencocokkan grafik yang indah
• Dokumentasi dan contoh terperinci membantu pengembang memulai proyek dengan lebih cepat
• Hingga 400+ file peta, dan mendukung peta asli Baidu, memberikan dukungan kuat untuk visualisasi data geografis

⏳ versi

Ada ketidakcocokan antara v0.5.x dan V1. V1 adalah versi baru. Lihat ISSUE#892 dan ISSUE#1033 untuk detailnya.

V0.5.x

Mendukung Python 2.7, 3.4+

Setelah tim pengembangan memutuskan, versi 0.5.x tidak akan dipertahankan lagi. Kode versi 0.5.x terletak di cabang 05x , dan dokumentasinya terletak di 05x-docs.pyecharts.org.

V1

Hanya mendukung Python 3.7+

Seri versi baru akan dimulai dengan v1.0.0, dokumentasinya ada di pyecharts.org; contohnya ada di gallery.pyecharts.org

V2

Hanya mendukung Python 3.7+

Versi baru ini didasarkan pada Echarts 5.4.1+ untuk rendering, dan dokumentasi serta lokasi sampelnya sama dengan V1.

? Instal

pemasangan pip

 # 安装 v1 以上版本
$ pip install pyecharts -U

# 如果需要安装 0.5.11 版本的开发者，可以使用
# pip install pyecharts==0.5.11

Instalasi kode sumber

 # 安装 v1 以上版本
$ git clone https://github.com/pyecharts/pyecharts.git
# 如果需要安装 0.5.11 版本，请使用 git clone https://github.com/pyecharts/pyecharts.git -b v05x
$ cd pyecharts
$ pip install -r requirements.txt
$ python setup.py install

menggunakan

lingkungan lokal

Hasilkan HTML

 from pyecharts . charts import Bar
from pyecharts import options as opts

# V1 版本开始支持链式调用
bar = (
    Bar ()
    . add_xaxis ([ "衬衫" , "毛衣" , "领带" , "裤子" , "风衣" , "高跟鞋" , "袜子" ])
    . add_yaxis ( "商家A" , [ 114 , 55 , 27 , 101 , 125 , 27 , 105 ])
    . add_yaxis ( "商家B" , [ 57 , 134 , 137 , 129 , 145 , 60 , 49 ])
    . set_global_opts ( title_opts = opts . TitleOpts ( title = "某商场销售情况" ))
)
bar . render ()

# 不习惯链式调用的开发者依旧可以单独调用方法
bar = Bar ()
bar . add_xaxis ([ "衬衫" , "毛衣" , "领带" , "裤子" , "风衣" , "高跟鞋" , "袜子" ])
bar . add_yaxis ( "商家A" , [ 114 , 55 , 27 , 101 , 125 , 27 , 105 ])
bar . add_yaxis ( "商家B" , [ 57 , 134 , 137 , 129 , 145 , 60 , 49 ])
bar . set_global_opts ( title_opts = opts . TitleOpts ( title = "某商场销售情况" ))
bar . render ()

Hasilkan gambar

 from snapshot_selenium import snapshot as driver

from pyecharts import options as opts
from pyecharts . charts import Bar
from pyecharts . render import make_snapshot


def bar_chart () -> Bar :
    c = (
        Bar ()
        . add_xaxis ([ "衬衫" , "毛衣" , "领带" , "裤子" , "风衣" , "高跟鞋" , "袜子" ])
        . add_yaxis ( "商家A" , [ 114 , 55 , 27 , 101 , 125 , 27 , 105 ])
        . add_yaxis ( "商家B" , [ 57 , 134 , 137 , 129 , 145 , 60 , 49 ])
        . reversal_axis ()
        . set_series_opts ( label_opts = opts . LabelOpts ( position = "right" ))
        . set_global_opts ( title_opts = opts . TitleOpts ( title = "Bar-测试渲染图片" ))
    )
    return c

# 需要安装 snapshot-selenium 或者 snapshot-phantomjs
make_snapshot ( driver , bar_chart (). render (), "bar.png" )

Lingkungan buku catatan

Buku Catatan Jupyter

Lab Jupyter

kerangka web

?

Kode Demo terletak di folder contoh. Selamat datang di galeri pyecharts galeri pyecharts.

Untuk dokumentasi lebih rinci, silakan kunjungi

• Dokumentasi Tiongkok
• Dokumentasi Bahasa Inggris
• ContohContoh

⛏ Kualitas kode

Pengujian satuan

$ pip install -r test/requirements.txt
$ make

Pengujian integrasi

Lingkungan integrasi berkelanjutan menggunakan Travis CI dan AppVeyor.

Spesifikasi kode

Gunakan flake8, Codecov, dan pylint untuk meningkatkan kualitas kode.

Pengarang

pyecharts terutama dikembangkan dan dikelola oleh pengembang berikut

• @chenjiandongx
• @chfw
• @kinegratii
• @sunhailin-Leo

Informasi kontributor selengkapnya dapat ditemukan di pycharts/graphs/contributors

menyumbang

Kami menantikan lebih banyak pengembang yang berpartisipasi dalam pengembangan diagram pyechart. Kami akan memastikan untuk Meninjau Ulang PR sesegera mungkin dan merespons secara tepat waktu. Namun saat mengirimkan PR harap pastikan

1. Lulus semua pengujian unit. Jika ini adalah fitur baru, harap tambahkan pengujian unit untuk itu.
2. Patuhi spesifikasi pengembangan dan gunakan warna hitam dan isort untuk memformat kode ($ pip install -r persyaratan-dev.txt)
3. Jika perlu, perbarui dokumentasi terkait

Kami juga sangat menyambut pengembang untuk memberikan lebih banyak contoh pyecharts dan bekerja sama untuk meningkatkan dokumentasi. Proyek dokumentasi terletak di pyecharts/situs web

?Lisensi

MIT ©chenjiandongx