跳到主要内容

地平线图

地平线图能把很多条时间序列塞进很小的竖直空间。每个系列占一行;取值范围被切成 N 条等宽的带,折叠回这一行、并 逐层加深。正偏离用一种颜色、负偏离用另一种,于是一整屏四十个指标也能挤在一页里。

WITH d AS (SELECT * FROM read_csv_auto('{{DFK_BASE_URL}}data/horizon.tsv'))
SELECT kuva_render(to_json({
'title': 'Activity by series',
'x_axis': {'name': 'week', 'tick_format': 'integer'},
'series': [{
'type': 'horizon',
'series': (SELECT list({'label': series, 'x': xs, 'y': ys} ORDER BY series)
FROM (SELECT series,
list(week ORDER BY week) AS xs,
list(value ORDER BY week) AS ys
FROM d GROUP BY series)),
'n_bands': 3,
'row_height': 40
}]
})) AS chart;

每个系列自带 x 与 y,所以周次在每行里各写一遍 —— 正是这一点让采样不同步的系列能放进同一张图。每个系列的 y 都要与它自己的 x 等长。

分带数量​

n_bands 是每行折叠进去的着色层数。带越多结构越细,代价是这一行更深、更花;默认三层是通常的折中。

WITH d AS (SELECT * FROM read_csv_auto('{{DFK_BASE_URL}}data/horizon.tsv')),
s AS (
SELECT series, list(week ORDER BY week) AS xs, list(value ORDER BY week) AS ys
FROM d GROUP BY series
)
SELECT kuva_render(to_json({
'title': 'Two bands',
'x_axis': {'name': 'week', 'tick_format': 'integer'},
'series': [{
'type': 'horizon',
'series': (SELECT list({'label': series, 'x': xs, 'y': ys} ORDER BY series) FROM s),
'n_bands': 2,
'row_height': 48
}]
})) AS chart;

数值标注​

value_labels 在每行右端印出这一行的满量程值 —— 也就是最深那一层代表多少。地平线图只有这一个定量锚点, 图是要被读而不是被扫一眼的,就该带上它。sign_colors 再把这个 + / − 号染成该系列自己的颜色。

WITH d AS (SELECT * FROM read_csv_auto('{{DFK_BASE_URL}}data/horizon.tsv')),
s AS (
SELECT series, list(week ORDER BY week) AS xs, list(value ORDER BY week) AS ys
FROM d GROUP BY series
)
SELECT kuva_render(to_json({
'title': 'With scale annotations',
'x_axis': {'name': 'week', 'tick_format': 'integer'},
'series': [{
'type': 'horizon',
'series': (SELECT list({'label': series, 'x': xs, 'y': ys} ORDER BY series) FROM s),
'n_bands': 3,
'row_height': 40,
'value_labels': true,
'sign_colors': true
}]
})) AS chart;

自定义颜色​

每个系列可以带自己的 pos_color 与 neg_color。除了对齐项目配色,这也是让某个系列在几张图里保持同一个颜色的 办法 —— 自动配色取决于系列出现的顺序。

WITH d AS (SELECT * FROM read_csv_auto('{{DFK_BASE_URL}}data/horizon.tsv')),
s AS (
SELECT series, list(week ORDER BY week) AS xs, list(value ORDER BY week) AS ys
FROM d GROUP BY series
)
SELECT kuva_render(to_json({
'title': 'Explicit colours',
'x_axis': {'name': 'week', 'tick_format': 'integer'},
'series': [{
'type': 'horizon',
'series': (SELECT list({'label': series, 'x': xs, 'y': ys,
'pos_color': CASE series WHEN 'Alpha' THEN '#2ca02c' ELSE '#1f77b4' END,
'neg_color': '#d62728'}
ORDER BY series) FROM s),
'n_bands': 4,
'row_height': 48,
'value_labels': true
}]
})) AS chart;

共享刻度​

默认每个系列按自己的范围缩放,于是行与行之间的深浅不可比 —— 一条很深的行可能只是个小数值。value_max 强制 一个共享上限,一层带在哪儿都是同一个意思。

WITH d AS (SELECT * FROM read_csv_auto('{{DFK_BASE_URL}}data/horizon.tsv')),
s AS (
SELECT series, list(week ORDER BY week) AS xs, list(value ORDER BY week) AS ys
FROM d GROUP BY series
)
SELECT kuva_render(to_json({
'title': 'Shared ±30 scale',
'x_axis': {'name': 'week', 'tick_format': 'integer'},
'series': [{
'type': 'horizon',
'series': (SELECT list({'label': series, 'x': xs, 'y': ys} ORDER BY series) FROM s),
'value_max': 30,
'n_bands': 3,
'row_height': 40,
'value_labels': true
}]
})) AS chart;

字段​

字段类型设置什么
seriesseries[]必填。 每项 {label, x, y, pos_color?, neg_color?} —— 一个系列一行。
n_bandsinteger每行的着色层数(默认 3)。
row_heightnumber行高(像素)。
baselinenumber正负分界(默认 0)。
value_maxnumber共享的最大绝对值,用来定分带。
value_labelsboolean在每行右端印出满量程值。
sign_colorsboolean给 +/− 号上色(需要 value_labels)。
show_legendboolean每个系列一条图例。

说明​

  • series 不能为空,且每一项里 x 与 y 必须等长。
  • label 必填 —— 显示图例时靠它辨认每一行。
  • 不给 value_max 时各行不可比:只有行内部的形状有意义。
  • sign_colors 在 value_labels 关掉时不起作用。
  • 地平线图拿定量可读性换密度;数字本身重要时,改用河流图,或者一组 折线图拼的小多图。

另见​