chart = {
// 设置一些关于尺寸的参数
const width = 928; // svg 元素的宽
const height = 600; // svg 元素的高
// margin 为前缀的参数
// 其作用是在 svg 的外周留白，构建一个显示的安全区，以便在四周显示坐标轴
const marginTop = 20;
const marginRight = 20;
const marginBottom = 30;
const marginLeft = 30;
/**
*
* 构建比例尺
*
*/
// 设置横坐标轴的比例尺
// 横坐标轴的数据是日期（时间），使用 d3.scaleUtc 构建一个时间比例尺（连续型比例尺的一种）
// 该时间比例尺采用协调世界时 UTC，处于不同时区的用户也会显示同样的时间
// 具体可以参考官方文档 https://d3js.org/d3-scale/time
// 或这一篇笔记 https://datavis-note.benbinbin.com/article/d3/core-concept/d3-concept-scale#时间比例尺-time-scales
const x = d3.scaleTime()
// 设置定义域范围
// 从数据集的每个数据点中提取出日期（时间），并用 d3.extent() 计算出它的范围
.domain(d3.extent(data, d => d.date))
// 设置值域范围（所映射的可视元素）
// svg 元素的宽度（减去留白区域）
.range([marginLeft, width - marginRight]);
// 设置纵坐标轴的比例尺
// 纵坐标轴的数据是连续型的数值（温度），使用 d3.scaleLinear 构建一个线性比例尺
const y = d3.scaleLinear()
// 设置定义域范围 [ymin, ymax]
// 其中 ymin 是最低温度，先通过 Math.min(d.value0, d.value1) 对每个数据点进行处理，提取出当天两个城市中较低的值
// 然后通过 d3.min() 从数据集中获取温度的最低值
// 相应地 ymax 就是最高温度
.domain([
d3.min(data, d => Math.min(d.value0, d.value1)),
d3.max(data, d => Math.max(d.value0, d.value1))
])
// 设置值域范围
// svg 元素的高度（减去留白区域）
.range([height - marginBottom, marginTop]);
// 设置颜色比例尺
// 为不同的面积区域设置不同的颜色，以对应数据的不同（差异）关系
// 只有两种情况：其中一种情况是当天温度纽约高于三藩市；另一种情况是当前温度三藩市高于纽约
// 所以只需要提供两种颜色进行映射对照
// 这里使用 D3 内置的一种配色方案 d3.schemeRdYlBu（它属于 Diverging schemes 离散型的配色方案，用于明显地区分不同的类型）
// 它是一个嵌套数组，包含一些预设的配色方案（共 9 种对色谱采样的方式）
// 具体可以查看 👇 下面第一个 📝 cell 或参考官方文档 https://d3js.org/d3-scale-chromatic/diverging#schemeRdYlBu
// 这里采用第三个配色方案 d3.schemeRdYlBu[3] 它也是一个数组，包含 3 个元素，每个元素都是一个表示颜色的字符串
// 具体可以查看 👇👇 下面第二个 📝 cell
// d3.schemeRdYlBu[3][2] 获取一种颜色（#91bfdb 浅蓝色），d3.schemeRdYlBu[3][0] 获取另一种颜色（#fc8d59 橙色），它们分别用于映射对照不同的数据（差异）关系
const colors = [d3.schemeRdYlBu[3][2], d3.schemeRdYlBu[3][0]];
/**
*
* 创建 svg 容器
*
*/
// 返回的是一个包含 svg 元素的选择集
const svg = d3.create("svg")
.attr("viewBox", [0, 0, width, height])
.attr("style", "max-width: 100%; height: auto; font: 10px sans-serif;")
// 绑定数据
// 这里采用 selection.datum(value) 为选择集中的每个元素上绑定的数据（该选择集里只有一个 <svg> 元素）
// ⚠️ 它与 selection.data(value) 不同，该方法不会将数组进行「拆解」
// 即这个方法不会进行数据与元素的一一链接计算，并且不影响索引，不影响（不产生）enter 和 exit 选择集
// 而是将数据 value 作为一个整体绑定到选择的各个元素上，因此使用该方法选择集的所有 DOM 元素绑定的数据都一样
// 具体参考官方文档 https://d3js.org/d3-selection/joining#selection_datum
// 或这一篇笔记 https://datavis-note.benbinbin.com/article/d3/module-api/d3-module-selection#绑定数据
.datum(data);
/**
*
* 绘制坐标轴
*
*/
// 绘制横坐标轴
svg.append("g")
// 通过设置 CSS 的 transform 属性将横坐标轴容器「移动」到底部
.attr("transform", `translate(0,${height - marginBottom})`)
// 横轴是一个刻度值朝下的坐标轴
.call(d3.axisBottom(x)
// 通过 axis.ticks(count) 设置刻度数量的参考值（避免刻度过多导致刻度值重叠而影响图表的可读性）
.ticks(width / 80)
// 而且将坐标轴的外侧刻度 tickSizeOuter 长度设置为 0（即取消坐标轴首尾两端的刻度）
.tickSizeOuter(0))
// 删掉上一步所生成的坐标轴的轴线（它含有 domain 类名）
.call(g => g.select(".domain").remove());
// 💡 注意以上使用的是方法 selection.call(axis) 的方式来调用坐标轴对象（方法）
// 会将选择集中的元素 <g> 传递给坐标轴对象的方法，作为第一个参数
// 以便将坐标轴在相应容器内部渲染出来
// 具体参考官方文档 https://d3js.org/d3-selection/control-flow#selection_call
// 或这一篇文档 https://datavis-note.benbinbin.com/article/d3/core-concept/d3-concept-data-binding#其他方法
// 绘制纵坐标轴
svg.append("g")
// 通过设置 CSS 的 transform 属性将纵向坐标轴容器「移动」到左侧
.attr("transform", `translate(${marginLeft},0)`)
// 纵轴是一个刻度值朝左的坐标轴
// 通过 axis.ticks(count) 设置刻度数量的参考值（避免刻度过多导致刻度值重叠而影响图表的可读性）
.call(d3.axisLeft(y))
// 删掉上一步所生成的坐标轴的轴线（它含有 domain 类名）
.call(g => g.select(".domain").remove())
// 复制了一份刻度线，用以绘制图中横向的网格参考线
.call(g => g.selectAll(".tick line").clone()
// 调整复制后的刻度线的终点位置（往右移动）
.attr("x2", width - marginLeft - marginRight)
.attr("stroke-opacity", 0.1)) // 调小参考线的透明度
// 为纵坐标轴添加标注信息
// 并选中最后一个刻度值，即 <text> 元素，进行复制
.call(g => g.select(".tick:last-of-type text").clone()
.attr("x", -marginLeft) // 设置元素的偏移量
.attr("y", -30)
.attr("fill", "currentColor") // 设置文字的颜色
.attr("text-anchor", "start") // 设置文字的对齐方式
.text("↑ Temperature (°F)")); // 设置文本内容
/**
*
* 绘制面积图内的面积形状
*
*/
// 绘制表示橙色的面积图（三藩市的温度高于纽约），面积图的上边界是三藩市的温度，下边界是纽约的温度，填充色为橙色
// 而对于三藩市低于纽约的日子，则不绘制面积图（可以将这段时间的面积图的下边界也设定为三藩市的温度，则该时间段的面积图绘制为一条线，再将折线的描边设置为透明即可）
svg.append("path") // 使用路径 <path> 元素绘制面积形状
.attr("fill", colors[1]) // 设置填充颜色为橙色
// 使用方法 d3.area() 创建一个面积生成器，它会根据给定的数据（svg 所绑定的数据）设置 <path> 路径形状
.attr("d", d3.area()
// 设置两点之间的曲线插值器
.curve(d3.curveStep)
// 设置下边界线横坐标读取函数
.x(d => x(d.date))
// 设置下边界线的纵坐标的读取函数，它始终是 height（即位于 svg 的底部位置，即横坐标轴）
.y0(d => d.value0 > d.value1 ? y(d.value1) : y(d.value0))
// 设置上边界线的纵坐标的读取函数，基于 d.value0 三藩市的温度，并采用比例尺 y 进行映射，得到纵坐标轴在 svg 中的坐标位置
.y1(d => y(d.value0)));
// 绘制表示浅蓝色的面积图（三藩市的温度低纽约），面积图的上边界是纽约的温度，下边界是三藩市的温度，填充色为浅蓝色
// 而对于三藩市高于纽约的日子，则不绘制面积图（可以将这段时间的面积图的下边界也设定为纽约的温度，则该时间段的面积图绘制为一条线，再将折线的描边设置为透明即可）
svg.append("path") // 使用路径 <path> 元素绘制面积形状
.attr("fill", colors[0]) // 设置填充颜色为浅蓝色
// 使用方法 d3.area() 创建一个面积生成器，它会根据给定的数据（svg 所绑定的数据）设置 <path> 路径形状
.attr("d", d3.area()
// 设置两点之间的曲线插值器
.curve(d3.curveStep)
// 设置下边界线横坐标读取函数
.x(d => x(d.date))
// 设置下边界线的纵坐标的读取函数，它始终是 height（即位于 svg 的底部位置，即横坐标轴）
.y0(d => d.value0 > d.value1 ? y(d.value1) : y(d.value0))
// 设置上边界线的纵坐标的读取函数，基于 d.value1 纽约的温度，并采用比例尺 y 进行映射，得到纵坐标轴在 svg 中的坐标位置
.y1(d => y(d.value1)));
// 绘制一条黑色的线，表示三藩市的温度随时间的变化
svg.append("path") // 使用路径 <path> 元素绘制折线
.attr("fill", "none") // 由于折线不需要填充颜色，所以属性 fill 设置为 none
.attr("stroke", "black") // 设置折线的描边颜色为黑色
.attr("stroke-width", 1.5) // 设置描边的宽度
.attr("stroke-linejoin", "round") //
.attr("stroke-linecap", "round") // 设置折线之间的连接样式（圆角让连接更加平滑）
// 使用方法 d3.line() 创建一个线段生成器，线段生成器会基于给定的数据（svg 所绑定的数据）生成线段（或曲线）
// 调用线段生成器时返回的结果，会基于生成器是否设置了画布上下文 context 而不同。如果设置了画布上下文 context，则生成一系列在画布上绘制路径的方法，通过调用它们可以将路径绘制到画布上；如果没有设置画布上下文 context，则生成字符串，可以作为 `<path>` 元素的属性 `d` 的值
// 具体可以参考官方文档 https://d3js.org/d3-shape/line 或 https://github.com/d3/d3-shape/tree/main#lines
// 或这一篇笔记 https://datavis-note.benbinbin.com/article/d3/core-concept/d3-concept-shape#线段生成器-lines
.attr("d", d3.line()
// 设置两点之间的曲线插值器
.curve(d3.curveStep)
// 该函数会在调用线段生成器时，为数组中的每一个元素都执行一次横坐标读取函数和纵坐标读取函数，以返回该数据所对应的横纵坐标值
// 设置横坐标读取函数
// 这里基于每个数据点的日期（时间）d.date 并采用比例尺 x 进行映射，计算出相应的横坐标
.x(d => x(d.date))
// 设置纵坐标读取函数
// 这里基于每个数据点的三藩市的温度 d.value0 并采用比例尺 y 进行映射，计算出相应的纵坐标
.y(d => y(d.value0)));
// 绘制一条绿色的线，表示纽约的温度随时间的变化
// svg.append("path")
// .attr("fill", "none")
// .attr("stroke", "green")
// .attr("stroke-width", 1.5)
// .attr("stroke-linejoin", "round")
// .attr("stroke-linecap", "round")
// .attr("d", d3.line()
// .curve(d3.curveStep)
// .x(d => x(d.date))
// .y(d => y(d.value1)));
return svg.node();
}
// 📝 该 cell 只是用于演示效果
// d3.schemeRdYlBu 是 D3 内置的一种配色方案，具体包含了 9 种对色谱进行采样方式
// 可以通过 d3.schemeRdYlBu[k] 获取具体的配色方案（⚠️ 注意该数组前三个元素为空，所以 k 的合理取值范围是 3 到 11）
d3.schemeRdYlBu
// 📝 该 cell 只是用于演示效果
d3.schemeRdYlBu[3]
colors = [d3.schemeRdYlBu[3][2], d3.schemeRdYlBu[3][0]];
// 读取 tsv 文件并进行转换处理
data = {
// 创建一个时间解释器 parser，可以将特定格式的字符串解析为时间对象 Date
// 具体参考 d3-time-format 模块的官方文档 https://d3js.org/d3-time-format
// 或这一篇笔记 https://datavis-note.benbinbin.com/article/d3/core-concept/d3-concept-data-process#时间格式器
// 参数 `%Y%m%d` 称为 specifier 时间格式说明符，这里用于匹配的字符串格式是「年月日」
// %Y 表示年份（用四个数字表示）
// %m 表示月份（用两个数字表示，不足双位数的月份在前面添加 0 来补足）
// %d 表示日期（用两个数字表示，不足的双位数的日期在前面添加 0 来补足）
const parseDate = d3.timeParse("%Y%m%d");
// 使用方法 d3.tsvParse(string, row) 解析分隔符为 \t 的 DSV 数据（具有表头信息），返回一个可迭代对象（对象数组）
// 第一个参数 string 是需要解析的数据。具有表头，即表格的第一行是各列的名称（而不是具体的数据项）
// 第二个参数 row 是一个函数，用于对行数据进行转换或筛选，从第二行开始的数据项均会调用该函数，并依次传入 2 个参数：
// * d 是当前所遍历的数据项（当前的行数据）
// * i 是当前所遍历的数据项的索引，从 0 开始计算
// 这里经过转换最后得到一个对象数组，即数组的每个元素都是一个对象（表示原始表格中的一行，数据项），每个对象都具有三个属性 date 表示日期，value0 表示三藩市当天的温度，value1 表示纽约当天的温度
return d3.tsvParse(await FileAttachment("weather.tsv").text(), d => ({
date: parseDate(d.date), // 将原始的表示日期的字符串转换为 Date 对象
value0: +d["San Francisco"], // 三藩市的当天的温度（通过 + 将字符串转换为数值）
value1: +d["New York"] // 纽约的当天温度
}));
}
Purpose-built for displays of data
Observable is your go-to platform for exploring data and creating expressive data visualizations. Use reactive JavaScript notebooks for prototyping and a collaborative canvas for visual data exploration and dashboard creation.
