跳到主要内容

极坐标图

极坐标图把数据放在 (r, θ) 空间里 —— 半径与角度 —— 画在一张带可调网格的圆形画布上。方向性数据、 周期信号、以及任何绕着圆周测量出来的东西,用它最自然。

默认是罗盘约定:θ = 0 指向正北(上方),角度顺时针增大。想换成数学约定(θ = 0 指东、逆时针), 把 "theta_start": 90 与 "clockwise": false 一起给上。

SELECT kuva_render(to_json({
'title': 'Polar plot',
'series': [{
'type': 'polar',
'series': series,
'r_max': 6,
'r_grid_lines': 4,
'theta_divisions': 8,
'show_legend': true
}]
})) AS chart
FROM (
SELECT list({'r': rs, 'theta': ths, 'label': g, 'mode': 'line'} ORDER BY g) AS series
FROM (
SELECT "group" AS g, list(r ORDER BY theta) AS rs, list(theta ORDER BY theta) AS ths
FROM read_csv_auto('{{DFK_BASE_URL}}data/polar.tsv')
GROUP BY "group"
)
);

角度单位是度,不是弧度;一个 series 的 r 与 theta 是按位置配对的 —— 在聚合里让它们保持同样的排序。

散点与折线两种模式​

mode 决定一个 series 怎么画:

mode画成
"scatter"每个 (r, θ) 一个 marker(默认)
"line"按顺序连接各点的路径
SELECT kuva_render(to_json({
'title': 'Directional scatter',
'series': [{
'type': 'polar',
'series': series,
'r_max': 6,
'theta_divisions': 24,
'show_legend': true
}]
})) AS chart
FROM (
SELECT list({'r': rs, 'theta': ths, 'label': g} ORDER BY g) AS series
FROM (
SELECT "group" AS g, list(r ORDER BY theta) AS rs, list(theta ORDER BY theta) AS ths
FROM read_csv_auto('{{DFK_BASE_URL}}data/polar.tsv')
GROUP BY "group"
)
);

约定​

一条心形线 r = 1 + cos θ,用数学约定画:theta_start 把 0° 放到正东,clockwise: false 让角度逆时针 增大。

WITH t AS (SELECT (i * 5.0)::DOUBLE AS th FROM (SELECT unnest(range(0, 72)) AS i))
SELECT kuva_render(to_json({
'title': 'Cardioid',
'series': [{
'type': 'polar',
'series': [{
'r': (SELECT list(1.0 + cos(radians(th)) ORDER BY th) FROM t),
'theta': (SELECT list(th ORDER BY th) FROM t),
'label': 'Cardioid',
'mode': 'line'
}],
'theta_start': 90,
'clockwise': false,
'r_max': 2.1,
'r_grid_lines': 4,
'theta_divisions': 12,
'show_legend': true
}]
})) AS chart;

marker 不透明度与描边​

marker_opacity 与 marker_stroke_width 只对 "scatter" 的 series 有效 —— 折线 series 会忽略它们。 方向性数据一密,降低不透明度就能让密处比边缘更深,细描边则让每个观测还数得清。

SELECT kuva_render(to_json({
'title': 'Semi-transparent markers',
'series': [{
'type': 'polar',
'series': series,
'r_max': 6,
'theta_divisions': 24
}]
})) AS chart
FROM (
SELECT list({'r': rs, 'theta': ths, 'label': g,
'marker_opacity': 0.3, 'marker_stroke_width': 0.7} ORDER BY g) AS series
FROM (
SELECT "group" AS g, list(r ORDER BY theta) AS rs, list(theta ORDER BY theta) AS ths
FROM read_csv_auto('{{DFK_BASE_URL}}data/polar.tsv')
GROUP BY "group"
)
);

半径起点​

r_min 决定哪个值落在圆心;默认是 0。给了非零的 r_min 之后,半径为 r 的点会画在离圆心 max(r − r_min, 0) / (r_max − r_min) 的位置,低于 r_min 的一律夹到圆心。这时圆心标签会显示 r_min, 刻度不会被误读。

dB 量纲的东西就是靠它画的 —— 天线增益、声压级。下面这个主瓣从 −20 dBi(零点)一直到 0 dBi:

WITH t AS (SELECT i::DOUBLE AS th FROM (SELECT unnest(range(0, 361)) AS i))
SELECT kuva_render(to_json({
'title': 'Antenna pattern (dBi)',
'series': [{
'type': 'polar',
'series': [{
'r': (SELECT list(greatest(-20.0, least(0.0, pow(cos(radians(th) / 2.0), 4) * 20.0 - 20.0))
ORDER BY th) FROM t),
'theta': (SELECT list(th ORDER BY th) FROM t),
'mode': 'line',
'color': 'steelblue'
}],
'r_min': -20,
'r_max': 0,
'r_grid_lines': 4,
'theta_divisions': 12
}]
})) AS chart;

网格控制​

字段默认作用
r_grid_lines4同心圆网格线的根数
theta_divisions12圆周方向的辐条数
show_gridtrue是否画网格
show_r_labelstrue是否给每个圆环标出半径值

字段​

字段类型设置什么
seriesseries[]必填。 一条或多条曲线 / 点集(见下)。
r_max / r_minnumber半径上下限(默认按数据定)。
theta_startnumber0° 指向哪里(度)。
clockwiseboolean角度增大方向为顺时针(默认开)。
r_grid_linesinteger半径方向的网格线根数。
theta_divisionsinteger圆周分成几格。
show_gridboolean画网格。
show_r_labelsboolean标出半径刻度。
show_legendboolean显示图例。
tooltipsboolean悬停提示。
tooltip_labelsstring[]每个点一条提示文字。

series 的每一项带 r 与 theta(都必填、等长;theta 单位是度),外加 label、color、mode ("scatter" 或 "line")、marker_size、stroke_width、line_dash、marker_opacity、 marker_stroke_width。

说明​

  • r 与 theta 必须等长,series 不能为空。
  • 角度单位是度,不是弧度。
  • marker_opacity / marker_stroke_width 对 "line" 的 series 无效。
  • 图例需要 show_legend 且 至少一个 series 带了 label。

另见​