跳到主要内容

等高线图

等高线图把二维标量场的等值线(或填色的等值带)画出来 —— 把所有 z 值相同的点连起来。任何连续曲面都适合它: 密度函数、空间梯度、地形,以及任何在 x–y 平面上变化的场。

WITH c AS (SELECT (i / 10.0 - 3.0)::DOUBLE AS v FROM (SELECT unnest(range(0, 61)) AS i)),
grid AS (
SELECT y.v AS yv,
list(exp(-(x.v * x.v + y.v * y.v) / 2) ORDER BY x.v) AS row_z
FROM c x, c y
GROUP BY y.v
)
SELECT kuva_render(to_json({
'title': 'Iso-line contours — Gaussian peak',
'x_axis': {'name': 'x'},
'y_axis': {'name': 'y'},
'series': [{
'type': 'contour',
'z': (SELECT list(row_z ORDER BY yv) FROM grid),
'x_coords': (SELECT list(v ORDER BY v) FROM c),
'y_coords': (SELECT list(v ORDER BY v) FROM c),
'n_levels': 10,
'line_color': 'steelblue',
'line_width': 1.2
}]
})) AS chart;

网格写法给的是 z[row][col],其中 z[row][col] 是位置 (x_coords[col], y_coords[row]) 上的值 —— 按行优先,x 变化最快。十条等距等值线描出了这个峰的一圈圈椭圆。

填色等高线​

filled 用色图给相邻等值线之间的带子上色,而不是画线;legend 会在右侧留白里打开一条色条。

WITH c AS (SELECT (i * 0.25 - 5.0)::DOUBLE AS v FROM (SELECT unnest(range(0, 41)) AS i)),
grid AS (
SELECT y.v AS yv,
list(
exp(-((x.v - 1.5) * (x.v - 1.5) + (y.v - 1.5) * (y.v - 1.5)) / 4.0)
+ 0.7 * exp(-((x.v + 2.0) * (x.v + 2.0) + (y.v + 1.5) * (y.v + 1.5)) / 3.0)
ORDER BY x.v) AS row_z
FROM c x, c y
GROUP BY y.v
)
SELECT kuva_render(to_json({
'title': 'Filled contours — bimodal surface',
'x_axis': {'name': 'x'},
'y_axis': {'name': 'y'},
'series': [{
'type': 'contour',
'z': (SELECT list(row_z ORDER BY yv) FROM grid),
'x_coords': (SELECT list(v ORDER BY v) FROM c),
'y_coords': (SELECT list(v ORDER BY v) FROM c),
'n_levels': 9,
'filled': true,
'color_map': 'inferno',
'legend': 'density'
}]
})) AS chart;

散点输入​

points 收的是 [x, y, z] 三元组,位置随便,不需要网格。渲染前会把它们插值到一张内部网格上,所以 组织样本坐标、不规则的传感器读数这类空间数据用它最自然。

SELECT kuva_render(to_json({
'title': 'Contour from scattered points',
'x_axis': {'name': 'x'},
'y_axis': {'name': 'y'},
'series': [{
'type': 'contour',
'points': pts,
'n_levels': 8,
'filled': true,
'color_map': 'inferno',
'legend': 'density'
}]
})) AS chart
FROM (
SELECT list({'x': x, 'y': y, 'z': density}) AS pts
FROM read_csv_auto('{{DFK_BASE_URL}}data/contour.tsv')
);

点越密,插值出来的等值线越锐利;内部网格的分辨率是固定的,与你给多少点无关。

显式等值线​

levels 把等值线钉在具体的 z 值上,并覆盖 n_levels。想让线落在有意义的阈值上时就用它 —— 表达量 截断、概率轮廓、固定的高程间隔。

WITH c AS (SELECT (i / 10.0 - 3.0)::DOUBLE AS v FROM (SELECT unnest(range(0, 61)) AS i)),
grid AS (
SELECT y.v AS yv,
list(exp(-(x.v * x.v + y.v * y.v) / 2) ORDER BY x.v) AS row_z
FROM c x, c y
GROUP BY y.v
)
SELECT kuva_render(to_json({
'title': 'Explicit iso-levels',
'x_axis': {'name': 'x'},
'y_axis': {'name': 'y'},
'series': [{
'type': 'contour',
'z': (SELECT list(row_z ORDER BY yv) FROM grid),
'x_coords': (SELECT list(v ORDER BY v) FROM c),
'y_coords': (SELECT list(v ORDER BY v) FROM c),
'levels': [0.1, 0.25, 0.5, 0.75, 0.9],
'line_color': 'darkgreen',
'line_width': 1.5
}]
})) AS chart;

最里面 0.9 那圈紧紧裹住峰顶;最外面 0.1 那圈几乎顶到网格边界。

线的颜色​

默认每根等值线的颜色取自当前色图。line_color 用一个固定色覆盖它,所有线同色 —— 想要干净的无彩图,或者 色图要留给填色背景时,就该这么做。line_width 是线宽(默认 1)。

色图​

color_map 选的是填色带子和未指定颜色的等值线所用的色图。可选的名字与 热力图完全一样,完整列表见色图。默认 "viridis"。

字段​

字段类型设置什么
znumber[][]网格写法:z[row][col]。需要 x_coords 与 y_coords。
x_coordsnumber[]网格每列的 x;长度必须等于网格的列数。
y_coordsnumber[]网格每行的 y;长度必须等于网格的行数。
points[x, y, z][]散点写法:三元组,渲染时插值。
levelsnumber[]显式的等值线数值(覆盖 n_levels)。
n_levelsinteger等值线条数(默认 8)。
filledboolean在等值线之间填色,而不是只画线。
color_mapstring色图。
line_colorstring等值线颜色(非填色模式)。
line_widthnumber等值线线宽。
legendstring色条的标题。
网格或散点,总得给一个

必须给网格(z + x_coords + y_coords)或 points 之一。两个都给它不支持;z 优先。

说明​

  • 网格需要至少 2 行 2 列,每行等长,且 x_coords / y_coords 的长度要与网格的列数 / 行数一致 —— 对不上是报错,而不是悄悄 panic。
  • x_coords 与 y_coords 必须和 z 一起给。
  • points 不能为空。

另见​