@fundar/data-chart-telling 1.1.0 → 1.2.0

package/examples/datasets/flight-routes.ts

@@ -0,0 +1,29 @@
+// ── Long-haul flight routes ─────────────────────────────────────────────────
+// OpenFlights route database (Open Database License): a few of its nonstop
+// routes of more than 10,000 km, two out of Buenos Aires, two out of Santiago
+// and three from Tokyo to Europe. The snapshot dates from 2014, so it is a
+// picture of those years' routes, not of today's.
+
+export type FlightRoute = {
+	route: string;
+	fromLon: number;
+	fromLat: number;
+	toLon: number;
+	toLat: number;
+};
+
+export const FLIGHT_ROUTES: FlightRoute[] = [
+	{ route: 'Buenos Aires - Madrid', fromLon: -58.54, fromLat: -34.82, toLon: -3.56, toLat: 40.47 },
+	{
+		route: 'Buenos Aires - Frankfurt',
+		fromLon: -58.54,
+		fromLat: -34.82,
+		toLon: 8.57,
+		toLat: 50.03
+	},
+	{ route: 'Santiago - Sydney', fromLon: -70.79, fromLat: -33.39, toLon: 151.18, toLat: -33.95 },
+	{ route: 'Santiago - Paris', fromLon: -70.79, fromLat: -33.39, toLon: 2.55, toLat: 49.01 },
+	{ route: 'Tokyo - London', fromLon: 139.78, fromLat: 35.55, toLon: -0.46, toLat: 51.47 },
+	{ route: 'Tokyo - Paris', fromLon: 139.78, fromLat: 35.55, toLon: 2.55, toLat: 49.01 },
+	{ route: 'Tokyo - Frankfurt', fromLon: 140.39, fromLat: 35.76, toLon: 8.57, toLat: 50.03 }
+];

package/examples/datasets/height-density.ts

@@ -0,0 +1,37 @@
+// ── Height density by sex ───────────────────────────────────────────────────
+// A Gaussian kernel density estimate of the adult heights in `heights.ts`, one
+// curve per sex, each with its own Silverman bandwidth.
+
+import { HEIGHTS } from './heights';
+
+export type HeightDensity = { height: number; sex: 'male' | 'female'; density: number };
+
+const kernel = (distance: number) => Math.exp(-(distance ** 2) / 2) / Math.sqrt(2 * Math.PI);
+
+const silvermanBandwidth = (values: number[]) => {
+	const mean = values.reduce((sum, value) => sum + value, 0) / values.length;
+	const deviation = Math.sqrt(
+		values.reduce((sum, value) => sum + (value - mean) ** 2, 0) / (values.length - 1)
+	);
+	return 1.06 * deviation * values.length ** -0.2;
+};
+
+const densityAt = (values: number[], bandwidth: number, height: number) =>
+	values.reduce((sum, value) => sum + kernel((height - value) / bandwidth), 0) /
+	(values.length * bandwidth);
+
+const GRID = Array.from({ length: 61 }, (_, index) => 125 + index);
+
+/** Height density per centimeter, as a percent - one curve per sex, every centimeter from 125 to 185. */
+export const HEIGHT_DENSITY: HeightDensity[] = (['male', 'female'] as const).flatMap((sex) => {
+	const heights = HEIGHTS.filter(({ group }) => group === sex).map(({ height }) => height);
+	const bandwidth = silvermanBandwidth(heights);
+	return GRID.map((height) => ({
+		height,
+		sex,
+		density: Math.round(densityAt(heights, bandwidth, height) * 10000) / 100
+	}));
+});
+
+export const MALE_HEIGHT_DENSITY = HEIGHT_DENSITY.filter((d) => d.sex === 'male');
+export const FEMALE_HEIGHT_DENSITY = HEIGHT_DENSITY.filter((d) => d.sex === 'female');

package/examples/datasets/heights.ts

@@ -0,0 +1,370 @@
+// ── Adult heights and weights by sex ────────────────────────────────────────
+// Nancy Howell's census of the !Kung San (Howell1, from the rethinking R
+// package), adults only. Heights in centimeters, weights in kilograms, sorted
+// by height.
+
+export type HeightRow = { height: number; weight: number; group: string };
+
+/** Per sex, one `[height, weight]` per person. */
+const FEMALE_MEASUREMENTS = [
+	[137, 31.9],
+	[137, 36.3],
+	[138, 39.1],
+	[139, 33.6],
+	[140, 36.5],
+	[140, 36.6],
+	[140, 37.4],
+	[141, 40.9],
+	[142, 31.7],
+	[142, 32.8],
+	[142, 36.2],
+	[142, 42.9],
+	[142, 44.2],
+	[142, 44.3],
+	[143, 32.7],
+	[143, 33],
+	[143, 34.2],
+	[143, 34.4],
+	[143, 35.6],
+	[143, 35.6],
+	[143, 37.3],
+	[143, 38.8],
+	[144, 31.1],
+	[144, 33.9],
+	[144, 34.2],
+	[144, 37.2],
+	[144, 38.4],
+	[144, 38.4],
+	[144, 38.6],
+	[144, 38.9],
+	[144, 39.4],
+	[144, 41.6],
+	[145, 33.5],
+	[145, 36],
+	[145, 37.9],
+	[145, 38],
+	[145, 39.4],
+	[145, 41.2],
+	[145, 41.3],
+	[145, 42.1],
+	[145, 42.3],
+	[145, 42.4],
+	[145, 42.5],
+	[145, 44],
+	[145, 45],
+	[145, 45.6],
+	[146, 31.9],
+	[146, 34.2],
+	[146, 37.5],
+	[146, 37.5],
+	[146, 38.5],
+	[146, 39.4],
+	[146, 42.8],
+	[146, 44.8],
+	[147, 35.1],
+	[147, 35.5],
+	[147, 35.6],
+	[147, 35.9],
+	[147, 36.1],
+	[147, 36.6],
+	[147, 36.9],
+	[147, 37],
+	[147, 38.1],
+	[147, 39.1],
+	[147, 40.9],
+	[147, 46.5],
+	[147, 49],
+	[147, 51.3],
+	[148, 34.9],
+	[148, 36.5],
+	[148, 38.4],
+	[148, 39.4],
+	[148, 40.1],
+	[148, 41.2],
+	[148, 42.8],
+	[148, 47.4],
+	[148, 49.9],
+	[149, 35.9],
+	[149, 37.6],
+	[149, 37.9],
+	[149, 38.2],
+	[149, 39.4],
+	[149, 40.4],
+	[149, 40.8],
+	[149, 41.3],
+	[149, 42.1],
+	[149, 42.2],
+	[149, 42.2],
+	[149, 42.5],
+	[149, 43.9],
+	[149, 44.1],
+	[149, 45.1],
+	[149, 52.3],
+	[150, 33.8],
+	[150, 35.9],
+	[150, 37.9],
+	[150, 38],
+	[150, 38.2],
+	[150, 38.7],
+	[150, 38.7],
+	[150, 39],
+	[150, 40.5],
+	[150, 40.9],
+	[150, 41.9],
+	[150, 42],
+	[150, 42.4],
+	[150, 43],
+	[150, 43.5],
+	[150, 44.1],
+	[150, 47.7],
+	[150, 49.8],
+	[150, 52.7],
+	[150, 53.4],
+	[151, 36.7],
+	[151, 38.5],
+	[151, 42.3],
+	[151, 43.4],
+	[151, 46.1],
+	[152, 34.8],
+	[152, 35.3],
+	[152, 39.3],
+	[152, 40.8],
+	[152, 40.9],
+	[152, 40.9],
+	[152, 41.1],
+	[152, 42.8],
+	[152, 43.1],
+	[152, 43.4],
+	[152, 43.5],
+	[152, 44.3],
+	[152, 44.7],
+	[152, 45.2],
+	[152, 46.7],
+	[152, 48],
+	[152, 50],
+	[152, 51.3],
+	[153, 32.2],
+	[153, 39.5],
+	[153, 40],
+	[153, 45.2],
+	[153, 46.6],
+	[153, 49.6],
+	[154, 35.5],
+	[154, 40.5],
+	[154, 41.3],
+	[154, 41.3],
+	[154, 44.2],
+	[154, 44.6],
+	[154, 44.8],
+	[154, 45.8],
+	[154, 46.8],
+	[154, 47.6],
+	[154, 47.9],
+	[154, 48.9],
+	[154, 49.9],
+	[154, 50.2],
+	[155, 39.9],
+	[155, 43.3],
+	[155, 43.9],
+	[155, 46.2],
+	[155, 47.2],
+	[155, 48.1],
+	[155, 48.2],
+	[156, 42.1],
+	[156, 42.7],
+	[156, 43.9],
+	[156, 44],
+	[156, 44.1],
+	[156, 44.3],
+	[156, 45.5],
+	[156, 45.6],
+	[156, 46.4],
+	[156, 51.5],
+	[156, 54.1],
+	[156, 54.3],
+	[157, 45.1],
+	[157, 45.6],
+	[157, 45.7],
+	[157, 49.2],
+	[157, 50.8],
+	[158, 47.3],
+	[159, 44.4],
+	[159, 50.9],
+	[160, 54.6],
+	[162, 53.2],
+	[163, 47],
+	[163, 56.8]
+];
+
+const MALE_MEASUREMENTS = [
+	[140, 50.3],
+	[142, 31.5],
+	[146, 35.5],
+	[147, 42.4],
+	[148, 40.3],
+	[149, 35.8],
+	[149, 39.5],
+	[149, 40.8],
+	[149, 43.9],
+	[151, 41.2],
+	[151, 44],
+	[152, 36.5],
+	[152, 41.2],
+	[152, 42.5],
+	[152, 42.9],
+	[152, 43.7],
+	[152, 43.9],
+	[152, 47.8],
+	[152, 49.4],
+	[153, 49.9],
+	[154, 41.2],
+	[154, 47.4],
+	[154, 48.3],
+	[155, 38.2],
+	[155, 42.2],
+	[155, 44.1],
+	[155, 45.2],
+	[155, 45.4],
+	[155, 48.5],
+	[155, 49.7],
+	[156, 39.3],
+	[156, 39.7],
+	[156, 41.1],
+	[156, 50.9],
+	[157, 40],
+	[157, 40.6],
+	[157, 42.3],
+	[157, 44.6],
+	[157, 44.7],
+	[157, 45.6],
+	[157, 45.9],
+	[157, 46.6],
+	[157, 47.6],
+	[157, 47.6],
+	[157, 47.9],
+	[157, 50.2],
+	[157, 53],
+	[158, 39.2],
+	[158, 43.1],
+	[158, 45.2],
+	[158, 46.3],
+	[158, 46.5],
+	[158, 47.5],
+	[158, 48.6],
+	[159, 43],
+	[159, 44.4],
+	[159, 45],
+	[159, 47.2],
+	[159, 48.7],
+	[159, 48.8],
+	[159, 49],
+	[159, 50.2],
+	[159, 50.7],
+	[159, 51.5],
+	[159, 52.2],
+	[159, 52.5],
+	[160, 37.1],
+	[160, 44.6],
+	[160, 46],
+	[160, 47.2],
+	[160, 48.2],
+	[160, 49.3],
+	[160, 51.2],
+	[160, 52],
+	[160, 54.2],
+	[160, 55.8],
+	[160, 59.6],
+	[161, 39.8],
+	[161, 41.9],
+	[161, 43.2],
+	[161, 43.3],
+	[161, 46.3],
+	[161, 46.7],
+	[161, 47.3],
+	[161, 47.5],
+	[161, 47.9],
+	[161, 47.9],
+	[161, 47.9],
+	[161, 48.2],
+	[161, 48.4],
+	[161, 48.5],
+	[161, 49],
+	[161, 49.4],
+	[161, 50.4],
+	[161, 51],
+	[161, 52.2],
+	[161, 53.6],
+	[161, 54.1],
+	[161, 54.9],
+	[161, 55.4],
+	[162, 41.7],
+	[162, 47.3],
+	[162, 50.2],
+	[162, 50.3],
+	[162, 51.6],
+	[162, 55.1],
+	[162, 57],
+	[163, 43.2],
+	[163, 45.7],
+	[163, 46],
+	[163, 48.1],
+	[163, 48.1],
+	[163, 48.6],
+	[163, 49.1],
+	[163, 49.4],
+	[163, 49.6],
+	[163, 51],
+	[163, 52.2],
+	[163, 53.1],
+	[163, 55.3],
+	[163, 56],
+	[164, 45.9],
+	[164, 46.7],
+	[164, 46.8],
+	[164, 47.5],
+	[164, 47.9],
+	[164, 52.2],
+	[164, 53.2],
+	[164, 54.3],
+	[164, 55.4],
+	[164, 55.9],
+	[164, 63],
+	[165, 51.2],
+	[165, 54.5],
+	[166, 47.7],
+	[166, 48.3],
+	[166, 48.6],
+	[166, 49],
+	[166, 52.7],
+	[166, 56.4],
+	[166, 57.5],
+	[166, 58.6],
+	[167, 47.2],
+	[167, 50.6],
+	[167, 52.9],
+	[167, 55.2],
+	[167, 56.8],
+	[167, 57.1],
+	[168, 50.7],
+	[168, 54.6],
+	[168, 56],
+	[169, 55.5],
+	[169, 56.4],
+	[169, 58.8],
+	[170, 47.6],
+	[170, 48.6],
+	[170, 53.5],
+	[170, 53.6],
+	[171, 56.6],
+	[171, 56.6],
+	[171, 58.5],
+	[171, 59.8],
+	[173, 51.3],
+	[173, 61.8],
+	[179, 55.7]
+];
+
+export const HEIGHTS: HeightRow[] = [
+	...FEMALE_MEASUREMENTS.map(([height, weight]) => ({ height, weight, group: 'female' })),
+	...MALE_MEASUREMENTS.map(([height, weight]) => ({ height, weight, group: 'male' }))
+];

package/examples/datasets/index.ts

@@ -0,0 +1,24 @@
+// The small datasets. The geographic ones (provinces, countries, comunas, partidos)
+// load ~4MB of boundaries, so each is imported on its own from `$datasets/<name>`.
+export * from './argentina-chile-trends';
+export * from './commodity-prices';
+export * from './countries-over-time';
+export * from './daily-temperature';
+export * from './earthquakes';
+export * from './flight-routes';
+export * from './height-density';
+export * from './heights';
+export * from './inflation-by-region';
+export * from './inflation-ranges';
+export * from './iris-flower';
+export * from './life-expectancy';
+export * from './napoleons-march';
+export * from './penguins';
+export * from './population-by-age';
+export * from './population-by-age-with-gaps';
+export * from './province-population';
+export * from './stock-prices';
+export * from './weather-stations';
+export * from './weather-stations-over-time';
+export * from './wind-vectors';
+export * from './world-temperature';

package/examples/datasets/inflation-by-region.ts

@@ -0,0 +1,44 @@
+// ── Monthly inflation by region ─────────────────────────────────────────────
+// INDEC, consumer price index (IPC, base December 2016), via the datos.gob.ar
+// series API. Change from the previous month, in percent, January 2023 to
+// August 2026.
+
+export type RegionRow = { date: Date; region: string; value: number };
+
+export const MONTHS = Array.from(
+	{ length: 44 },
+	(_, monthIndex) => new Date(Date.UTC(2023, monthIndex, 1))
+);
+
+export const INFLATION_BY_REGION = [
+	{
+		region: 'GBA',
+		inflation: [
+			6, 6.7, 7.8, 8.6, 8, 5.8, 6.2, 12.3, 12.2, 8.6, 12.9, 25.1, 19.6, 15, 11.5, 9.2, 4.3, 4.4, 4,
+			4.1, 3.7, 2.8, 2.6, 2.9, 2, 2.2, 3.9, 2.8, 1.5, 2, 1.9, 1.9, 2.1, 2.4, 2.5, 2.8, 2.8, 2.6,
+			3.4, 2.8, 2.3, 1.9, 2.3, 1.6
+		]
+	},
+	{
+		region: 'Cuyo',
+		inflation: [
+			6.4, 6.7, 7.9, 7.2, 7.5, 5.3, 6.3, 12.3, 13.7, 7.4, 12.8, 25.8, 22.3, 13.5, 9.3, 8.1, 4.3,
+			5.1, 4.6, 4.5, 3, 2.2, 2.1, 2.3, 2, 2.7, 3.5, 2.9, 1.6, 1, 1.9, 2.1, 2.2, 2.3, 2.8, 3, 3, 3.4,
+			3.2, 2.1, 2.1, 1.6, 1.9, 1.7
+		]
+	},
+	{
+		region: 'Northwest',
+		inflation: [
+			6.3, 7.3, 7.3, 7.7, 8, 6.6, 6.1, 13.7, 13.2, 7.7, 11.8, 25.2, 21.7, 11.7, 8.8, 9.1, 4.2, 4.8,
+			3.6, 5, 3.4, 2.6, 1.9, 2.7, 2.6, 2.6, 4.3, 2.9, 1.2, 1.2, 1.7, 2, 2.2, 2.1, 2.3, 2.6, 2.8,
+			3.5, 4, 2.5, 2.1, 1.7, 2, 1.8
+		]
+	}
+];
+
+export const REGIONS = INFLATION_BY_REGION.map(({ region }) => region);
+
+export const REGION_VALUES: RegionRow[] = INFLATION_BY_REGION.flatMap(({ region, inflation }) =>
+	MONTHS.map((date, monthIndex) => ({ date, region, value: inflation[monthIndex] }))
+);

package/examples/datasets/inflation-ranges.ts

@@ -0,0 +1,34 @@
+// ── Monthly inflation by region and year ────────────────────────────────────
+// The monthly series, summarized per region and year: the mean of the monthly
+// changes and the lowest and highest month. 2026 holds the eight months so far.
+
+import { INFLATION_BY_REGION, MONTHS } from './inflation-by-region';
+
+export type InflationRange = {
+	period: string;
+	region: string;
+	year: number;
+	mean: number;
+	min: number;
+	max: number;
+};
+
+const round1 = (value: number) => Math.round(value * 10) / 10;
+
+export const INFLATION_RANGES: InflationRange[] = INFLATION_BY_REGION.flatMap(
+	({ region, inflation }) =>
+		[2023, 2024, 2025, 2026].map((year) => {
+			const months = MONTHS.flatMap((date, monthIndex) =>
+				date.getUTCFullYear() === year ? [inflation[monthIndex]] : []
+			);
+			const mean = months.reduce((sum, value) => sum + value, 0) / months.length;
+			return {
+				period: `${region} ${year}`,
+				region,
+				year,
+				mean: round1(mean),
+				min: Math.min(...months),
+				max: Math.max(...months)
+			};
+		})
+);