跳到主要内容

向量场图

向量场图把二维向量场画成一格格箭头。每支箭有尾端 (x, y),以及一个决定方向和长度的向量 (u, v)。 流体、力场、梯度、风场 / 洋流 —— 任何「每个位置都有一个方向和大小」的数据,标准画法就是它。

WITH g AS (SELECT ((i * 10.0 / 9.0) - 5.0)::DOUBLE AS v FROM (SELECT unnest(range(0, 10)) AS i))
SELECT kuva_render(to_json({
'title': 'Rotational field',
'x_axis': {'name': 'x'},
'y_axis': {'name': 'y'},
'series': [{
'type': 'quiver',
'arrows': (SELECT list({'x': x.v, 'y': y.v, 'u': -y.v * 0.3, 'v': x.v * 0.3}) FROM g x, g y),
'color': 'steelblue'
}]
})) AS chart;

这就是旋转场 (u, v) = (−y, x) · 0.3 在 10×10 网格上的采样。真实数据一般来自表 —— 每行一支箭,四个数值列 x、y、u、v:

SELECT kuva_render(to_json({
'x_axis': {'name': 'x'},
'y_axis': {'name': 'y'},
'series': [{
'type': 'quiver',
'arrows': list({'x': x, 'y': y, 'u': u, 'v': v}),
'color': 'steelblue'
}]
})) AS chart
FROM read_csv_auto('{{DFK_BASE_URL}}data/quiver.tsv');

缩放​

默认的乘数是自动算出来的:让最长的那支箭大致占一个格子。这样不管 (u, v) 是什么量纲,箭头都不会糊成 一片。

两个字段可以覆盖它:

字段作用
scale钉死乘数。箭头的长度(数据坐标)就是 (u, v) · scale。
auto_scale_fraction仍然自动缩放,只改目标比例(默认 0.9)。接近 1.0 会把箭头首尾相接地排满;更小就更透气。
SELECT kuva_render(to_json({
'title': 'Pinned scale',
'x_axis': {'name': 'x'},
'y_axis': {'name': 'y'},
'series': [{
'type': 'quiver',
'arrows': list({'x': x, 'y': y, 'u': u, 'v': v}),
'color': 'steelblue',
'scale': 0.5
}]
})) AS chart
FROM read_csv_auto('{{DFK_BASE_URL}}data/quiver.tsv');

锚点​

pivot 说的是 (x, y) 落在箭头的哪个位置:

pivot含义
"tail"(x, y) 是尾端,箭头从它指出去(默认)
"middle"箭头以 (x, y) 为中心
"tip"(x, y) 是箭头尖端,箭头指进这个点

对采样出来的场来说,"middle" 更贴合「这个位置上场是什么样」的读法。

SELECT kuva_render(to_json({
'title': 'Pivot at the middle',
'x_axis': {'name': 'x'},
'y_axis': {'name': 'y'},
'series': [{
'type': 'quiver',
'arrows': list({'x': x, 'y': y, 'u': u, 'v': v}),
'color': 'steelblue',
'pivot': 'middle'
}]
})) AS chart
FROM read_csv_auto('{{DFK_BASE_URL}}data/quiver.tsv');

按模长上色​

color_map 按每支箭的模长 √(u² + v²) 上色,并自动画一条色条,标题取自 color_legend_label。

SELECT kuva_render(to_json({
'title': 'Coloured by magnitude',
'x_axis': {'name': 'x'},
'y_axis': {'name': 'y'},
'series': [{
'type': 'quiver',
'arrows': list({'x': x, 'y': y, 'u': u, 'v': v}),
'color_map': 'viridis',
'color_legend_label': 'magnitude'
}]
})) AS chart
FROM read_csv_auto('{{DFK_BASE_URL}}data/quiver.tsv');

优先级:逐支箭的 color 高于 color_map,color_map 高于 series 的 color。

箭头的样式​

字段默认作用
shaft_width1.2杆的线宽(像素)
head_ratio0.28箭头长 / 杆长
head_length / head_width按比例把箭头钉成固定的像素尺寸
head_min_px / head_max_px4 / 14给按比例的箭头长度加上下限,短箭也看得见箭头

默认箭头是按比例的,所以不管模长多大,画出来都像一支箭。把 head_length / head_width 钉住,则在一张 模长混杂的场里,每支箭的箭头都一样大。

SELECT kuva_render(to_json({
'x_axis': {'name': 'x'},
'y_axis': {'name': 'y'},
'series': [{
'type': 'quiver',
'arrows': list({'x': x, 'y': y, 'u': u, 'v': v}),
'color': 'steelblue',
'shaft_width': 1,
'head_ratio': 0.35
}]
})) AS chart
FROM read_csv_auto('{{DFK_BASE_URL}}data/quiver.tsv');

字段​

字段类型设置什么
arrowsarrow[]必填。 每支箭一项:{x, y, u, v, color?}。
colorstring箭头颜色。
scalenumber(u, v) 的乘数;不给就自动缩放。
auto_scale_fractionnumber自动缩放时箭头占画面的目标比例。
shaft_widthnumber杆的线宽(像素)。
head_lengthnumber箭头长度(像素)。
head_widthnumber箭头半宽(像素)。
head_rationumber箭头长 / 杆长。
head_aspectnumber箭头半宽 / 箭头长。
head_min_px / head_max_pxnumber箭头长度的上下限(像素)。
color_mapstring按模长上色的色图;覆盖 color。
color_range[number, number]色图覆盖的模长区间。
color_legend_labelstring色条的标题。
legendstring图例文字。
tight_boundsboolean只用尾端定坐标范围,不算箭头末端。
clip_to_plot_areaboolean把箭头裁在绘图区内(false 允许溢出)。
pivotstring箭头的锚点:"tail"(默认)· "middle" · "tip"。

说明​

  • arrows 不能为空,且每支箭的 x、y、u、v 都必须是有限值 —— 出现非有限值是报错,而不是悄悄 丢掉那支箭。
  • color_map 按模长上色;没有逐支颜色时,逐支 color 会盖过它。
  • 边缘的箭头会把坐标范围撑开时,tight_bounds 值得打开。

另见​