第 5 章 · 第 1 节 基础

5.1 时间的属性

学习目标

识别顺序、连续、周期与层级结构对时间编码的影响。

本节要点

  • 时间有顺序、连续、周期、独立于空间和层级结构等属性。
  • 不同属性适合不同编码:折线、日历、螺旋、故事线各有假设。
  • 时间先后不等于因果关系,图形只能显示相关。

01理解概念

案例

原 6.1 节列出 5 个时间属性,没有可视化。这章把这 5 个属性变成可交互卡片。

概念与方法

  • 有序性:时间是有序的,两个事件有先后次序,与因果关系紧密相连。
  • 连续性:时间连续,两个时间点之间总存在另一个时间点。
  • 周期性:自然过程常有循环规律(季节、昼夜),可采用循环时间域。
  • 独立于空间:时间与空间紧相关,但科学过程大多独立处理。
  • 结构性:时间尺度分年/月/日/时/分/秒,分割既有自然反映(昼夜)也有人为定义(60 秒)。

为什么 5 个属性都重要?

设计时序图前先想清楚这 5 个属性,能避免常见错误:

  • 有序性缺失 → 散点图错位成噪声
  • 连续性混淆 → 离散数据用错连线
  • 周期性忽略 → 季节趋势被"抹平"
  • 结构性不匹配 → 工作日/周末、闰年都出错

02动手实验

试一试:逐项查看时间属性,为每项找一个适合的图表例子,区分观测先后与因果关系。

实验将在进入此区域时加载,需要启用 JavaScript。

此处数据用于教学演示,不据此作真实人口、气候或电影时间点推断。

做完后:你应该看到
能为五个属性各举一个合适图表,并区分观测顺序与因果解释。
03代码与讲解收起 / 展开 +

⭐ 关键代码

⭐ 关键点 1:5 个属性以对象数组组织

// 单一数据源:5 个属性 + 含义 + 例子 + 颜色
const TIME_ATTRIBUTES = [
  { key: 'ordered',          name: '有序性',     icon: '↗',
    desc: '时间是有序的。两个事件发生的时间有先后次序,与因果关系紧密相连。',
    example: '火车时刻表、事件日志、git commit history', color: '#3b82f6' },
  { key: 'continuous',       name: '连续性',     icon: '∞',
    desc: '时间是连续的。两个时间点之间总存在另一个时间点。',
    example: '实时传感器数据(温度、心率)、流式数据流', color: '#10b981' },
  { key: 'periodic',         name: '周期性',     icon: '🔁',
    desc: '许多自然过程有循环规律(季节、昼夜)。可采用循环时间域表示。',
    example: '24h 体温、12 个月气温、年周期销售', color: '#f59e0b' },
  { key: 'spatial_independent', name: '独立于空间', icon: '✂️',
    desc: '时间与空间紧相关,但科学过程大多将它们独立处理。',
    example: '折线图 x 轴只用时间、y 轴只用度量', color: '#8b5cf6' },
  { key: 'structured',       name: '结构性',     icon: '📐',
    desc: '时间尺度分年/月/日/时/分/秒,分割既有自然反映(昼夜)也有人为定义。',
    example: '日历/周排列、闰年调整、工作日 vs 周末', color: '#ec4899' }
];

⭐ 对象数组 = 一份数据 + 多处使用。卡片渲染、详细解释、筛选过滤都从同一数据源派生,避免改一处漏一处。

⭐ 关键点 2:d3.timeDay.range 生成等间距日序列

// 生成 2024-01-01 到 2024-12-31 之间所有日期(366 天)
const days = d3.timeDay.range(new Date(2024, 0, 1), new Date(2025, 0, 1));
// 输出:[Date(2024-01-01), Date(2024-01-02), ..., Date(2024-12-31)]
console.log(days.length);  // 366(闰年)

⭐ d3.timeDay 是 d3-time 模块的核心:range(start, stop) 返回两个时刻之间所有"日"的离散数组,offset(date, n) 加减 n 天。结构性(structural)就靠这种"时间尺度"操作实现。

04练习

观察到 A 总在 B 之前发生,能直接证明 A 导致 B 吗?

学完后,可以标记进度。

第 5 章 · 第 2 节 基础

5.2 用折线观察趋势

学习目标

阅读时间轴、比较多条趋势,并识别演示数据的来源边界。

本节要点

  • 时间轴加多条线用于比较趋势、峰值和交叉。
  • 先读数据来源和单位;演示数据不能推断真实气候或人口。
  • 线宽、颜色和平滑方式会影响读图。

01理解概念

案例

原 6.2.1 节用折线图展示法国几十年人名(Marie / Jean / Camille)的使用频率变化。
原始页面附带"词云 + 鼠标高亮 + 时间段筛选",但代码只给了关键折线段。

概念与方法

  • 标准时序图本质:二维线图,x = 时间,y = 度量。优势是在线性时间域中的变化趋势一目了然。
  • 缺点:难以表达周期性——所以才有了 5.3 日历图和 5.4 螺旋图。
  • 交互:鼠标 hover 高亮、tip 显示、筛选时间段——是数据新闻标配。
  • 连接方式:linear 保留相邻观测之间的直线连接;monotoneX 和 Catmull–Rom 使用不同插值约束。选择要看时间顺序、采样间隔和读图任务,不能只按 50 或 500 个点划线;大量数据可考虑聚合、分面或细节视图。

02动手实验

试一试:切换系列,比较峰值出现的时间和趋势。先阅读数据说明,再解释图形。

实验将在进入此区域时加载,需要启用 JavaScript。

此处数据用于教学演示,不据此作真实人口、气候或电影时间点推断。

做完后:你应该看到
切换系列能看到峰值时间和趋势差异,能说明数据边界,不把演示数据当事实。
03代码与讲解收起 / 展开 +

⭐ 关键代码

⭐ 关键点 1:d3.timeParse + d3.timeFormat 时间格式化

// 时间字符串 → Date 对象
const parseYear = d3.timeParse('%Y');        // '1965' → Date
// 时间 Date → 字符串
const formatYear = d3.timeFormat('%Y');     // Date → '1965'

// 典型 timeFormat tokens
//   %Y 4 位年    %y 2 位年
//   %m 月份 01-12   %B 月名 January
//   %d 日 01-31    %a 星期 Sun
//   %H 时 00-23    %M 分 00-59
//   %L 毫秒 000-999

⭐ d3-time 是 d3 的核心模块。d3.timeParse / timeFormat 处理任何时序数据必须先掌握——尤其 CSV 里年份是字符串"2024"而非 Date 对象。

⭐ 关键点 2:d3.scaleTime 时间轴

// 时间轴 = 数值轴的特化版(Date 在底层就是数字)
const xScale = d3.scaleTime()
  .domain([new Date(1900, 0, 1), new Date(2020, 11, 31)])
  .range([0, innerW]);
// d3.axisBottom 自动按"年/十年/世纪"切换 tick
svg.append('g')
  .attr('transform', `translate(${M.l},${M.t + innerH})`)
  .call(d3.axisBottom(xScale).ticks(10));

时间比例尺:scaleTime() 根据跨度选择本地日历刻度;需要 UTC 日期语义时,改用 d3.scaleUtc(),并搭配 UTC 解析和格式化函数。它没有一个用于切换时区的 .utc() 方法。

⭐ 关键点 3:hover 高亮 + tip

// 透明覆盖层捕获鼠标事件
const focus = svg.append('g').style('display', 'none');
focus.append('line')             // 垂直参考线
  .attr('class', 'hover-line')
  .attr('y1', 0).attr('y2', innerH);
focus.append('circle')           // 圆点
  .attr('r', 5).attr('fill', 'steelblue');
focus.append('text')             // tip
  .attr('class', 'tip');

svg.append('rect')               // 覆盖矩形
  .attr('width', innerW).attr('height', innerH)
  .attr('fill', 'none').attr('pointer-events', 'all')
  .on('mouseover', () => focus.style('display', null))
  .on('mouseout',  () => focus.style('display', 'none'))
  .on('mousemove', (event) => {
    const xm = d3.pointer(event)[0];
    const date = xScale.invert(xm - M.l);
    // bisect 找最近点
    const i = d3.bisector(d => d.year).left(series, date);
    const d = series[i];
    focus.attr('transform', `translate(${xScale(d.year)},0)`);
  });

⭐ 通用 hover 模板:透明矩形 + focus g(line + circle + text)。d3.bisector 找最近点比手写循环快且准。

04练习

比较两条折线的高低时,首先应该确认什么?

学完后,可以标记进度。

第 5 章 · 第 3 节 基础

5.3 日历热图

学习目标

将日期映射到星期与周,理解日历热图中的周期模式。

本节要点

  • 日历热图把日期映射到星期和周,颜色表达数值。
  • 适合发现周、月、季节周期,不适合精确比较单个点。
  • 颜色刻度、缺失日期和周起始日要说明。

01理解概念

案例

原 6.2.2 节用日历热图展示 2024 年北京每日最高温度。每月之间用红线分隔。

概念与方法

  • 日历热图(Calendar Heatmap):把日期排列为周与星期,颜色表示每日数值。横轴为周,纵轴为星期几;月份边界帮助定位日期。
  • 适用场景:长时序(年)+ 周期性(星期 / 月)+ 异常检测(节假日、工作日 vs 周末)。
  • 设计要点:
    • 每周从周日(或周一)开始——影响"周末"在视觉上的位置
    • 月份之间用红线分隔——比 7×53 网格更易读
    • colormap 用顺序型(如 Viridis)——见 第 3 章 3.2 colormap

isMonthDivider 的巧妙之处

判断 7 天前与今天是否同月——是则同月分割线,否则需要画月线。这是日历可视化的核心算法。

02动手实验

试一试:查看日历排列中的每一周,比较工作日和周末,并检查颜色对应的数值。

实验将在进入此区域时加载,需要启用 JavaScript。

此处数据用于教学演示,不据此作真实人口、气候或电影时间点推断。

做完后:你应该看到
能比较工作日和周末、不同周的模式,能根据图例读出颜色对应数值。
03代码与讲解收起 / 展开 +

⭐ 关键代码

⭐ 关键点 1:d3.timeDay.range + d3.timeFormat.isoDate

// 把"年"拆成"日"列表
const days = d3.timeDay.range(
  new Date(2024, 0, 1),         // 2024-01-01
  new Date(2025, 0, 1)          // 2025-01-01
).map(d => ({
  date:  d,
  value: byKey.get(d3.timeFormat('%Y-%m-%d')(d)) ?? 0
}));
// 现在 days.length === 366(2024 闰年)

⭐ d3.timeDay.range(start, stop) 是"日内连续性 + 结构性"两个属性的合击——自动按日粒度切分整年,闰年 366 / 平年 365 自动正确。

⭐ 关键点 2:周日为起点布局

function weekColSunday(date) {
  const start = d3.timeYear.floor(date);
  return d3.timeSunday.count(start, date);
}
function dayIndexSunday(date) {
  return date.getDay();            // 0=周日,6=周六
}

g.selectAll('rect.cell').data(days).join('rect')
  .attr('class', 'cell')
  .attr('width', cellSize).attr('height', cellSize)
  .attr('x', d => weekColSunday(d.date) * cellSize)
  .attr('y', d => dayIndexSunday(d.date) * cellSize)
  .attr('rx', 2).attr('ry', 2)
  .attr('fill', d => d.value == null ? '#e5e7eb' : color(d.value));

一周的起点:周日起点使用 timeSunday 和 getDay;周一起点可使用 timeMonday,并把行号改成 (getDay() + 6) % 7。两种布局都要统一列号与行号,不能直接用“年内第几天 ÷ 7”代替日历周。

⭐ 关键点 3:isMonthDivider 月份分隔

// 巧妙算法:判断 7 天前是否同月
function isMonthDivider(date) {
  const sevenDaysAgo = d3.timeDay.offset(date, -7);
  return date.getFullYear() !== sevenDaysAgo.getFullYear()
      || date.getMonth()    !== sevenDaysAgo.getMonth();
}
// 同月:不画分割线;跨月:画一条上边框

function isFirstDayOfMonth(date) {
  return date.getDay() !== 0         // 排除周日(被周列开头替代)
      && date.getMonth() > 0         // 排除一月(画上边框没意义)
      && date.getDate() === 1;
}

⭐ 不用循环"找每个月的第一天",改用"7 天前是否同月"——简洁又正确,O(n) 一遍扫描即可。这是日历热图作者 van Wijk 的精妙算法。

04练习

日历热图相对于普通折线图,常见优势是什么?

学完后,可以标记进度。

第 5 章 · 第 4 节 拓展

5.4 螺旋时间图

学习目标

解释角度与半径如何共同编码周期与时间推进。

本节要点

  • 螺旋用角度表示周期位置,用半径或圈数表示时间推进。
  • 同一角度的不同圈对应相同的周期位置。
  • 螺旋会牺牲部分精确比较,适合发现周期模式。

01理解概念

案例

原 6.2.3 节用阿基米德螺旋(等速螺旋)布局日期,每个回路代表 1 年 / 1 月 / 1 周。每个日期对应螺旋上的一个扇环。

概念与方法

  • 螺旋 vs 折线:折线在线性时间域表现"趋势",但难以表现"周期";螺旋沿圆周重复,能突出周期性。
  • 阿基米德螺旋:r = a + bθ,半径随角度线性增加,每转一圈增加 2πb。等弧长步长和固定周期对齐是两种不同的设计,不能同时假定每个固定宽度格都正好按月对齐。
  • 动态 Δθ 算法:实现中的关键点——Δθ = boxSize / √(b² + r²),让每个扇环的弧长近似相等,保持视觉一致性。
  • 实战取舍:螺旋适合"年/季节/周"的循环,不适合"无周期"或"周期太长"。

关键路径生成

每个日期对应螺旋上的一个扇环——4 个关键点:起点外/终点外/终点内/起点内,闭合回起点。

02动手实验

试一试:沿着螺旋追踪时间,比较相同角度的不同圈,找出周期对应关系。

实验将在进入此区域时加载,需要启用 JavaScript。

此处数据用于教学演示,不据此作真实人口、气候或电影时间点推断。

做完后:你应该看到
能沿螺旋追踪时间、找到同角度对应,并说明角度和半径各编码什么。
03代码与讲解收起 / 展开 +

⭐ 关键代码

⭐ 关键点 1:极坐标 → 笛卡尔坐标

// 阿基米德螺旋公式:r = a + bθ
const boxSize = 32;                  // 每环宽度
const coilGap = boxSize * 1.2;       // 螺旋间距
const b = coilGap / (2 * Math.PI);   // 半径增长系数
const startRadius = 100;
let theta = (startRadius - 0) / b;   // 起始角度

function pos(t) {                    // t: 角度(弧度)
  const r = 0 + b * t;
  return {
    x: r * Math.cos(t),              // 极坐标转笛卡尔
    y: r * Math.sin(t),
    r
  };
}

极坐标 (r, θ) 通过 x = r cosθ、y = r sinθ 转为平面坐标。对于 r = a + bθ,θ 每增加 2π,半径增加 2πb;所以令 b = coilGap / (2π),每圈恰好向外增加 coilGap。b = 0 时退化为圆。

⭐ 关键点 2:动态角度增量

// 弧长近似相等:Δθ = boxSize / √(b² + r²)
function angleDelta(currentRadius) {
  return boxSize / Math.sqrt(b * b + currentRadius * currentRadius);
}

// 沿螺旋前进 N 天
let t = startTheta;
for (let day = 0; day < 365; day++) {
  const p = pos(t);
  // ...画第 day 天的扇环
  t += angleDelta(p.r);   // 动态加角度
}

⭐ 这条公式的关键作用:当半径增大时,相同角度对应的弧长会变长,所以要让 Δθ 随半径增大而减小——这样"每个扇环的弧长"近似相等,视觉上整齐一致。

⭐ 关键点 3:扇环路径生成

// 4 关键点:起点外 → 终点外 → 终点内 → 起点内
function segmentPath(t0, t1) {
  const coords = (t, sign) => {
    const r = pos(t).r + sign * coilGap / 2;  // sign=+1 外圈 / -1 内圈
    return [r * Math.cos(t), r * Math.sin(t)];
  };
  const [x0o, y0o] = coords(t0, +1);
  const [x1o, y1o] = coords(t1, +1);
  const [x1i, y1i] = coords(t1, -1);
  const [x0i, y0i] = coords(t0, -1);
  return `M ${x0o} ${y0o} L ${x1o} ${y1o} L ${x1i} ${y1i} L ${x0i} ${y0i} Z`;
}
// d 属性 = 'M ... L ... L ... L ... Z',4 个 L 描述一个 4 边形

⭐ SVG path 极简:M 移动、L 画线、Z 闭合。手算 4 顶点比用 d3.arc() 灵活(d3.arc 是从圆弧角度算的,对螺旋无法直接用)。

04练习

周期螺旋中,相同角度、不同圈的点通常适合比较什么?

学完后,可以标记进度。

第 5 章 · 第 5 节 拓展

5.5 故事线与事件关系

学习目标

理解故事线中横轴、角色轨迹与相遇关系的编码语义。

本节要点

  • 故事线横轴是时间,纵向轨迹表示角色或对象,交叉表示相遇。
  • 直线或平滑连接会影响关系感知,事件标签提供上下文。
  • 角色多时会拥挤,需要筛选、高亮或直接标签。

01理解概念

案例

原 6.2.4 节用《侏罗纪公园》5 个角色(Alan / T-REX / Raptors / Malcolm / Dilophosaurus)做 Storyline 时间线。事件层用红色半透明圆圈标注关键冲突。

概念与方法

  • Storyline:用随时间延伸的角色线表达人物、组织或进程之间的聚散关系。相关研究包括 Ogawa 与 Ma 等人的故事线工作。本节保留《侏罗纪公园》案例,时间点与纵向位置用于讲解布局,不作为影片逐帧标注。
  • 核心:把每个角色/组织/进程抽象为"生命线",线靠近 = 角色相遇 / 冲突,线分开 = 角色分离。
  • 3 大元素:
    1. 时间尺度映射:电影时长 → SVG 宽度,x 轴严格按比例对齐
    2. Catmull–Rom:curveCatmullRom.alpha(0.5) 使用向心参数化,按控制点生成平滑线;alpha 不是 tension。
    3. 事件层:半透明红圈 + 文字,标注关键转折点
  • 应用场景:电影分析、案件多人时间线、体育比赛互动、项目任务交接。

为什么 Catmull-Rom 不用 monotoneX?

monotoneX 保持各数据点之间的单调性,Catmull–Rom 按控制点与 alpha 参数生成曲线。两者都应检查回折、交叉和遮挡;叙事布局可比较不同曲线,科学数据则应按数据含义选择连接方式。

02动手实验

试一试:选择角色,比较直线与平滑连接。查看三个事件,核对时间和相关角色。

实验将在进入此区域时加载,需要启用 JavaScript。

此处数据用于教学演示,不据此作真实人口、气候或电影时间点推断。

做完后:你应该看到
选择角色能追踪轨迹和两次相遇,能核对事件时间和相关角色。
03代码与讲解收起 / 展开 +

⭐ 关键代码

⭐ 关键点 1:每个角色 = 一条 path

// 时间尺度:0-127 分钟 → 屏幕宽度
const xScale = d3.scaleLinear()
  .domain([0, 127])
  .range([50, width - 50]);

// 每个角色是一组 [time, y] 关键点(手工调 y 实现聚散)
const characters = [
  { name: 'T-REX', color: '#d32f2f', points: [
    {time: 75, y: 280}, {time: 78, y: 130},   // 攻击现场
    {time: 88, y: 200}, {time:120, y: 290}
  ]},
  { name: 'Grant', color: '#1976d2', points: [
    {time:  0, y: 100}, {time: 78, y: 130},   // 与 T-REX 聚拢
    {time:120, y:  50}
  ]}
];

// 路径生成器
const line = d3.line()
  .curve(d3.curveCatmullRom.alpha(0.5))   // 向心参数化 alpha=0.5
  .x(d => xScale(d.time))
  .y(d => d.y);

characters.forEach(c => {
  svg.append('path')
    .datum(c.points)
    .attr('d', line)
    .attr('stroke', c.color)
    .attr('stroke-width', 3)
    .attr('fill', 'none');
});

⭐ 用 y 值表达"关系"是关键:T-REX 和 Grant 在 t=78 都画到 y=130,视觉上两条线聚拢= "T-REX 攻击 Grant"。这不是算法生成,是手工叙事设计——但 d3 提供工具让你能这样手工做。

⭐ 关键点 2:事件层(叙事锚点)

// 事件层:半透明红圈 + 文字标签
const events = [
  { time: 78, x: xScale(78), y: 130, name: 'T-REX 攻击',
    desc: 'T-REX 冲出围栏攻击 Alan & Kids 的车' },
  { time: 48, x: xScale(48), y: 320, name: 'Nedry 事件',
    desc: 'Dilophosaurus 攻击 Nedry' }
];

const eventLayer = svg.append('g').attr('class', 'event-layer');

eventLayer.selectAll('g.event')
  .data(events).enter().append('g')
  .attr('class', 'event')
  .style('cursor', 'pointer')
  .on('mouseenter', (e, d) => showTip(`${d.name}\n${d.desc}`))
  .each(function (d) {
    // 半透明背景圈
    d3.select(this).append('circle')
      .attr('cx', d.x).attr('cy', d.y).attr('r', 20)
      .attr('fill', 'rgba(255,0,0,0.15)');
    // 文字
    d3.select(this).append('text')
      .attr('x', d.x).attr('y', d.y - 9)
      .attr('text-anchor', 'middle')
      .attr('font-size', 10).attr('font-weight', 600)
      .attr('fill', '#cc0000')
      .text(d.name);
  });

⭐ 事件层与线层解耦:线层表达"关系流动",事件层表达"叙事锚点"。这种双层结构是 Storyline 的标准设计——可分别动画、可独立筛选。

⭐ 关键点 3:alpha(0.5) 参数化系数

// alpha 是 Catmull–Rom 的参数化系数,不是 tension(张力)
// alpha=0   :均匀参数化,等价于 tension=0 的 Cardinal 样条
// alpha=0.5 :向心参数化(D3 默认值)
// alpha=1   :弦长参数化
d3.line().curve(d3.curveCatmullRom.alpha(0.5));

alpha 的含义:0、0.5、1 分别对应均匀、向心和弦长参数化,不是“直线到高度弯曲”的滑块。D3 默认使用 0.5;仍需检查曲线有无误导性的交叉、回折和遮挡。科学数据应按分析目标选择插值或模型,不能按“故事感”指定参数。

04练习

故事线中两条线靠近,通常表达什么?

学完后,可以标记进度。

搜索课程

搜索全部 27 个小节的讲解与代码。