跳到主要内容

第二坐标轴(双 Y 轴)

一张图通常只有一套坐标轴。要把两个量纲差很远的量画在一起 —— 比如价格与成交量 —— 就把第二个量放进 secondary_series,并用 y2_axis(右侧)或 x2_axis(上方)描述它的轴。

字段类型设置什么
secondary_seriesseries[]画在第二根轴上的 series,形状与 series 相同。
y2_axisobject右侧的 y 轴。
x2_axisobject上方的 x 轴。

y2_axis 与 x2_axis 接受坐标轴字段的一个子集:

字段类型设置什么
namestring坐标轴标题。
min / maxnumber固定范围。
logboolean对数轴。
tick_formatstring | integer与主轴相同。
wrapinteger标题按字符数折行。
label_offset[number, number]把标题平移 [dx, dy] 像素。
第二根 x 轴的两条规则

第二根 x 轴的 min 与 max 必须一起给 —— 只给一个会报错。另外,只有 secondary_series 里有东西时 第二根轴才会画出来;只写 y2_axis 能解析,但得到的是一张普通的单轴图。

右轴的范围从 secondary_series 的数据里推出来,所以只写了 name 的 y2_axis 也画得出那根轴。 min / max 是可选的覆盖:两个都给就是固定范围,只给一个就固定那一端、另一端继续跟着数据走。 下面的示例就没给。

示例​

左轴收盘价、右轴成交量,用的是同一批行:

SELECT kuva_render(to_json({
'title': 'price vs volume',
'y_axis': {'name': 'close', 'min': 100, 'max': 200},
'y2_axis': {'name': 'volume', 'tick_format': 'sci'},
'legend': {'position': 'outside_right_top'},
'series': [{'type': 'line', 'data': price, 'legend': 'close', 'color': '#4c72b0'}],
'secondary_series': [{'type': 'line', 'data': vol, 'legend': 'volume', 'color': '#c44e52'}]
})) AS chart
FROM (
SELECT
array_agg({'x': epoch(CAST(date AS DATE)), 'y': close} ORDER BY date) AS price,
array_agg({'x': epoch(CAST(date AS DATE)), 'y': volume} ORDER BY date) AS vol
FROM read_csv_auto('{{DFK_BASE_URL}}data/candlestick.tsv')
);

说明​

多面板模式下,第二根轴属于某一个面板 —— 也就是说一张双 Y 轴图是网格里的一个面板。