跳到主要内容

矩形树图

矩形树图用一层层嵌套的矩形铺满一块矩形区域,面积与节点数值成正比。默认用的 squarify 布局会尽量让每个矩形的长宽比 接近正方形 —— 正是这一点让面积能靠眼睛比较。

WITH d AS (SELECT * FROM read_csv_auto('{{DFK_BASE_URL}}data/treemap.tsv')),
kids AS (
SELECT parent AS p, list({'label': label, 'value': value} ORDER BY value DESC) AS ch
FROM d WHERE parent IS NOT NULL AND parent <> ''
GROUP BY parent
)
SELECT kuva_render(to_json({
'title': 'By region',
'series': [{
'type': 'treemap',
'roots': (SELECT list({'label': r.label,
'children': COALESCE(k.ch, CAST([] AS STRUCT(label VARCHAR, value DOUBLE)[]))}
ORDER BY r.label)
FROM d r
LEFT JOIN kids k ON k.p = r.label
WHERE r.parent IS NULL OR r.parent = ''),
'color_mode': 'by_parent'
}]
})) AS chart;

树是在 SQL 里搭出来的:每个父节点用一次 list(…) 把自己的子节点收起来,再用 left join 挂到各个根上。 COALESCE(…, CAST([] AS …)) 是必须的,因为没有子节点的根仍然要带一个空列表 —— children: null 是类型 错误,不是「没有子节点」。

扁平数据​

每个节点都是叶子时就没有层级可嵌,矩形树图退化成一层矩形。一份普通的「部分与整体」拆解本来就该长这样,而且完全不需要 join。

SELECT kuva_render(to_json({
'title': 'Leaves only',
'series': [{
'type': 'treemap',
'roots': roots
}]
})) AS chart
FROM (
SELECT list({'label': label, 'value': value} ORDER BY value DESC) AS roots
FROM read_csv_auto('{{DFK_BASE_URL}}data/treemap.tsv')
WHERE parent IS NOT NULL AND parent <> ''
);

着色方式​

color_mode叶子
"by_parent"继承根的颜色(默认)
"explicit"用节点自己的 color
{"color_map": "viridis"}按一条平行的数值上色,并配色条

color_values 是一条扁平的、按深度优先序排列的数值列表,与叶子平行 —— 这就是矩形树图携带第二个变量的方式: 面积编码一个量,颜色编码另一个。

WITH d AS (SELECT * FROM read_csv_auto('{{DFK_BASE_URL}}data/treemap.tsv')),
kids AS (
SELECT parent AS p, list({'label': label, 'value': value} ORDER BY value DESC) AS ch
FROM d WHERE parent IS NOT NULL AND parent <> ''
GROUP BY parent
)
SELECT kuva_render(to_json({
'title': 'Coloured by value',
'series': [{
'type': 'treemap',
'roots': (SELECT list({'label': r.label,
'children': COALESCE(k.ch, CAST([] AS STRUCT(label VARCHAR, value DOUBLE)[]))}
ORDER BY r.label)
FROM d r
LEFT JOIN kids k ON k.p = r.label
WHERE r.parent IS NULL OR r.parent = ''),
'color_mode': {'color_map': 'viridis'},
'colorbar_label': 'value'
}]
})) AS chart;

布局算法​

layout铺法
"squarify"Bruls 2000 —— 最小化每条带最差的长宽比(默认)
"slice_dice"每层交替横切 / 竖切 —— 简单、可预期
"binary"平衡的二分,方向也交替

slice_dice 更快、画出来是经典的「条纹」观感;它在不均衡的数据上也会产出细长条 —— 而那正是 squarify 存在的理由。

WITH d AS (SELECT * FROM read_csv_auto('{{DFK_BASE_URL}}data/treemap.tsv')),
kids AS (
SELECT parent AS p, list({'label': label, 'value': value} ORDER BY value DESC) AS ch
FROM d WHERE parent IS NOT NULL AND parent <> ''
GROUP BY parent
)
SELECT kuva_render(to_json({
'title': 'Slice and dice',
'series': [{
'type': 'treemap',
'roots': (SELECT list({'label': r.label,
'children': COALESCE(k.ch, CAST([] AS STRUCT(label VARCHAR, value DOUBLE)[]))}
ORDER BY r.label)
FROM d r
LEFT JOIN kids k ON k.p = r.label
WHERE r.parent IS NULL OR r.parent = ''),
'layout': 'slice_dice',
'padding': 6
}]
})) AS chart;

留白、边框与标签​

字段默认设置什么
padding4父节点边框与子节点之间的缝(像素)—— 每深一层减半
border_width0.5叶子与内层边框宽度
root_border_width2根边框宽度
show_labels / show_parent_labelstrue叶子标签与分组标签
min_label_area1200小于这个面积(px²)的格子不写标签
max_depth—最多画到第几层(根为第 0 层)
tooltipstrue输出 SVG 悬停提示

密集的矩形树图上真正要紧的是 min_label_area:没有它,小格子里会印出一堆读不出来的文字碎片。

WITH d AS (SELECT * FROM read_csv_auto('{{DFK_BASE_URL}}data/treemap.tsv')),
kids AS (
SELECT parent AS p, list({'label': label, 'value': value} ORDER BY value DESC) AS ch
FROM d WHERE parent IS NOT NULL AND parent <> ''
GROUP BY parent
)
SELECT kuva_render(to_json({
'title': 'Large labels only',
'series': [{
'type': 'treemap',
'roots': (SELECT list({'label': r.label,
'children': COALESCE(k.ch, CAST([] AS STRUCT(label VARCHAR, value DOUBLE)[]))}
ORDER BY r.label)
FROM d r
LEFT JOIN kids k ON k.p = r.label
WHERE r.parent IS NULL OR r.parent = ''),
'min_label_area': 4000,
'padding': 8,
'root_border_width': 3,
'tooltips': false
}]
})) AS chart;

字段​

字段类型设置什么
rootsnode[]必填。 每个根一项;每项是 {label, value?, color?, children?}。
valuenumber叶子的大小;内部节点不给就由子节点求和。
childrennode[]嵌套节点。带 children 的节点就是内部节点。
colorstring逐节点颜色,"explicit" 模式用。
color_modestring | object"by_parent"(默认)· "explicit" · {"color_map": …}。
color_valuesnumber[]颜色编码用的扁平、深度优先数值。
color_range[number, number]夹住色标。
colorbar / colorbar_labelboolean / string色条与它的标题。
layoutstring"squarify"(默认)· "slice_dice" · "binary"。
paddingnumber父子节点之间的留白。
border_width / root_border_widthnumber边框宽度。
show_labels / show_parent_labelsboolean叶子与分组标签。
min_label_areanumber还写标签的最小格子面积(px²)。
max_depthinteger深度上限。
tooltipsbooleanSVG 悬停提示(默认开)。

说明​

  • roots 不能为空。 每个节点都要有 label;叶子还要有 value。
  • 内部节点不给 value 时由子节点求和;给了就以它为准 —— 想让某个父节点故意大于各部分之和,就用这个。
  • children 必须是空列表、不能是 null —— SQL 示例里的 COALESCE(…, CAST([] AS …)) 就是为它写的。
  • color_values 是深度优先的扁平列表,所以长度必须等于叶子数、顺序必须与树一致 —— 这一页里最容易悄悄搞错的 就是这个。
  • padding 每深一层减半,所以很深的树内层缝隙会很小。

另见​