python altair

Bokeh这个库，在Python的数据可视化生态里，其实处在一个比较微妙的位置。它不像Matplotlib那么老牌，也不像Plotly那么自带网红属性，但认真用过几次之后就会发现，它解决了一个特别实际的问题——在浏览器里画出可交互的、不卡顿的、甚至能直接放到生产环境里的图表。

1. 它是什么

说白了，Bokeh就是一个用Python生成HTML+JavaScript的图表库。你写Python代码，它帮你把数据转换成可以在网页上展示的矢量图形，并且自带缩放、平移、悬停提示这些交互功能。这个和Matplotlib那种静态图片的思路完全不一样——Matplotlib是“画好贴出去”，Bokeh是“画好让别人点”。

它的底层依赖的是一个叫BokehJS的JavaScript库，所以输出天然就是网页形式。这意味着你可以直接把它嵌入到Flask、Django这些Web框架里，或者生成独立的HTML文件，甚至和Jupyter Notebook无缝配合。这一点在实际工作中特别实用：当你需要把可视化结果交给不懂Python的产品经理或者客户时，一个HTML文件甩过去，他们自己就能玩。

2. 它能做什么

从功能上讲，Bokeh覆盖了可视化的大部分场景，但最擅长的是这么几类：

流式数据实时更新。比如监控CPU使用率、股票价格的实时走势。Bokeh有现成的ColumnDataSource机制，数据源一更新，图表自动刷新，不需要手动重建图形。我曾经用这个做过一个边缘设备的性能监控面板，后端每秒钟推送一次数据，前端图表平滑滚动，体验很接近专门的监控软件。

大规模数据的交互探索。Bokeh支持一种叫"服务器模式"的东西，你可以在Python里写一个回调函数，用户在前端点一个按钮或者拖动滑块时，这个回调在Python进程里执行，结果再推回到浏览器。这意味着你可以处理几百万个点——只渲染当前可见区域的数据，而不是一股脑把所有点都画上。

地理信息可视化。它有TileProvider接口，可以直接对接OpenStreetMap、CartoDB这些底图，然后在上面叠加散点图、热力图、连线图。做物流路径分析、人群分布这类任务时特别方便。

仪表盘和报告。利用Bokeh的布局组件——row、column、Tab这些，你可以像搭积木一样拼出一个多面板的仪表盘，甚至可以嵌入自定义的HTML组件。很多公司的内部数据看板，其实就是用Bokeh生成的静态HTML页面定期推送的，不需要部署任何Web服务。

3. 怎么使用

Bokeh的使用方式有两种，我平时用得比较多的是高层接口bokeh.plotting。这套接口隐藏了大部分细节，像用Matplotlib一样调用figure()得到一个绘图区域，然后p.line(x, y)、p.scatter(x, y)把图形添加上去，最后通过show()或者save()输出。

举一个简单的例子——画一条价格曲线，并且加一个悬停提示：

frombokeh.plottingimportfigure,showfrombokeh.modelsimportHoverTool p=figure(width=800,height=400,title="价格走势")p.line(x,y,line_width=2,color="navy")hover=HoverTool(tooltips=[("时间","@x{%F}"),("价格","@y{0.00}")],formatters={"@x":"datetime"})p.add_tools(hover)show(p)

这段代码看起来和Matplotlib几乎一样简单，但生成的图表在浏览器里是可以缩放、平移、悬停显示数值的。如果需要在Jupyter Notebook里显示，把show(p)换成output_notebook()就可以了。

稍微深入一点，Bokeh有一个核心概念叫ColumnDataSource。大部分人不理解为什么Bokeh要弄出这么个东西，直接传数组不好吗？但当你需要做动态更新或者多图表联动时，这个设计就体现出价值了：

frombokeh.modelsimportColumnDataSource source=ColumnDataSource(data={"time":[],"value":[]})p.line(x="time",y="value",source=source)# 更新数据source.stream({"time":[new_time],"value":[new_value]},rollover=1000)

source.stream()的意思就是往数据源末尾追加一条新数据，并且只保留最近1000条。图表会基于这个数据源自动刷新，不需要重新生成整个图形。

Bokeh还允许你在Python里写回调函数，绑定到用户的交互事件上。比如一个滑块拖拽后重新计算数据并更新图表，这种在Bokeh的服务器模式下完全可以用纯Python实现，而不需要写一行JavaScript代码。

4. 最佳实践

用Bokeh这几年，有几个看起来小但实际影响很大的经验：

第一，数据量大的时候，一定要用CDSView或者服务器端的回调。默认情况下，Bokeh把所有数据都传给浏览器，几万个点还能应付，几十万点就开始卡了。可以结合cdsview加上GroupFilter或者CustomJSFilter来控制哪些点被渲染。如果是百万级别，只能在服务器模式下做分页或者聚合。

第二，布局用curdoc()配合add_root()。如果你只是生成单张图表，用show()没问题。但一旦要做仪表盘，一定要学会用curdoc().add_root(layout)这种写法。这样你可以把文本、图像、表格、图表组合成一个完整的布局文档，输出时整体的样式和交互逻辑都在一个文件里。

第三，CSS样式可以直接注入。Bokeh生成的HTML用的是Bokeh自己的类名，但你可以通过figure(background_fill_color="#f9f9f9")或者layout.css_classes=["my-panel"]来局部微调外观。不要被“Bokeh的图表丑”这个刻板印象限制住，花点时间配一下颜色和字体，效果完全不输商业软件。

第四，output_file()要用绝对路径或相对路径的明确写法。很多新手因为默认路径写到了当前工作目录，结果在多线程或者Web应用里出现文件找不到的问题。直接用output_file("./dashboard.html")，心里踏实。

第五，版本锁定非常关键。Bokeh在2.x到3.x的升级过程中，破坏性变更很多，比如bokeh.plotting里的p.rect()的参数改了，一些旧的回调接口（CustomJS的某些属性）也调整了。如果你有一个长期维护的项目，建议锁定bokeh==2.4.3或者bokeh==3.1.0这种具体版本，不要随便升级。

5. 和同类技术对比

最常被拿来比较的是Plotly。这个比较挺有意思的，因为两者思路刚好相反。

Plotly追求的是“零门槛出漂亮的图”——默认配色、默认交互、默认3D都能直接看。Bokeh则更倾向于“给你工具箱，你自己搭”——它的默认配色是灰调的，看起来很朴素，但可定制度极高。Plotly的布局是用字典式的JSON配置，Bokeh用的是面向对象的组件树。如果你需要精细控制图表的每一个像素，Bokeh会舒服得多。但如果你只是想快速出一张看起来专业的交互图，Plotly的学习曲线更低。

Matplotlib是另一种对比对象。Matplotlib的输出是静态图片，Bokeh是交互式网页，这是本质区别。但很多人会问：我能不能用Matplotlib画交互图？可以，通过%matplotlib notebook或者mpld3、plotly的后端，但那个体验和Bokeh原生支持完全不是一个级别。Bokeh的交互不依赖Jupyter内核，是一个完全的独立网页组件。所以如果你需要把图表放到Web应用里或者发给别人，Bokeh显然更合适。

还有一个比较冷门但值得一提的对比对象：Altair。Altair基于Vega-Lite，语法极其优雅，一个alt.Chart(data).mark_line().encode(x='time:T', y='value:Q')就能画图。但Altair的数据量限制非常严格——超过5000行数据就需要后处理。Bokeh则没有这个硬门槛，你可以用服务器模式处理百万级别的数据。所以在做真正的大数据可视化时，Bokeh更有优势。

如果要用一句话总结：**Bokeh是那种看起来不惊艳，但真正需要把交互图表放到生产# # 聊聊Altair：从数据到图表的一种更自然的思考方式

处理数据可视化的时候，我经常想一个问题：为什么Python里这么多画图库，用起来总有一种“我在指挥数据结构”而不是“我在表达数据故事”的感觉？直到我碰到Altair，才意识到这可能是我和数据之间一直缺少的那层“语法”。

Altair到底是什么？

Altair不是LibreOffice Calc那种拖拽式的画图工具，也不是Excel里那种点几下就能出柱状图的傻瓜式操作。它是一种基于“图形语法”思想的Python可视化库。这个“图形语法”听起来很学术，其实理解起来很简单——想象你在用文字描述一张图表，比如“横轴是月份，纵轴是销售额，用蓝色的线表示实际销售额，红色的虚线表示目标销售额”。Altair的基本原则就是这个：你用声明式的方式告诉它数据长什么样、你希望怎么展示，剩下的坐标轴、图例、颜色映射全部交给它自动处理。

这和其他库最大的分别在于，Altair的用户只需要关心“有什么数据”和“想展现什么关系”，不需要操心“怎么画刻度线”或者“图例放哪里”。就像你写英文句子，只需要把主谓宾摆对，语法本身就是完备的——Altair的声明式语法就是这套语法。

它能做什么？

最直接的回答：能做出从简单到复杂的各种静态交互图表。但更值得说的是，Altair擅长处理“数据和视觉编码之间的对应关系”。简单例子：你有一张销售表，想看看不同季度、不同产品线的销售额对比。在Altair里，这几乎就是把“季度”映射到X轴、“产品线”映射到颜色、“销售额”映射到Y轴这么简单。

但它真正有意思的地方在交互层面。比如你想在图表上添加一个“悬停显示详细信息”的功能，Altair内置的tooltip参数就能做到。甚至可以做联动筛选——点击某个区域，其他图表只显示该区域的数据。这在其他库可能要用D3.js或者写一堆回调，Altair把这类交互包装成了可组合的“响应式变量”。

另外，Altair对时间序列的处理也很自然。如果你的数据列是datetime格式，它可以自动推断出时间跨度，x轴的刻度间隔（天、月、年）会自适应调整，省却了手动format的麻烦。

怎么用？

假设有个数据集叫df，包含category、value、date三列。画一个基础柱状图：

importaltairasalt alt.Chart(df).mark_bar().encode(x='category:N',# N代表分类变量y='value:Q'# Q代表数值变量)

注意这里category:N和value:Q后缀：N是nominal（分类），Q是quantitative（连续数值），还有T（datetime）和O（有序分类）。这几个编码类型决定了Altair如何解释你的数据——比如日期列用了T，它就会自动生成合理的刻度标签。

要做更复杂的叠加图，可以用+或者|来组合图层。例如画一个同时包含柱状图和平滑曲线的图表：

bar=alt.Chart(df).mark_bar().encode(x='category:N',y='value:Q')line=alt.Chart(df).mark_line(color='red').encode(x='category:N',y='value:Q')bar+line

交互功能一般通过添加.interactive()方法，或者在encode里使用selection。比如让图表支持缩放和平移：

chart=alt.Chart(df).mark_point().encode(x='date:T',y='value:Q').interactive()

最佳实践

抛开那些教科书式的“应该做什么”，我想谈几个真实的经验：

第一，数据集要先清洗成“长格式”。Altair的概念非常依赖tidy data（整洁数据），也就是每列是一个变量、每行是一个观测。很多初次使用的人拿着宽格式（比如每列是一个产品线、每行是一个月的销售额）直接塞进去，结果图表画不出来或者标签错乱。与其在Altair里做数据变形，不如用pandas的melt函数先把宽表格变成纵向格式。

第二，不要害怕用多少字段映射。Altair允许在一个图里同时用颜色、大小、形状、填充纹理等多个视觉通道。但实际中你如果一次性用上五个通道，结果往往是一团糟。有个简单的判断标准：你用眼睛能不能在1秒内分辨出不同类别的数据点？如果不行，就减少通道数量。

第三，注意图表的“可复用性”。Altair的图本质上是一个JSON规范，可以保存成chart.json文件。如果你的报告需要定期生成，建议把图表定义保存成函数，参数化数据源和要展示的字段。这样修改时只需要改传入的DataFrame，不需要重新画一遍。

第四，控制数据量。Altair默认会在浏览器端渲染，如果数据集有几十万行，浏览器可能会卡死。简单的方法是先用pandas做聚合，或者用alt.data_transformers.enable('vegafusion')启用服务器端转译，后者能处理几百万行数据而页面不崩。

和其他技术比一比

常常被人拿来做对比的是Matplotlib、Seaborn、Plotly。简单说说我的感受：

和Matplotlib比，Matplotlib是“画布模式”，你想画一条线，你要先创建Figure、设置坐标轴、再调用plot方法。Altair是“描述模式”，你描述数据关系，它替你生成坐标系。日常快速探索数据时，我倾向Altair，因为它省去大量设置坐标轴标签这种例行公事。但定制化图表（比如极坐标系下的复杂多边形），我还是会回Matplotlib。

和Seaborn比，Seaborn提供了很多高级功能，比如分面网格（FacetGrid）、热力图，这些都包装得挺好的。但它的“声明式”程度不如Altair彻底——Seaborn的很多参数（比如palette）仍然是过程式的。Altair的声明式设计更接近“数据驱动”，尤其在需要动态调整颜色映射或者条件格式时，Altair的语法更直接。

和Plotly比，这两个在交互性上最接近。Plotly的express模块也很简单，但Altair的优势在于“一切皆可组合”——你可以把两个图拼接、叠加，甚至把一个图的selection绑定到另一个图的filter上。Plotly的Dash框架需要写完整的Web应用代码，Altair的交互更像“即时生效”的交互，不需要搭建后台。

非要选一个：如果团队里有人用R且熟悉ggplot2，Altair几乎是零转换成本；如果团队全是Python背景，并且经常需要做交互式仪表盘，Plotly可能更容易入门。但只做静态图表且在Jupyter笔记本里探索数据，Altair是更自然的选择——因为它让你专注于“数据告诉了我们什么”，而不是“如何让matplotlib的标题居中”。环境时会想起的库**。它没有Plotly的华丽，没有Matplotlib的底蕴，但它解决了一个很实际的问题——把Python的数据分析结果，干净利落地变成别人能操作、能分享、能嵌入的网页组件。如果你做过一个需要给不懂技术的人看的数据面板，就会知道“能做出来”和“能真正用上”之间，Bokeh是那个帮你跨过最后一步的工具。