@fundar/data-chart-telling 1.1.0 → 1.2.0

package/examples/datasets/iris-flower.ts

@@ -0,0 +1,207 @@
+// ── Iris flowers ────────────────────────────────────────────────────────────
+// Ronald Fisher's iris data (1936): 50 flowers of each of three species, as
+// distributed by the UCI Machine Learning Repository, via mwaskom/seaborn-data.
+// Lengths and widths in centimeters.
+
+export type IrisRow = {
+	species: string;
+	sepalLength: number;
+	sepalWidth: number;
+	petalLength: number;
+	petalWidth: number;
+};
+
+/** Per species, one `[sepalLength, sepalWidth, petalLength, petalWidth]` per flower. */
+const IRIS_MEASUREMENTS = [
+	{
+		species: 'setosa',
+		measurements: [
+			[5.1, 3.5, 1.4, 0.2],
+			[4.9, 3, 1.4, 0.2],
+			[4.7, 3.2, 1.3, 0.2],
+			[4.6, 3.1, 1.5, 0.2],
+			[5, 3.6, 1.4, 0.2],
+			[5.4, 3.9, 1.7, 0.4],
+			[4.6, 3.4, 1.4, 0.3],
+			[5, 3.4, 1.5, 0.2],
+			[4.4, 2.9, 1.4, 0.2],
+			[4.9, 3.1, 1.5, 0.1],
+			[5.4, 3.7, 1.5, 0.2],
+			[4.8, 3.4, 1.6, 0.2],
+			[4.8, 3, 1.4, 0.1],
+			[4.3, 3, 1.1, 0.1],
+			[5.8, 4, 1.2, 0.2],
+			[5.7, 4.4, 1.5, 0.4],
+			[5.4, 3.9, 1.3, 0.4],
+			[5.1, 3.5, 1.4, 0.3],
+			[5.7, 3.8, 1.7, 0.3],
+			[5.1, 3.8, 1.5, 0.3],
+			[5.4, 3.4, 1.7, 0.2],
+			[5.1, 3.7, 1.5, 0.4],
+			[4.6, 3.6, 1, 0.2],
+			[5.1, 3.3, 1.7, 0.5],
+			[4.8, 3.4, 1.9, 0.2],
+			[5, 3, 1.6, 0.2],
+			[5, 3.4, 1.6, 0.4],
+			[5.2, 3.5, 1.5, 0.2],
+			[5.2, 3.4, 1.4, 0.2],
+			[4.7, 3.2, 1.6, 0.2],
+			[4.8, 3.1, 1.6, 0.2],
+			[5.4, 3.4, 1.5, 0.4],
+			[5.2, 4.1, 1.5, 0.1],
+			[5.5, 4.2, 1.4, 0.2],
+			[4.9, 3.1, 1.5, 0.2],
+			[5, 3.2, 1.2, 0.2],
+			[5.5, 3.5, 1.3, 0.2],
+			[4.9, 3.6, 1.4, 0.1],
+			[4.4, 3, 1.3, 0.2],
+			[5.1, 3.4, 1.5, 0.2],
+			[5, 3.5, 1.3, 0.3],
+			[4.5, 2.3, 1.3, 0.3],
+			[4.4, 3.2, 1.3, 0.2],
+			[5, 3.5, 1.6, 0.6],
+			[5.1, 3.8, 1.9, 0.4],
+			[4.8, 3, 1.4, 0.3],
+			[5.1, 3.8, 1.6, 0.2],
+			[4.6, 3.2, 1.4, 0.2],
+			[5.3, 3.7, 1.5, 0.2],
+			[5, 3.3, 1.4, 0.2]
+		]
+	},
+	{
+		species: 'versicolor',
+		measurements: [
+			[7, 3.2, 4.7, 1.4],
+			[6.4, 3.2, 4.5, 1.5],
+			[6.9, 3.1, 4.9, 1.5],
+			[5.5, 2.3, 4, 1.3],
+			[6.5, 2.8, 4.6, 1.5],
+			[5.7, 2.8, 4.5, 1.3],
+			[6.3, 3.3, 4.7, 1.6],
+			[4.9, 2.4, 3.3, 1],
+			[6.6, 2.9, 4.6, 1.3],
+			[5.2, 2.7, 3.9, 1.4],
+			[5, 2, 3.5, 1],
+			[5.9, 3, 4.2, 1.5],
+			[6, 2.2, 4, 1],
+			[6.1, 2.9, 4.7, 1.4],
+			[5.6, 2.9, 3.6, 1.3],
+			[6.7, 3.1, 4.4, 1.4],
+			[5.6, 3, 4.5, 1.5],
+			[5.8, 2.7, 4.1, 1],
+			[6.2, 2.2, 4.5, 1.5],
+			[5.6, 2.5, 3.9, 1.1],
+			[5.9, 3.2, 4.8, 1.8],
+			[6.1, 2.8, 4, 1.3],
+			[6.3, 2.5, 4.9, 1.5],
+			[6.1, 2.8, 4.7, 1.2],
+			[6.4, 2.9, 4.3, 1.3],
+			[6.6, 3, 4.4, 1.4],
+			[6.8, 2.8, 4.8, 1.4],
+			[6.7, 3, 5, 1.7],
+			[6, 2.9, 4.5, 1.5],
+			[5.7, 2.6, 3.5, 1],
+			[5.5, 2.4, 3.8, 1.1],
+			[5.5, 2.4, 3.7, 1],
+			[5.8, 2.7, 3.9, 1.2],
+			[6, 2.7, 5.1, 1.6],
+			[5.4, 3, 4.5, 1.5],
+			[6, 3.4, 4.5, 1.6],
+			[6.7, 3.1, 4.7, 1.5],
+			[6.3, 2.3, 4.4, 1.3],
+			[5.6, 3, 4.1, 1.3],
+			[5.5, 2.5, 4, 1.3],
+			[5.5, 2.6, 4.4, 1.2],
+			[6.1, 3, 4.6, 1.4],
+			[5.8, 2.6, 4, 1.2],
+			[5, 2.3, 3.3, 1],
+			[5.6, 2.7, 4.2, 1.3],
+			[5.7, 3, 4.2, 1.2],
+			[5.7, 2.9, 4.2, 1.3],
+			[6.2, 2.9, 4.3, 1.3],
+			[5.1, 2.5, 3, 1.1],
+			[5.7, 2.8, 4.1, 1.3]
+		]
+	},
+	{
+		species: 'virginica',
+		measurements: [
+			[6.3, 3.3, 6, 2.5],
+			[5.8, 2.7, 5.1, 1.9],
+			[7.1, 3, 5.9, 2.1],
+			[6.3, 2.9, 5.6, 1.8],
+			[6.5, 3, 5.8, 2.2],
+			[7.6, 3, 6.6, 2.1],
+			[4.9, 2.5, 4.5, 1.7],
+			[7.3, 2.9, 6.3, 1.8],
+			[6.7, 2.5, 5.8, 1.8],
+			[7.2, 3.6, 6.1, 2.5],
+			[6.5, 3.2, 5.1, 2],
+			[6.4, 2.7, 5.3, 1.9],
+			[6.8, 3, 5.5, 2.1],
+			[5.7, 2.5, 5, 2],
+			[5.8, 2.8, 5.1, 2.4],
+			[6.4, 3.2, 5.3, 2.3],
+			[6.5, 3, 5.5, 1.8],
+			[7.7, 3.8, 6.7, 2.2],
+			[7.7, 2.6, 6.9, 2.3],
+			[6, 2.2, 5, 1.5],
+			[6.9, 3.2, 5.7, 2.3],
+			[5.6, 2.8, 4.9, 2],
+			[7.7, 2.8, 6.7, 2],
+			[6.3, 2.7, 4.9, 1.8],
+			[6.7, 3.3, 5.7, 2.1],
+			[7.2, 3.2, 6, 1.8],
+			[6.2, 2.8, 4.8, 1.8],
+			[6.1, 3, 4.9, 1.8],
+			[6.4, 2.8, 5.6, 2.1],
+			[7.2, 3, 5.8, 1.6],
+			[7.4, 2.8, 6.1, 1.9],
+			[7.9, 3.8, 6.4, 2],
+			[6.4, 2.8, 5.6, 2.2],
+			[6.3, 2.8, 5.1, 1.5],
+			[6.1, 2.6, 5.6, 1.4],
+			[7.7, 3, 6.1, 2.3],
+			[6.3, 3.4, 5.6, 2.4],
+			[6.4, 3.1, 5.5, 1.8],
+			[6, 3, 4.8, 1.8],
+			[6.9, 3.1, 5.4, 2.1],
+			[6.7, 3.1, 5.6, 2.4],
+			[6.9, 3.1, 5.1, 2.3],
+			[5.8, 2.7, 5.1, 1.9],
+			[6.8, 3.2, 5.9, 2.3],
+			[6.7, 3.3, 5.7, 2.5],
+			[6.7, 3, 5.2, 2.3],
+			[6.3, 2.5, 5, 1.9],
+			[6.5, 3, 5.2, 2],
+			[6.2, 3.4, 5.4, 2.3],
+			[5.9, 3, 5.1, 1.8]
+		]
+	}
+];
+
+export const IRIS: IrisRow[] = IRIS_MEASUREMENTS.flatMap(({ species, measurements }) =>
+	measurements.map(([sepalLength, sepalWidth, petalLength, petalWidth]) => ({
+		species,
+		sepalLength,
+		sepalWidth,
+		petalLength,
+		petalWidth
+	}))
+);
+
+/** The four measurements, in the order the long form lists them. */
+export const IRIS_METRICS = ['Sepal length', 'Sepal width', 'Petal length', 'Petal width'] as const;
+
+/** One row per flower and measurement, for plots that put the measurements on one axis. */
+export type IrisMetricRow = { flower: string; species: string; metric: string; value: number };
+
+export const IRIS_LONG: IrisMetricRow[] = IRIS.flatMap(
+	({ species, sepalLength, sepalWidth, petalLength, petalWidth }, index) =>
+		[sepalLength, sepalWidth, petalLength, petalWidth].map((value, metricIndex) => ({
+			flower: `Flower ${index + 1}`,
+			species,
+			metric: IRIS_METRICS[metricIndex],
+			value
+		}))
+);

package/examples/datasets/life-expectancy.ts

@@ -0,0 +1,95 @@
+// ── Life expectancy at birth in Argentina, by sex ───────────────────────────
+// INDEC, life tables: the country over the years, and each province in 2019.
+
+import { PROVINCE_POPULATION_2022 } from './province-population';
+
+// ── Country, over the years ─────────────────────────────────────────────────
+// Each year stands for the period around it (1947 is 1946-1948, 2001 is
+// 2000-2001, ...).
+
+export type LifeRow = { year: number; sex: 'female' | 'male'; value: number };
+
+/** A life expectancy row that may have a missing value. */
+export type LifeRowWithGaps = Omit<LifeRow, 'value'> & { value: number | null };
+
+const LIFE_EXPECTANCY = [
+	{ year: 1947, female: 61.4, male: 56.9 },
+	{ year: 1965, female: 69.5, male: 63.3 },
+	{ year: 1972, female: 70.8, male: 64.1 },
+	{ year: 1980, female: 72.7, male: 65.5 },
+	{ year: 1991, female: 75.6, male: 68.4 },
+	{ year: 2001, female: 77.5, male: 70 },
+	{ year: 2009, female: 78.8, male: 72.1 },
+	{ year: 2019, female: 80.2, male: 74.4 }
+];
+
+export const LIFE: LifeRow[] = LIFE_EXPECTANCY.flatMap(({ year, female, male }) => [
+	{ year, sex: 'female', value: female },
+	{ year, sex: 'male', value: male }
+]);
+
+export const FEMALE_LIFE: LifeRow[] = LIFE.filter((row) => row.sex === 'female');
+
+export const MALE_LIFE: LifeRow[] = LIFE.filter((row) => row.sex === 'male');
+
+/** The female series with holes: the first year, one in the middle and the last. */
+export const FEMALE_LIFE_GAPS: LifeRowWithGaps[] = FEMALE_LIFE.map((row) =>
+	[1947, 1980, 2019].includes(row.year) ? { ...row, value: null } : row
+);
+
+/** The male series with a single hole, in a different place than the female one. */
+export const MALE_LIFE_GAPS: LifeRowWithGaps[] = MALE_LIFE.map((row) =>
+	row.year === 1991 ? { ...row, value: null } : row
+);
+
+// ── Provinces, 2019 ─────────────────────────────────────────────────────────
+// `population` is the 2022 census population (`province-population.ts`), in millions.
+
+export type ProvinceRow = {
+	province: string;
+	sex: 'female' | 'male';
+	value: number;
+	population: number;
+};
+
+/** One row per province, a column per sex: for the plots that read two values off each row. */
+export type ProvinceLifeRow = {
+	province: string;
+	female: number;
+	male: number;
+	population: number;
+};
+
+const LIFE_BY_PROVINCE = [
+	{ province: 'Buenos Aires', female: 79.9, male: 74.1 },
+	{ province: 'Córdoba', female: 80.8, male: 75.2 },
+	{ province: 'Mendoza', female: 81, male: 75.3 },
+	{ province: 'Salta', female: 79.5, male: 74 },
+	{ province: 'Chubut', female: 82.1, male: 74.9 }
+];
+
+const POPULATION_2022 = new Map(
+	PROVINCE_POPULATION_2022.map(({ province, population }) => [province, population])
+);
+
+export const PROVINCE_LIFE: ProvinceLifeRow[] = LIFE_BY_PROVINCE.map((row) => ({
+	...row,
+	population: Math.round(POPULATION_2022.get(row.province)! / 100_000) / 10
+}));
+
+export const PROVINCES = PROVINCE_LIFE.map(({ province }) => province);
+
+export const PROVINCE_VALUES: ProvinceRow[] = PROVINCE_LIFE.flatMap(
+	({ province, female, male, population }) => [
+		{ province, sex: 'female', value: female, population },
+		{ province, sex: 'male', value: male, population }
+	]
+);
+
+export const FEMALE_PROVINCE_VALUES: ProvinceRow[] = PROVINCE_VALUES.filter(
+	({ sex }) => sex === 'female'
+);
+
+export const MALE_PROVINCE_VALUES: ProvinceRow[] = PROVINCE_VALUES.filter(
+	({ sex }) => sex === 'male'
+);

package/examples/datasets/napoleons-march.ts

@@ -0,0 +1,182 @@
+// ── Napoleon's march on Moscow, 1812 ────────────────────────────────────────
+// Data for Charles Joseph Minard's 1812 map of Napoleon's Russian campaign,
+// from stdlib's `datasets-minard-napoleons-march`
+// (https://github.com/stdlib-js/datasets-minard-napoleons-march; the data is
+// CC0 / PDDL). The army's size, direction and position along the march to
+// Moscow and the retreat, the cities it passed, where Minard wrote the size,
+// and the temperature on the way back. The map's rivers are
+// `napoleons-rivers`.
+//
+// One change to stdlib's army rows, to match R's `HistData::Minard`: each
+// division's advance ends at the point its retreat starts from (Moscow for
+// division 1), which stdlib leaves out, so a trail of each direction reaches
+// the other. Division 1's retreat then leaves from (37.7, 55.7), a little off
+// the advance's end - as Minard drew it, the two ribbons run side by side
+// there instead of meeting at a point.
+
+export type NapoleonsArmyRow = {
+	lon: number;
+	lat: number;
+	/** Soldiers still marching at this point. */
+	size: number;
+	/** `'A'` advance (toward Moscow), `'R'` retreat. */
+	direction: 'A' | 'R';
+	/** Which of the three army columns this row belongs to. */
+	division: 1 | 2 | 3;
+};
+
+export type NapoleonsCity = { lon: number; lat: number; city: string };
+
+/** An army size printed on Minard's map, at a position beside its trail. The labels follow the march; `NAPOLEONS_LABEL_ROWS` says where. Includes two sizes (400,000 and 14,000) that stdlib's labels lack. */
+export type NapoleonsSizeLabel = { lon: number; lat: number; size: number; division: 1 | 2 | 3 };
+
+/** The temperature (°C) on the retreat, at a longitude and date. */
+export type NapoleonsTemperature = { lon: number; temp: number; date: string };
+
+export const NAPOLEONS_ARMY: NapoleonsArmyRow[] = [
+	{ lon: 24.0, lat: 54.9, size: 340000, direction: 'A', division: 1 },
+	{ lon: 24.5, lat: 55.0, size: 340000, direction: 'A', division: 1 },
+	{ lon: 25.5, lat: 54.5, size: 340000, direction: 'A', division: 1 },
+	{ lon: 26.0, lat: 54.7, size: 320000, direction: 'A', division: 1 },
+	{ lon: 27.0, lat: 54.8, size: 300000, direction: 'A', division: 1 },
+	{ lon: 28.0, lat: 54.9, size: 280000, direction: 'A', division: 1 },
+	{ lon: 28.5, lat: 55.0, size: 240000, direction: 'A', division: 1 },
+	{ lon: 29.0, lat: 55.1, size: 210000, direction: 'A', division: 1 },
+	{ lon: 30.0, lat: 55.2, size: 180000, direction: 'A', division: 1 },
+	{ lon: 30.3, lat: 55.3, size: 175000, direction: 'A', division: 1 },
+	{ lon: 32.0, lat: 54.8, size: 145000, direction: 'A', division: 1 },
+	{ lon: 33.2, lat: 54.9, size: 140000, direction: 'A', division: 1 },
+	{ lon: 34.4, lat: 55.5, size: 127100, direction: 'A', division: 1 },
+	{ lon: 35.5, lat: 55.4, size: 100000, direction: 'A', division: 1 },
+	{ lon: 36.0, lat: 55.5, size: 100000, direction: 'A', division: 1 },
+	{ lon: 37.6, lat: 55.8, size: 100000, direction: 'A', division: 1 },
+	{ lon: 37.7, lat: 55.7, size: 100000, direction: 'R', division: 1 },
+	{ lon: 37.5, lat: 55.7, size: 98000, direction: 'R', division: 1 },
+	{ lon: 37.0, lat: 55.0, size: 97000, direction: 'R', division: 1 },
+	{ lon: 36.8, lat: 55.0, size: 96000, direction: 'R', division: 1 },
+	{ lon: 35.4, lat: 55.3, size: 87000, direction: 'R', division: 1 },
+	{ lon: 34.3, lat: 55.2, size: 55000, direction: 'R', division: 1 },
+	{ lon: 33.3, lat: 54.8, size: 37000, direction: 'R', division: 1 },
+	{ lon: 32.0, lat: 54.6, size: 24000, direction: 'R', division: 1 },
+	{ lon: 30.4, lat: 54.4, size: 20000, direction: 'R', division: 1 },
+	{ lon: 29.2, lat: 54.4, size: 20000, direction: 'R', division: 1 },
+	{ lon: 28.5, lat: 54.3, size: 20000, direction: 'R', division: 1 },
+	{ lon: 28.3, lat: 54.4, size: 20000, direction: 'R', division: 1 },
+	{ lon: 24.0, lat: 55.1, size: 60000, direction: 'A', division: 2 },
+	{ lon: 24.5, lat: 55.2, size: 60000, direction: 'A', division: 2 },
+	{ lon: 25.5, lat: 54.7, size: 60000, direction: 'A', division: 2 },
+	{ lon: 26.6, lat: 55.7, size: 40000, direction: 'A', division: 2 },
+	{ lon: 27.4, lat: 55.6, size: 33000, direction: 'A', division: 2 },
+	{ lon: 28.7, lat: 55.5, size: 33000, direction: 'A', division: 2 },
+	{ lon: 28.7, lat: 55.5, size: 33000, direction: 'R', division: 2 },
+	{ lon: 29.2, lat: 54.3, size: 30000, direction: 'R', division: 2 },
+	{ lon: 28.5, lat: 54.2, size: 30000, direction: 'R', division: 2 },
+	{ lon: 28.3, lat: 54.3, size: 28000, direction: 'R', division: 2 },
+	{ lon: 27.5, lat: 54.5, size: 20000, direction: 'R', division: 2 },
+	{ lon: 26.8, lat: 54.3, size: 12000, direction: 'R', division: 2 },
+	{ lon: 26.4, lat: 54.4, size: 14000, direction: 'R', division: 2 },
+	{ lon: 24.6, lat: 54.5, size: 8000, direction: 'R', division: 2 },
+	{ lon: 24.4, lat: 54.4, size: 4000, direction: 'R', division: 2 },
+	{ lon: 24.2, lat: 54.4, size: 4000, direction: 'R', division: 2 },
+	{ lon: 24.1, lat: 54.3, size: 4000, direction: 'R', division: 2 },
+	{ lon: 24.0, lat: 55.2, size: 22000, direction: 'A', division: 3 },
+	{ lon: 24.5, lat: 55.3, size: 22000, direction: 'A', division: 3 },
+	{ lon: 24.6, lat: 55.8, size: 6000, direction: 'A', division: 3 },
+	{ lon: 24.6, lat: 55.8, size: 6000, direction: 'R', division: 3 },
+	{ lon: 24.2, lat: 54.4, size: 6000, direction: 'R', division: 3 },
+	{ lon: 24.1, lat: 54.3, size: 6000, direction: 'R', division: 3 }
+];
+
+export const NAPOLEONS_CITIES: NapoleonsCity[] = [
+	{ lon: 24.0, lat: 55.0, city: 'Kowno' },
+	{ lon: 25.3, lat: 54.7, city: 'Wilna' },
+	{ lon: 26.4, lat: 54.4, city: 'Smorgoni' },
+	{ lon: 26.8, lat: 54.3, city: 'Molodexno' },
+	{ lon: 27.7, lat: 55.2, city: 'Gloubokoe' },
+	{ lon: 27.6, lat: 53.9, city: 'Minsk' },
+	{ lon: 28.5, lat: 54.3, city: 'Studienska' },
+	{ lon: 28.7, lat: 55.5, city: 'Polotzk' },
+	{ lon: 29.2, lat: 54.4, city: 'Bobr' },
+	{ lon: 30.2, lat: 55.3, city: 'Witebsk' },
+	{ lon: 30.4, lat: 54.5, city: 'Orscha' },
+	{ lon: 30.4, lat: 53.9, city: 'Mohilow' },
+	{ lon: 32.0, lat: 54.8, city: 'Smolensk' },
+	{ lon: 33.2, lat: 54.9, city: 'Dorogobouge' },
+	{ lon: 34.3, lat: 55.2, city: 'Wixma' },
+	{ lon: 34.4, lat: 55.5, city: 'Chjat' },
+	{ lon: 36.0, lat: 55.5, city: 'Mojaisk' },
+	{ lon: 37.6, lat: 55.8, city: 'Moscou' },
+	{ lon: 36.6, lat: 55.3, city: 'Tarantino' },
+	{ lon: 36.5, lat: 55.0, city: 'Malo-Jarosewli' }
+];
+
+export const NAPOLEONS_SIZE_LABELS: NapoleonsSizeLabel[] = [
+	{ lon: 24.0, lat: 54.9, size: 422000, division: 1 },
+	{ lon: 24.5, lat: 55.0, size: 400000, division: 1 },
+	{ lon: 30.3, lat: 55.3, size: 175000, division: 1 },
+	{ lon: 32.0, lat: 54.8, size: 145000, division: 1 },
+	{ lon: 34.4, lat: 55.5, size: 127100, division: 1 },
+	{ lon: 35.5, lat: 55.4, size: 100000, division: 1 },
+	{ lon: 37.7, lat: 55.7, size: 100000, division: 1 },
+	{ lon: 36.8, lat: 55.0, size: 96000, division: 1 },
+	{ lon: 35.4, lat: 55.3, size: 87000, division: 1 },
+	{ lon: 34.3, lat: 55.2, size: 55000, division: 1 },
+	{ lon: 33.3, lat: 54.8, size: 37000, division: 1 },
+	{ lon: 32.0, lat: 54.6, size: 24000, division: 1 },
+	{ lon: 30.4, lat: 54.4, size: 20000, division: 1 },
+	{ lon: 26.6, lat: 55.7, size: 60000, division: 2 },
+	{ lon: 28.7, lat: 55.5, size: 33000, division: 2 },
+	{ lon: 29.2, lat: 54.3, size: 50000, division: 1 },
+	{ lon: 28.5, lat: 54.2, size: 28000, division: 1 },
+	{ lon: 26.8, lat: 54.3, size: 12000, division: 1 },
+	{ lon: 26.4, lat: 54.4, size: 14000, division: 2 },
+	{ lon: 25.0, lat: 54.4, size: 8000, division: 1 },
+	{ lon: 24.4, lat: 54.4, size: 4000, division: 1 },
+	{ lon: 24.5, lat: 55.3, size: 22000, division: 3 },
+	{ lon: 24.1, lat: 54.4, size: 10000, division: 1 },
+	{ lon: 24.6, lat: 55.8, size: 6000, division: 3 }
+];
+
+/**
+ * The army row each label is printed at, so the label is shown once the march
+ * reaches it: `NAPOLEONS_SIZE_LABELS[0]` goes with `NAPOLEONS_ARMY[NAPOLEONS_LABEL_ROWS[0]]`,
+ * and so on. Set by hand against the original Minard's map.
+ */
+export const NAPOLEONS_LABEL_ROWS: number[] = [
+	0, // 422,000
+	1, // 400,000
+	9, // 175,000
+	10, // 145,000
+	12, // 127,100
+	13, // 100,000
+	16, // 100,000
+	19, // 96,000
+	20, // 87,000
+	21, // 55,000
+	22, // 37,000
+	23, // 24,000
+	24, // 20,000
+	31, // 60,000
+	33, // 33,000
+	35, // 50,000
+	37, // 28,000
+	39, // 12,000
+	40, // 14,000
+	41, // 8,000
+	42, // 4,000
+	46, // 22,000
+	47, // 10,000
+	50 // 6,000
+];
+
+export const NAPOLEONS_TEMPERATURES: NapoleonsTemperature[] = [
+	{ lon: 37.6, temp: 0, date: '18 Oct 1812' },
+	{ lon: 36.0, temp: 0, date: '24 Oct 1812' },
+	{ lon: 33.2, temp: -9, date: '09 Nov 1812' },
+	{ lon: 32.0, temp: -21, date: '14 Nov 1812' },
+	{ lon: 29.2, temp: -11, date: '24 Nov 1812' },
+	{ lon: 28.5, temp: -20, date: '28 Nov 1812' },
+	{ lon: 27.2, temp: -24, date: '01 Dec 1812' },
+	{ lon: 26.7, temp: -30, date: '06 Dec 1812' },
+	{ lon: 25.3, temp: -26, date: '07 Dec 1812' }
+];

package/examples/datasets/penguins.ts

@@ -0,0 +1,54 @@
+// ── Penguins ────────────────────────────────────────────────────────────────
+// Palmer Station penguins (Gorman, Williams & Fraser, 2014), as distributed by
+// mwaskom/seaborn-data. Count of the 333 penguins sexed in the study, by
+// species, island and sex.
+
+export type PenguinCount = {
+	species: string;
+	island: string;
+	sex: 'Female' | 'Male';
+	count: number;
+};
+
+export const PENGUIN_SPECIES = ['Adelie', 'Chinstrap', 'Gentoo'];
+
+export const PENGUIN_ISLANDS = ['Biscoe', 'Dream', 'Torgersen'];
+
+export const PENGUIN_SEXES: PenguinCount['sex'][] = ['Female', 'Male'];
+
+/** One row per species, island and sex; a species absent from an island counts 0. */
+export const PENGUIN_COUNTS_BY_SEX: PenguinCount[] = [
+	{ species: 'Adelie', island: 'Biscoe', sex: 'Female', count: 22 },
+	{ species: 'Adelie', island: 'Dream', sex: 'Female', count: 27 },
+	{ species: 'Adelie', island: 'Torgersen', sex: 'Female', count: 24 },
+	{ species: 'Chinstrap', island: 'Biscoe', sex: 'Female', count: 0 },
+	{ species: 'Chinstrap', island: 'Dream', sex: 'Female', count: 34 },
+	{ species: 'Chinstrap', island: 'Torgersen', sex: 'Female', count: 0 },
+	{ species: 'Gentoo', island: 'Biscoe', sex: 'Female', count: 58 },
+	{ species: 'Gentoo', island: 'Dream', sex: 'Female', count: 0 },
+	{ species: 'Gentoo', island: 'Torgersen', sex: 'Female', count: 0 },
+	{ species: 'Adelie', island: 'Biscoe', sex: 'Male', count: 22 },
+	{ species: 'Adelie', island: 'Dream', sex: 'Male', count: 28 },
+	{ species: 'Adelie', island: 'Torgersen', sex: 'Male', count: 23 },
+	{ species: 'Chinstrap', island: 'Biscoe', sex: 'Male', count: 0 },
+	{ species: 'Chinstrap', island: 'Dream', sex: 'Male', count: 34 },
+	{ species: 'Chinstrap', island: 'Torgersen', sex: 'Male', count: 0 },
+	{ species: 'Gentoo', island: 'Biscoe', sex: 'Male', count: 61 },
+	{ species: 'Gentoo', island: 'Dream', sex: 'Male', count: 0 },
+	{ species: 'Gentoo', island: 'Torgersen', sex: 'Male', count: 0 }
+];
+
+/** One row per species and island, both sexes together; `speciesTotal` is the species' count on every island. */
+export type PenguinSpeciesCount = Omit<PenguinCount, 'sex'> & { speciesTotal: number };
+
+const sumCounts = (rows: PenguinCount[]) => rows.reduce((sum, d) => sum + d.count, 0);
+
+export const PENGUIN_COUNTS: PenguinSpeciesCount[] = PENGUIN_SPECIES.flatMap((species) => {
+	const speciesRows = PENGUIN_COUNTS_BY_SEX.filter((d) => d.species === species);
+	return PENGUIN_ISLANDS.map((island) => ({
+		species,
+		island,
+		count: sumCounts(speciesRows.filter((d) => d.island === island)),
+		speciesTotal: sumCounts(speciesRows)
+	}));
+});

package/examples/datasets/population-by-age-with-gaps.ts

@@ -0,0 +1,23 @@
+// ── Population of Buenos Aires City by age, with gaps ───────────────────────
+// The 2022 census female series with holes, to demonstrate gap filling, and the male series whole beside it.
+
+import { AGE_GROUPS, POPULATION_BY_AGE_AT_2022, type AgeRow } from './population-by-age';
+
+export type AgeRowWithGaps = Omit<AgeRow, 'year' | 'share'> & { share: number | null };
+
+/**
+ * The 2022 'Female' series with three holes - the first two age groups
+ * (start), an internal pair bounded by real data on both sides (middle), and
+ * the last two (end) - used to demonstrate PyramidPlot's styles.gaps fill
+ * on the same series every other PyramidPlot story already uses.
+ */
+export const FEMALE_2022_WITH_GAPS: AgeRowWithGaps[] = POPULATION_BY_AGE_AT_2022.filter(
+	(d) => d.sex === 'Female'
+).map((d, i) => ({
+	ageGroup: d.ageGroup,
+	sex: d.sex,
+	share: i < 2 || (i >= 8 && i < 10) || i >= AGE_GROUPS.length - 2 ? null : d.share
+}));
+
+/** The 2022 'Male' series, with no holes: the second series beside `FEMALE_2022_WITH_GAPS`. */
+export const MALE_2022: AgeRow[] = POPULATION_BY_AGE_AT_2022.filter((d) => d.sex === 'Male');