Pyecharts 中Geo函數常用參數的用法說明
一、Pyeharts簡介
pyecharts 是一個用於生成 Echarts 圖表的類庫。用 Echarts 生成的圖可視化效果很不錯,pyecharts庫是用來與 Python 進行對接,方便在 Python 中直接使用數據生成圖。
最新的Pyecharts庫版本是v1,且與老版本 v0.5.X 是不兼容的,v0.5.X版本也已不再維護。新舊版本的Geo有著較大改動,本篇均是基於舊版本0.5.11
二、Pyecharts安裝
pyecharts的安裝說明很簡單,也有很多大佬寫瞭過程,本篇不贅述,主要說一下指定版本的問題。
安裝pyecharts
Pyecharts v1版本的安裝可使用pip install pyecharts -U
Pyecharts v0.5.X版本的安裝可使用pip install pyecharts==0.5.11
安裝對應的地圖拓展
pip install echarts-countries-pypkg pip install echarts-china-provinces-pypkg pip install echarts-china-cities-pypkg pip install echarts-china-counties-pypkg pip install echarts-china-misc-pypkg
全球國傢地圖:echarts-countries-pypkg (1.9MB)
中國省級地圖:echarts-china-provinces-pypkg (730KB)
中國市級地圖:echarts-china-cities-pypkg (3.8MB)
中國區縣地圖:echarts-china-counties-pypkg
中國大區地圖:echarts-china-misc-pypkg(如:華南、華北等)
三、Geo常用參數說明
1、創建Geo:geo=Geo()
geo=Geo()是畫出地圖的背景。
Geo(title,subtitle,width,height,title_pos,title_top,title_color,subtitle_color,title_text_size,subtitle_text_size,background_color,page_title,renderer,is_animation)
各參數說明如下。
實際使用過程中,我們其實經常用到的就幾個參數,如title,width,height,background_color,隻要搞這幾個基本就夠用瞭,所有參數都有默認值,這意味著在最極端情況下,直接用Geo()也可以,不過畫出來的就是一張白紙罷瞭。
Init docstring: :param title: 主標題文本,支持換行,默認為 "" :param subtitle: 副標題文本,支持換行,默認為 "" :param width: 畫佈寬度,默認為 800(px) :param height: 畫佈高度,默認為 400(px) :param title_pos: 標題距離左側距離,默認為'left',有'auto', 'left', 'right', 'center'可選,也可為百分比或整數 :param title_top: 標題距離頂部距離,默認為'top',有'top', 'middle', 'bottom'可選, 也可為百分比或整數 :param title_color: 主標題文本顏色,默認為 '#000' :param subtitle_color: 副標題文本顏色,默認為 '#aaa' :param title_text_size: 主標題文本字體大小,默認為 18 :param subtitle_text_size: 副標題文本字體大小,默認為 12 :param background_color: 畫佈背景顏色,默認為 '#fff' :param page_title: 指定生成的 html 文件中 <title> 標簽的值。默認為 'Echarts' :param renderer: 指定使用渲染方式,有 'svg' 和 'canvas' 可選,默認為 'canvas'。 3D 圖僅能使用 'canvas'。 :param extra_html_text_label: 額外的 HTML 文本標簽,(<p> 標簽)。類型為 list,list[0] 為文本內容, list[1] 為字體風格樣式(選填)。如 ["this is a p label", "color:red"] :param is_animation: 是否開啟動畫,默認為 True。V0.5.9+
舉例子:
from pyecharts import Geo geo =Geo("Geo地圖示例", "副標題",width=500, height=500, title_pos='center',title_top=20, title_color="#2E2E2E", subtitle_color='#aaa',title_text_size=16,subtitle_text_size=12,background_color='#EEEEE8', page_title='Echarts',renderer='canvas',is_animation=True) geo
2、geo.add_coordinate()新增坐標點
geo.add_coordinate()的作用就是新增,比如現在調用一張廣州地圖,現在要在顯示一個特定的點“測試1”,像這樣的點就必須用add_coordinate新增進去,否則會報錯(ValueError: No coordinate is specified for 測試1)。
geo.add_coordinate(點名稱,經度,緯度),3個參數都是必填項
geo.add_coordinate(‘測試點1’,113.40,23.07)
3、geo.add()展示坐標點
geo.add()的作用就是將點展示到上面加載的地圖上,add有一大堆的參數,最常用的是series_name、names、value、type、maptype、is_visualmap、visual_range、visual_text_color、symbol_size,其中series_name、names、value、maptype這四個是必填項
# 系列名稱,用於 tooltip 的顯示,legend 的圖例篩選。 series_name: str, # 數據項 (坐標點名稱) names:list # 數據項 (坐標點值) value: list # Geo 圖類型,有 scatter, effectScatter, heatmap, lines 4 種 type: 默認"scatter", # 是否選中圖例 is_selected: 默認True, # 標記圖形形狀,circle,pin,rect,diamon,roundRect,arrow,triangle symbol: 默認circle, # 標記的大小 symbol_size: 默認12, # 系列 label 顏色 color: 默認None, # 是否是多段線,在畫 lines 圖情況下 is_polyline: 默認 False, # 是否啟用大規模線圖的優化,在數據圖形特別多的時候(>=5k)可以開啟 is_large: 默認 False, # 特效尾跡的長度。取從 0 到 1 的值,數值越大尾跡越長。 trail_length:默認 0.2 # 地圖選擇,如廣東、廣州、china maptype #不知道什麼作用,隻知道默認Ture is_random #是否開啟鼠標縮放和平移漫遊。'scale'縮放、'move'平移、'True'都開啟 is_roam:默認True #顯示圖例條 is_visualmap:默認True #圖例條范圍 visual_range #圖例條顏色 visual_text_color #常態下地圖的顏色 geo_normal_color #觸發下地圖的顏色(鼠標放在地圖上) geo_emphasis_color #漣漪的多少,當type="effectScatter"時才有效 effect_scale #顯示標簽 is_label_show #標簽顏色 label_text_color #標簽位置(inside,top,bottom,left,right) label_pos:默認"inside" #邊界顏色 border_color
舉例子
from pyecharts import Geo districts=['荔灣區', '花都區', '番禺區','測試點1'] value = [ 200, 200,300,400] geo =Geo("Geo地圖示例", "副標題",width=500, height=500, title_pos='center',title_top=20, title_color="#2E2E2E", subtitle_color='#aaa',title_text_size=16,subtitle_text_size=12,background_color='#EEEEE8', page_title='Echarts',renderer='canvas',is_animation=True) geo.add_coordinate('測試點1',113.40,23.07) geo.add("系列名1", districts, value,type="effectScatter",is_selected=True,symbol='circle',symbol_size=20,color=None, maptype='廣州',is_roam=True,is_visualmap=True, visual_range=[0,500],visual_text_color="#2E2E2E", geo_normal_color="#323c48",geo_emphasis_color='#2a033d', effect_scale=3, is_label_show=True,label_text_color="#00FF00",label_pos="inside" ) geo.render("廣州測試2.html") geo
在這裡有2個問題還沒解決。第一、不知道is_random參數的作用,感覺不管是True或False都沒影響;第二、如上圖的series_name “系列名1”,不知道如何改變它的位置,如移動到左邊右邊等。
4、geo.render()保存文件
geo.render()很簡單瞭,就是將地圖保存為文件出來,render隻有一個參數,就是path路徑
geo.render("廣州測試2.html")
補充:Pyecharts v1 Geo庫的一些更新與應用
最近在利用Python進行爬蟲的過程中,需要對網頁中爬取的數據做一些可視化的處理,其中有部分數據是關於地區分佈的,在地圖上標註出具體的參數分佈將使得數據更加的直觀與生動。
地圖標註的工具我選擇使用的是Pyecharts庫中Geo,運行在Pycharm下,值得註意的是,最新的Pyecharts庫版本是v1, 是最新的版本,且與老版本 v0.5.X 是不兼容的,v0.5.X版本也已不再維護,所以建議以後盡量應用最新的v1版,本文也將在此對其進行一些Geo庫的更新應用的說明。
Pyecharts v1版本的安裝可使用pip install pyecharts -U,也可直接在Pycharm中安裝Pyecharts,其說明文檔地址為https://pyecharts.org/#/zh-cn/intro
Pyecharts v0.5.X版本的安裝可使用pip install pyecharts==0.5.11,其說明文檔地址為https://05x-docs.pyecharts.org/#/zh-cn/prepare
新版本Pyecharts中的地理圖表Geo有著較大的改動,總的一個最直觀的更新感受是,新的庫沒有以前那麼繁瑣瞭,應用起來更簡單直接。因為本人剛接觸Python,很多東西也是剛剛入門,現階段也隻是達到能夠初步使用Geo的程度,在探索使用新版本的過程中發現網上關於新板Pyecharts的說明很少,所以在這裡將自己遇到的一些問題以及自己的一些見解整理出來,以下的一些說明與理解可能較為粗淺,萬望各位讀者見諒。
Geo:地理坐標系
Geo作為一個地理坐標標註的工具,在功能上新老版本基本是一致的,但在細節上卻有著很大的差別,這也導致瞭新舊代碼是完全不通用的。
1. 創建Geo:geo = Geo()
在v0.5.X版本中在創建geo的過程中是可以對其進行一些基本參數設定的
如以說明文檔中的例子:
geo = Geo("全國主要城市空氣質量", "data from pm2.5", title_color="#fff", title_pos="center", width=1200, height=600, background_color="#404a59", )
可以設定主標題,副標題,標題顏色為止,圖表大小,背景顏色等。
但在新版本中繼續按照這樣的格式進行創建時,編譯器報錯AttributeError: ‘str’ object has no attribute ‘get’,沒有這樣的對象。在新版文檔中對Geo是直接進行創建的geo = Geo(),其實這樣創建基本也就可以瞭,但是如果你真的想對其進行更多的參數設置,當然也是可以的。
在新的庫中,對Geo的操作統一放在init_opts中,對其進行更改需要統一的對類opts.InitOpts進行修改,這裡我們就需要引入from pyecharts import options as opts才能進行調用。
具體的InitOpts包括以下一些參數
class InitOpts(BasicOpts): def __init__( self, width: str = "900px", height: str = "500px", chart_id: Optional[str] = None, renderer: str = RenderType.CANVAS, page_title: str = CurrentConfig.PAGE_TITLE, theme: str = ThemeType.WHITE, bg_color: Union[str, dict] = None, js_host: str = "", animation_opts: Union[AnimationOpts, dict] = AnimationOpts(), ): self.opts: dict = { "width": width, "height": height, "chart_id": chart_id, "renderer": renderer, "page_title": page_title, "theme": theme, "bg_color": bg_color, "js_host": js_host, "animationOpts": animation_opts, }
需要註意的是對opt.InitOpts直接進行配置的話,隻能對部分參數進行更改,如bg_color等,而width,height等參數是固定的無法修改的,比如如果這樣設定
geo = Geo(init_opts = opts.InitOpts("aaa", width = 400, height = 200, bg_color = "#404a59"))
將報TypeError: init() got multiple values for argument ‘width’多賦值的錯誤。好在新版本除瞭提供Opts 配置項作為參數傳入,還提供瞭原生 dict 作為參數配置,所有參數均可以自己任意定義,具體操作代碼是
geo = Geo(init_opts = {"width":1600,"chart_id":"ceshi","bg_color":"#404a59"})
這裡發現瞭一個奇怪的現象,當更改height參數時,將直接導致地圖標註無圖像,至今未明白其中的原因。
2.add_schema設置
add_schema是Geo下的一個函數,具體功能是對地圖的參數與功能進行一些配置,主要包括有
def add_schema( # 地圖類型,具體參考 pyecharts.datasets.map_filenames.json 文件 maptype: str = "china", # 是否開啟鼠標縮放和平移漫遊。 is_roam: bool = True, # 當前視角的縮放比例。默認為 1 zoom: Optional[Numeric] = None, # 當前視角的中心點,用經緯度表示。例如:center: [115.97, 29.71] center: Optional[Sequence] = None, # # 標簽配置項,參考 `series_options.LabelOpts` label_opts: Union[opts.LabelOpts, dict, None] = None, # 地圖區域的多邊形 圖形樣式。 itemstyle_opts: Union[opts.ItemStyleOpts, dict, None] =None, # 高亮狀態下的多邊形樣式 emphasis_itemstyle_opts: Union[opts.ItemStyleOpts, dict,None] = None, # 高亮狀態下的標簽樣式。 emphasis_label_opts: Union[opts.LabelOpts, dict, None] =None, ):
這裡我隻使用過maptype,zoom,label_opts的設置,具體設置如下
geo.add_schema(maptype = "china", zoom = 1, label_opts = opts.LabelOpts(is_show=True))
maptype可替換成世界地圖,省份地圖等,地圖資源可通過以下
pip install echarts-countries-pypkg pip install echarts-china-provinces-pypkg pip install echarts-china-cities-pypkg pip install echarts-china-counties-pypkg pip install echarts-china-misc-pypkg
zoom是縮放設置,label_opts是標簽設置,如同1中的設置,這裡也是可以通過原生dict進行自定義設置的。
3.add_coordinate設置:新增坐標點
Geo中可以自己增加需要標註的坐標點,通過設置地點,經度,緯度這三個參數即可完成添加。
def add_coordinate( # 坐標地點名稱 name: str, # 經度 longitude: Numeric, # 緯度 latitude: Numeric, )
這個函數和舊版是一致的,應用也非常簡單,此處不再多加贅述,舉一個簡單的例子
geo.add_coordinate("標註地點", 120, 80)
4.add設置:顯示與圖例篩選
這是Geo中最主要的函數模塊,可供設置的參數類型也比較多,新版的add函數結構與以前相比也有較大的改動,相關的參數如下所示
def add( # 系列名稱,用於 tooltip 的顯示,legend 的圖例篩選。 series_name: str, # 數據項 (坐標點名稱,坐標點值) data_pair: Sequence, # Geo 圖類型,有 scatter, effectScatter, heatmap, lines 4 種,建議使用 # from pyecharts.globals import GeoType # GeoType.GeoType.EFFECT_SCATTER,GeoType.HEATMAP,GeoType.LINES type_: str = "scatter", # 是否選中圖例 is_selected: bool = True, # 標記圖形形狀 symbol: Optional[str] = None, # 標記的大小 symbol_size: Numeric = 12, # 系列 label 顏色 color: Optional[str] = None, # 是否是多段線,在畫 lines 圖情況下 is_polyline: bool = False, # 是否啟用大規模線圖的優化,在數據圖形特別多的時候(>=5k)可以開啟 is_large: bool = False, # 特效尾跡的長度。取從 0 到 1 的值,數值越大尾跡越長。默認值 0.2 trail_length: Numeric = 0.2, # 開啟繪制優化的閾值。 large_threshold: Numeric = 2000, # 標簽配置項,參考 `series_options.LabelOpts` label_opts: Union[opts.LabelOpts, dict] = opts.LabelOpts(), # 漣漪特效配置項,參考 `series_options.EffectOpts` effect_opts: Union[opts.EffectOpts, dict] = opts.EffectOpts(), # 線樣式配置項,參考 `series_options.LineStyleOpts` linestyle_opts: Union[opts.LineStyleOpts, dict] = opts.LineStyleOpts(), # 提示框組件配置項,參考 `series_options.TooltipOpts` tooltip_opts: Union[opts.TooltipOpts, dict, None] = None, # 圖元樣式配置項,參考 `series_options.ItemStyleOpts` itemstyle_opts: Union[opts.ItemStyleOpts, dict, None] = None, )
其中,新舊版本最大的一個不同是,舊版的地點和值分開配置給attr和value,舊版的典型示例如下
from pyecharts import Geo data = [ ("海門", 9), ("鄂爾多斯", 12), ("招遠", 12), ("舟山", 12), ("齊齊哈爾", 14), ("鹽城", 15) ] geo = Geo( "全國主要城市空氣質量", "data from pm2.5", title_color="#fff", title_pos="center", width=1200, height=600, background_color="#404a59", ) attr, value = geo.cast(data) geo.add("", attr, value, type="effectScatter", is_random=True, effect_scale=5) geo.render()
而新版的add函數將地點和值放在瞭一個數據項裡,
geo.add("", [attr, value], type_=ChartType.HEATMAP, symbol_size = 12, label_opts = opts.LabelOpts(is_show=False))
其他一些參數配置大致與以前是一致的,配置方式也可同樣參照1中的方式進行。
在運行中發現一個有趣的問題,如一個個對坐標進行顯示插入
geo.add_coordinate("測試點1", 20, 40) geo.add("haha1", [("測試點1", 60)]) geo.add_coordinate("測試點2", 60, 80) geo.add("haha2", [("測試點2", 60)])
這樣運行是沒有問題的,但如果對列表中的項進行批量的插入,如
for i in range(num): geo.add_coordinate(address[i], lng[i], lat[i]) geo.add("", [(address[i],60)])
這樣做是會報錯的,具體原因不是太明白,無奈隻能進行如下修改
for i in range(num): geo.add_coordinate(address[i], lng[i], lat[i]) geo.add("", [(address[i],60) for i in range(num)])
做瞭這樣的修改後就沒有問題瞭,如果有知道原因的朋友可以留言給我,萬分感謝
還有一個值得註意的問題是,對中國地圖進行標註時,使用的地點不能包含“省”,“市”等,隻能使用“江蘇”,“浙江”等地名,不然就是無效的。
最後想放一張自己運行生成的標註地圖,無奈第一次標記這邊的文章,不會添加圖片!!!
以上為個人經驗,希望能給大傢一個參考,也希望大傢多多支持WalkonNet。如有錯誤或未考慮完全的地方,望不吝賜教。
推薦閱讀:
- Python可視化神器pyecharts繪制地理圖表
- Python Pyecharts繪制象形柱圖
- 一文帶你掌握Pyecharts地理數據可視化的方法
- Python pyecharts實現繪制中國地圖的實例詳解
- 利用pyecharts繪制地理散點圖