Bokeh 中实现双 X 轴:线性主轴 + 对数副轴的正确方法

云涛君_4222

云涛君_4222

2026-11-11

988人浏览

原创

Bokeh 中实现双 X 轴:线性主轴 + 对数副轴的正确方法

Bokeh 不支持在同一图表中混合使用线性与对数 X 轴(因 x_range_name 关联的范围类型必须与对应轴类型一致),直接替换 LinearAxis 为 LogAxis 会导致刻度消失和绘图失效;根本解法是手动对数变换数据并复用线性轴,或采用双图联动方案。

bokeh 不支持在同一图表中混合使用线性与对数 x 轴(因 `x_range_name` 关联的范围类型必须与对应轴类型一致),直接替换 `linearaxis` 为 `logaxis` 会导致刻度消失和绘图失效;根本解法是手动对数变换数据并复用线性轴,或采用双图联动方案。

在 Bokeh 中为同一图表添加「线性主 X 轴」与「对数副 X 轴」看似可行,实则存在底层限制:extra_x_ranges 定义的范围(如 "x2")一旦被 LogAxis 引用,其数值域必须严格满足对数定义域(即 start > 0),且 Bokeh 不允许多个 X 轴共享同一坐标系但使用不同尺度逻辑——scatter(..., x_range_name="x2") 仍按线性方式映射原始数据到画布,而非自动执行 log10(x) 变换。因此,即使你将 LinearAxis 替换为 LogAxis,若未同步调整数据和范围,就会出现无刻度、点位置错乱等问题。

✅ 正确实践方案有两种,推荐优先使用第一种(简洁可控):

方案一:手动对数变换 + 单一线性轴(推荐)

将对数数据预处理为 log10(log_data),再将其绘制在主 X 轴上,并自定义副 X 轴标签显示原始对数值(即“伪对数轴”):

import numpy as np
import pandas as pd
from bokeh.plotting import figure, show
from bokeh.models import LinearAxis, LabelSet, ColumnDataSource
from bokeh.layouts import gridplot

df = pd.DataFrame([['2024-06-21 06:22:38', 605.968389, 0.994548, 3],
                    ['2024-06-21 06:22:39', 616.009398, 0.983443, 4],
                    ['2024-06-21 06:22:40', 624.630573, 0.973647, 1],
                    ['2024-06-21 06:22:41', 633.476367, 1.017651, 2],
                    ['2024-06-21 06:22:42', 642.322161, 5.017651, 2],
                    ['2024-06-21 06:22:43', 650.268389, 30.726555, 4],
                    ['2024-06-21 06:22:44', 659.559398, 89.2359, 5],
                    ['2024-06-21 06:22:45', 665.630573, 6.92018, 3],
                    ['2024-06-21 06:22:47', 673.476367, 0.69398, 2],
                    ['2024-06-21 06:22:48', 685.322161, 0.770802, 1],
                    ['2024-06-21 06:22:49', 697.155939, 0.856488, 0],
                    ['2024-06-21 06:22:51', 716.763057, 0.934408, 3],
                    ['2024-06-21 06:22:52', 722.012345, 7.865522, 2]],
                   columns=['time', 'Altitude', 'log_data', 'linear_data'])

# ✅ 关键:对 log_data 取 log10(跳过 ≤0 值,此处数据均 >0)
df['log_data_log10'] = np.log10(df['log_data'])

p = figure(title="Linear X (left) + Log-scaled X (bottom, labeled in original units)",
           x_axis_label="Linear Data",
           y_axis_label="Altitude / km",
           frame_height=900, frame_width=700,
           tools="pan,wheel_zoom,box_zoom,reset")

# 主线性数据(红色折线)
p.line('linear_data', 'Altitude', line_color='red', line_width=2, source=df, legend_label="Linear Data")

# 对数变换后数据(蓝色散点),复用主 X 轴
p.scatter('log_data_log10', 'Altitude', size=8, color='blue', alpha=0.8, 
          source=df, legend_label="Log Data (log₁₀ scale)")

# 添加副 X 轴(线性轴,但标签显示原始对数值)
# 构造对数刻度对应的原始值标签:例如 log10(0.1)=−1, log10(1)=0, log10(10)=1, log10(100)=2...
log_ticks = [-1, 0, 1, 2]  # 对应原始值:0.1, 1, 10, 100
log_labels = ["0.1", "1", "10", "100"]

p.add_layout(LinearAxis(major_tick_in_bounds=True,
                        major_label_overrides=dict(zip(log_ticks, log_labels)),
                        axis_label="Log Data (original units)", 
                        axis_label_text_color='blue'),
             'below')

p.legend.location = "top_left"
show(p)

⚠️ 注意事项:

  • 所有 log_data 值必须 > 0;若含零或负数,需预处理(如加偏移量 +1 后取 log10(x+1),并在标签中注明);
  • 副 X 轴本质仍是线性轴,仅通过 major_label_overrides 实现“视觉对数标签”,确保用户理解横坐标含义;
  • 此方案完全规避 Bokeh 的多尺度轴限制,渲染稳定、交互正常(缩放/平移均保持语义一致)。

方案二:双图联动(适合需要独立交互的场景)

若必须物理分离两套 X 轴逻辑,可创建上下/左右并排的两个 figure,共享 Y 轴范围,并用 CustomJS 同步缩放和平移:

# (简略示意,完整实现需 JS 回调)
p_linear = figure(..., x_axis_type='linear', ...)
p_log    = figure(..., x_axis_type='log', ...)  # 注意:x_axis_type='log' 本身即启用对数主轴
# → 然后通过 js_link 或 CustomJS 绑定 x_range

但该方案复杂度高、维护成本大,且无法真正“共用同一画布区域”,一般仅用于专业仪表盘需求。

? 总结:Bokeh 当前版本(v3.3.0+)不支持单图内线性/对数 X 轴混用。最健壮、易维护的解决方案是对数据做显式对数变换,并用线性轴配合自定义标签模拟对数副轴。这既符合 Bokeh 渲染模型,又保证了交互性与可读性,是工业级可视化的推荐实践。

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

2026.11.06

60

12

Postman请求头Headers怎么设置
Postman请求头Headers怎么设置

围绕Postman HTTP请求头配置展开,讲解Headers选项的具体使用方式,包括Key和Value参数填写、请求头信息添加、常见Header字段设置及请求头修改方法,帮助用户解决接口调试过程中遇到的请求头配置问题。

2026.11.06

40

13

Postman接口请求发送教程
Postman接口请求发送教程

详细介绍Postman接口请求的创建与发送方法,涵盖GET和POST请求、URL配置、请求参数、Headers请求头、Body请求体设置以及响应结果查看,帮助用户掌握Postman接口请求的完整操作流程。

2026.11.06

40

10

DBeaver怎么导入数据
DBeaver怎么导入数据

DBeaver数据导入专题,整理Excel、CSV、SQL、TXT等常见文件的数据导入方法,涵盖目标数据库选择、数据表创建、字段映射、数据类型设置及导入参数配置等操作,帮助用户将本地文件中的数据写入数据库,并了解批量导入、重复数据处理和导入失败等常见问题的解决方法。

2026.11.05

60

12

DBeaver安全防护教程大全
DBeaver安全防护教程大全

DBeaver安全防护专题,围绕数据库连接安全、账号密码保护和访问权限管理展开,整理SSL/TLS加密连接、SSH隧道、数据库凭据保存及证书验证等配置方法,同时介绍敏感信息保护、远程连接风险和高权限账号使用等注意事项,帮助用户提高数据库日常管理的安全性。

2026.11.05

60

12

DBeaver连接创建与配置教程
DBeaver连接创建与配置教程

本专题聚焦DBeaver数据库连接配置与管理,覆盖从新建连接、选择数据库类型到填写连接参数和验证连接的完整流程。针对MySQL、PostgreSQL、SQL Server等常见数据库,整理相应的连接设置方法,并提供驱动缺失、认证失败和连接异常等问题的排查方向。

2026.11.04

60

16

XORM框架结构体映射与表结构同步
XORM框架结构体映射与表结构同步

本专题围绕XORM框架的结构体映射展开,说明表名与字段的命名策略、xorm标签常用属性、主键自增与时间字段自动填充,并演示Sync2自动建表、增量字段升级、索引声明与反向生成结构体的完整流程。

2026.11.04

60

15

XORM框架安装配置与数据库连接
XORM框架安装配置与数据库连接

本专题聚焦XORM框架的配置与连接环节,拆解MySQL、PostgreSQL、SQLite、SQL Server的DSN写法与驱动选择,讲清连接池参数、多数据源拆分、读写分离与超时重连的处理方式,并补充容器与兼容数据库的适配经验。

2026.11.04

60

15

XORM框架安装配置与数据库连接
XORM框架安装配置与数据库连接

本专题聚焦XORM框架的配置与连接环节,拆解MySQL、PostgreSQL、SQLite、SQL Server的DSN写法与驱动选择,讲清连接池参数、多数据源拆分、读写分离与超时重连的处理方式,并补充容器与兼容数据库的适配经验。

2026.11.04

0

16

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 134.3万人学习