// Copyright: Ankitects Pty Ltd and contributors // License: GNU AGPL, version 3 or later; http://www.gnu.org/licenses/agpl.html /* eslint @typescript-eslint/no-non-null-assertion: "off", @typescript-eslint/no-explicit-any: "off", */ import type pb from "anki/backend_proto"; import { extent, histogram, quantile, sum, mean } from "d3-array"; import { scaleLinear, scaleSequential } from "d3-scale"; import { CardQueue } from "anki/cards"; import type { HistogramData } from "./histogram-graph"; import { interpolateBlues } from "d3-scale-chromatic"; import type { I18n } from "anki/i18n"; import type { TableDatum } from "./graph-helpers"; import { timeSpan } from "anki/time"; export interface IntervalGraphData { intervals: number[]; } export enum IntervalRange { Month = 0, Percentile50 = 1, Percentile95 = 2, All = 3, } export function gatherIntervalData(data: pb.BackendProto.GraphsOut): IntervalGraphData { const intervals = (data.cards as pb.BackendProto.Card[]) .filter((c) => c.queue == CardQueue.Review) .map((c) => c.interval); return { intervals }; } export function intervalLabel( i18n: I18n, daysStart: number, daysEnd: number, cards: number ): string { if (daysEnd - daysStart <= 1) { // singular return i18n.tr(i18n.TR.STATISTICS_INTERVALS_DAY_SINGLE, { day: daysStart, cards, }); } else { // range return i18n.tr(i18n.TR.STATISTICS_INTERVALS_DAY_RANGE, { daysStart, daysEnd: daysEnd - 1, cards, }); } } export function prepareIntervalData( data: IntervalGraphData, range: IntervalRange, i18n: I18n ): [HistogramData | null, TableDatum[]] { // get min/max const allIntervals = data.intervals; if (!allIntervals.length) { return [null, []]; } const [_xMinOrig, origXMax] = extent(allIntervals); let xMax = origXMax; // cap max to selected range switch (range) { case IntervalRange.Month: xMax = Math.min(xMax!, 31); break; case IntervalRange.Percentile50: xMax = quantile(allIntervals, 0.5); break; case IntervalRange.Percentile95: xMax = quantile(allIntervals, 0.95); break; case IntervalRange.All: break; } const xMin = 0; xMax = xMax! + 1; // cap bars to available range const desiredBars = Math.min(70, xMax! - xMin!); const scale = scaleLinear().domain([xMin!, xMax!]).nice(); const bins = histogram() .domain(scale.domain() as any) .thresholds(scale.ticks(desiredBars))(allIntervals); // empty graph? const totalInPeriod = sum(bins, (bin) => bin.length); if (!totalInPeriod) { return [null, []]; } const adjustedRange = scaleLinear().range([0.7, 0.3]); const colourScale = scaleSequential((n) => interpolateBlues(adjustedRange(n)!) ).domain([xMax!, xMin!]); function hoverText( data: HistogramData, binIdx: number, _cumulative: number, percent: number ): string { const bin = data.bins[binIdx]; // const day = dayLabel(i18n, bin.x0!, bin.x1!); const interval = intervalLabel(i18n, bin.x0!, bin.x1!, bin.length); const total = i18n.tr(i18n.TR.STATISTICS_RUNNING_TOTAL); return `${interval}
${total}: \u200e${percent.toFixed(1)}%`; } const meanInterval = Math.round(mean(allIntervals) ?? 0); const meanIntervalString = timeSpan(i18n, meanInterval * 86400, false); const tableData = [ { label: i18n.tr(i18n.TR.STATISTICS_AVERAGE_INTERVAL), value: meanIntervalString, }, ]; return [ { scale, bins, total: totalInPeriod, hoverText, colourScale, showArea: true }, tableData, ]; }