data | design | journalism
Public
Edited
Apr 12, 2022
chart = BeeswarmChart(birds, {
x: d => d.days_advance,
xLabel: "Days later →",
title: d => d.common_name,
width,
annotations
})
annotations = [({
"text": "↓ key springtime birds in the Chicago area",
"x": 20,
"y": 90
})]
birds_url = 'https://docs.google.com/spreadsheets/d/e/2PACX-1vTJBBluy_fTT17WfGim--6HS0s_32ozMc-24s9ocfoMrBgLrYky-8Ws2yf_5Dap6DbJY_ORoRWq5pyE/pub?gid=2010147553&single=true&output=csv'
birds = d3.csv(birds_url, d3.autoType)
// Copyright 2021 Observable, Inc.
// Released under the ISC license.
// https://observablehq.com/@d3/mirrored-beeswarm
function BeeswarmChart(data, {
value = d => d, // convience alias for x
label, // convenience alias for xLabel
domain, // convenience alias for xDomain
x = value, // given d in data, returns the quantitative x value
title = null, // given d in data, returns the title
radius = 20, // (fixed) radius of the circles
padding = 1.5, // (fixed) padding between the circles
marginTop = 10, // top margin, in pixels
marginRight = 20, // right margin, in pixels
marginBottom = 30, // bottom margin, in pixels
marginLeft = 20, // left margin, in pixels
width = 640, // outer width, in pixels
height, // outer height, in pixels
xLabel = label, // a label for the x-axis
xDomain = [-51,14], // [xmin, xmax]
xRange = [marginLeft, width - marginRight], // [left, right]
annotations
} = {}) {
// Compute values.
const X = d3.map(data, x);
const T = title == null ? null : d3.map(data, title);
// Compute which data points are considered defined.
const I = d3.range(X.length).filter(i => !isNaN(X[i]));
// Compute default domains.
if (xDomain === undefined) xDomain = d3.extent(X);
// Construct scales and axes.
const xScale = d3.scaleLinear(xDomain, xRange);
const xAxis = d3.axisBottom(xScale).tickSizeOuter(0);
// Compute the y-positions.
const Y = dodge(I.map(i => xScale(X[i])), radius * 2 + padding);
// Compute the default height;
if (height === undefined) height = (d3.max(Y, Math.abs) + radius + padding) * 2 + marginTop + marginBottom;
// Given an array of x-values and a separation radius, returns an array of y-values.
function dodge(X, radius) {
const Y = new Float64Array(X.length);
const radius2 = radius ** 2;
const epsilon = 1e-3;
let head = null, tail = null;
// Returns true if circle ⟨x,y⟩ intersects with any circle in the queue.
function intersects(x, y) {
let a = head;
while (a) {
const ai = a.index;
if (radius2 - epsilon > (X[ai] - x) ** 2 + (Y[ai] - y) ** 2) return true;
a = a.next;
}
return false;
}
// Place each circle sequentially.
for (const bi of d3.range(X.length).sort((i, j) => X[i] - X[j])) {
// Remove circles from the queue that can’t intersect the new circle b.
while (head && X[head.index] < X[bi] - radius2) head = head.next;
// Choose the minimum non-intersecting tangent.
if (intersects(X[bi], Y[bi] = 0)) {
let a = head;
Y[bi] = Infinity;
do {
const ai = a.index;
let y1 = Y[ai] + Math.sqrt(radius2 - (X[ai] - X[bi]) ** 2);
let y2 = Y[ai] - Math.sqrt(radius2 - (X[ai] - X[bi]) ** 2);
if (Math.abs(y1) < Math.abs(Y[bi]) && !intersects(X[bi], y1)) Y[bi] = y1;
if (Math.abs(y2) < Math.abs(Y[bi]) && !intersects(X[bi], y2)) Y[bi] = y2;
a = a.next;
} while (a);
}
// Add b to the queue.
const b = {index: bi, next: null};
if (head === null) head = tail = b;
else tail = tail.next = b;
}
return Y;
}
const svg = d3.create("svg")
.attr("width", width)
.attr("height", height)
.attr("viewBox", [0, 0, width, height])
.attr("style", "max-width: 100%; height: auto; height: intrinsic;");
svg.append("g")
.attr("transform", `translate(0,${height - marginBottom})`)
.call(xAxis)
.call(g => g.append("text")
.attr("x", width)
.attr("y", marginBottom - 4)
.attr("fill", "currentColor")
.attr("text-anchor", "end")
.text(xLabel));
var defs = svg.append('svg:defs');
data.forEach(function(d, i) {
defs.append("svg:pattern")
.attr("id", "avatar" + i)
.attr("width", radius * 2)
.attr("height", radius * 2)
.attr("patternUnits", "objectBoundingBox")
.append("svg:image")
.attr("xlink:href", d.img_url)
.attr("width", radius * 2)
.attr("height", radius * 2)
.attr("x", 0)
.attr("y", 0);
const dot = svg.append("g")
.selectAll("circle")
.data(I)
.join("circle")
.attr("cx", i => xScale(X[i]))
.attr("cy", i => (marginTop + height - marginBottom) / 2 + Y[i])
.attr("r", radius)
.attr("stroke", i => {
if (data[i].highlight == "Yes") {
return '#5f2b7b';
} else {
return NaN;
}})
.attr("stroke-width", i => {
if (data[i].highlight == "Yes") {
return 2;
} else {
return NaN;
}})
.attr("fill", i => "url(#avatar" + i + ")");
if (T) dot.append("title")
.text(i => T[i]);
});
if (annotations) {
for (let annotation of annotations) {
svg.append("text")
.attr("x", annotation.x)
.attr("y", annotation.y)
.text(annotation.text)
.style("font-size", 12)
}
}
return svg.node();
}
import {howto} from "@d3/example-components"
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.
