跳到主要内容

三维散点图

三维散点图用正交相机把 (x, y, z) 投到画布上,并把点按从后到前的顺序画。它沿用二维图那套开放盒框线、背板填充与 网格线,所以放进一组图里不会看起来像另一个物种。

SELECT kuva_render(to_json({
'title': '3D scatter',
'series': [{
'type': 'scatter3d',
'data': pts,
'color': 'steelblue',
'x_label': 'X',
'y_label': 'Y',
'z_label': 'Z'
}]
})) AS chart
FROM (
SELECT list({'x': x, 'y': y, 'z': z}) AS pts
FROM read_csv_auto('{{DFK_BASE_URL}}data/scatter3d.tsv')
);

一个点可以写成三元数组 [x, y, z],也可以写成对象 {"x": …, "y": …, "z": …} —— 数组更短,对象在 SQL 里按条件 构造更方便。

按 Z 上色​

z_colormap 按每个点自己的 z 值上色,并自动配一条色条;z_label 同时给轴和那条色条命名。要让第三个维度不仅 是空间位置、还能被定量读出来,这就是标准做法。

SELECT kuva_render(to_json({
'title': 'Coloured by Z',
'series': [{
'type': 'scatter3d',
'data': pts,
'z_colormap': 'viridis',
'x_label': 'X',
'y_label': 'Y',
'z_label': 'Z',
'size': 4
}]
})) AS chart
FROM (
SELECT list({'x': x, 'y': y, 'z': z}) AS pts
FROM read_csv_auto('{{DFK_BASE_URL}}data/scatter3d.tsv')
);

逐点颜色与大小​

colors 与 sizes 是两条平行的列表 —— 每个点一项,按数据顺序。一个分组列就是这样变成颜色的,第四个变量也是这样 变成半径的。

SELECT kuva_render(to_json({
'title': 'Coloured by group',
'series': [{
'type': 'scatter3d',
'data': pts,
'colors': cols,
'sizes': szs,
'x_label': 'X',
'y_label': 'Y',
'z_label': 'Z',
'legend': 'group'
}]
})) AS chart
FROM (
SELECT list({'x': x, 'y': y, 'z': z} ORDER BY "group", x) AS pts,
list(CASE "group" WHEN 'A' THEN '#4c72b0'
WHEN 'B' THEN '#dd8452'
ELSE '#55a868' END ORDER BY "group", x) AS cols,
list(4 + z / 4 ORDER BY "group", x) AS szs
FROM read_csv_auto('{{DFK_BASE_URL}}data/scatter3d.tsv')
);

三个聚合里的 ORDER BY 是同一个 —— 这正是关键:data、colors、sizes 是按位置配对的,其中任何一个换了 排序,图就会被搅乱,而且没有任何东西会提醒你。

视角与深度​

azimuth 与 elevation 决定相机位置(默认 -60 与 30)。depth_shade 把远处的点调淡 —— 在一张静态图上, 只有框线往往不够,它是真正有效的深度线索。

SELECT kuva_render(to_json({
'title': 'Low angle, depth shading',
'series': [{
'type': 'scatter3d',
'data': pts,
'azimuth': -120,
'elevation': 20,
'depth_shade': true,
'marker': 'circle',
'marker_opacity': 0.85,
'x_label': 'X',
'y_label': 'Y',
'z_label': 'Z'
}]
})) AS chart
FROM (
SELECT list({'x': x, 'y': y, 'z': z}) AS pts
FROM read_csv_auto('{{DFK_BASE_URL}}data/scatter3d.tsv')
);

立方体​

字段默认设置什么
azimuth / elevation-60 / 30相机角度(度)
show_gridtrue三面背板上的网格线
show_boxtrue外框线
grid_lines5每根轴的分格数
z_axis_right自动强制 z 轴在右(true)或左(false)
z_axis_autotrue让渲染器自己决定放哪边
SELECT kuva_render(to_json({
'title': 'No box, denser grid',
'series': [{
'type': 'scatter3d',
'data': pts,
'show_box': false,
'grid_lines': 8,
'z_axis_right': true,
'x_label': 'X',
'y_label': 'Y',
'z_label': 'Z'
}]
})) AS chart
FROM (
SELECT list({'x': x, 'y': y, 'z': z}) AS pts
FROM read_csv_auto('{{DFK_BASE_URL}}data/scatter3d.tsv')
);

字段​

字段类型设置什么
datapoint3[]必填。 每项是 [x, y, z] 或 {x, y, z}。
colorstring统一点色(默认 steelblue)。
sizenumbermarker 半径(像素,默认 3)。
markerstring"circle"(默认)· "square" · "triangle" · "diamond" · "cross" · "plus"。
colorsstring[]逐点颜色;盖过 color。
sizesnumber[]逐点半径;盖过 size。
z_colormapstring按 z 值上色,并画一条色条。
depth_shadeboolean把远处的点调淡。
marker_opacity / marker_stroke_widthnumbermarker 的填充不透明度与描边宽度。
azimuth / elevationnumber相机角度。
x_label / y_label / z_labelstring轴标题;z_label 同时给色条命名。
show_grid / show_boxboolean背板网格与外框。
grid_linesinteger每根轴的分格数(默认 5)。
z_axis_right / z_axis_autobooleanz 轴画在哪一侧。
legendstring这个系列的图例文字。

说明​

  • data 不能为空,且每个点三个坐标都要给。
  • colors 与 sizes 给了就必须与点数严格一致 —— 它们是按位置配对,不是按坐标。
  • z_colormap 会盖过 colors,两者不会混合。
  • 3D 图没有 tooltips、也没有可设的坐标范围:相机与数据决定一切。
  • 遮挡靠从后往前画来处理,这对点是对的;两个物体真正相交的场合则不对 —— 这里没有 z 缓冲。

另见​