manim-web 0.23.0 → 0.25.0

package/dist/mobjects/graphing/ScatterPlot.d.ts

@@ -0,0 +1,66 @@
+import { Group } from '../../core/Group';
+import { VGroup } from '../../core/VGroup';
+import { Dot } from '../geometry/Dot';
+import { Axes } from './Axes';
+/** Options for creating a ScatterPlot. */
+export interface ScatterPlotOptions {
+    /** X coordinates of the points. */
+    x: number[];
+    /** Y coordinates of the points. Paired with x by index. */
+    y: number[];
+    /** Dot radius, or a per-point radius array for a bubble chart. Default: 0.06 */
+    sizes?: number | number[];
+    /** Dot color, or a per-point color array. Default: Manim color palette */
+    colors?: string | string[];
+    /** Fill opacity for the dots. Default: 1 */
+    fillOpacity?: number;
+    /** Stroke width for the dots. Default: 0 */
+    strokeWidth?: number;
+    /** An existing Axes to plot onto. When omitted, one is built from the data. */
+    axes?: Axes;
+    /** X-axis range override as [min, max] or [min, max, step]. */
+    xRange?: [number, number] | [number, number, number];
+    /** Y-axis range override as [min, max] or [min, max, step]. */
+    yRange?: [number, number] | [number, number, number];
+    /** Visual length of the x-axis when auto-building axes. Default: 8 */
+    xLength?: number;
+    /** Visual length of the y-axis when auto-building axes. Default: 6 */
+    yLength?: number;
+    /** Color for the axes when auto-building. Default: '#ffffff' */
+    axisColor?: string;
+}
+/**
+ * ScatterPlot - points plotted as dots on a coordinate system.
+ *
+ * Each (x, y) pair becomes a Dot. Per-point sizes and colors turn the plot
+ * into a bubble chart. When no Axes is supplied, one is built to fit the data.
+ *
+ * @example
+ * ```typescript
+ * const plot = new ScatterPlot({
+ *   x: [1, 2, 3, 4],
+ *   y: [2, 1, 4, 3],
+ *   sizes: [0.05, 0.1, 0.15, 0.2],
+ *   colors: ['#ff0000', '#00ff00'],
+ * });
+ * ```
+ */
+export declare class ScatterPlot extends Group {
+    /** The coordinate system the points are plotted on. */
+    axes: Axes;
+    /** The plotted dots, one per (x, y) pair. */
+    dots: VGroup;
+    protected _x: number[];
+    protected _y: number[];
+    constructor(options: ScatterPlotOptions);
+    /** Get the coordinate system. */
+    getAxes(): Axes;
+    /** Get the group of plotted dots. */
+    getDots(): VGroup;
+    /** Get a single dot by point index, or undefined when out of range. */
+    getDot(index: number): Dot | undefined;
+    /** The number of plotted points. */
+    get numPoints(): number;
+    copy(): ScatterPlot;
+}
+//# sourceMappingURL=ScatterPlot.d.ts.map

package/dist/mobjects/graphing/ScatterPlot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScatterPlot.d.ts","sourceRoot":"","sources":["../../../src/mobjects/graphing/ScatterPlot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAO9B,0CAA0C;AAC1C,MAAM,WAAW,kBAAkB;IACjC,mCAAmC;IACnC,CAAC,EAAE,MAAM,EAAE,CAAC;IACZ,2DAA2D;IAC3D,CAAC,EAAE,MAAM,EAAE,CAAC;IACZ,gFAAgF;IAChF,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC1B,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC3B,4CAA4C;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4CAA4C;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+EAA+E;IAC/E,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,+DAA+D;IAC/D,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACrD,+DAA+D;IAC/D,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACrD,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,WAAY,SAAQ,KAAK;IACpC,uDAAuD;IACvD,IAAI,EAAE,IAAI,CAAC;IACX,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IAEb,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC;gBAEX,OAAO,EAAE,kBAAkB;IAuDvC,iCAAiC;IACjC,OAAO,IAAI,IAAI;IAIf,qCAAqC;IACrC,OAAO,IAAI,MAAM;IAIjB,uEAAuE;IACvE,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,SAAS;IAItC,oCAAoC;IACpC,IAAI,SAAS,IAAI,MAAM,CAEtB;IAEQ,IAAI,IAAI,WAAW;CAK7B"}

package/dist/mobjects/graphing/ViolinPlot.d.ts

@@ -0,0 +1,83 @@
+import { Group } from '../../core/Group';
+import { Polygon } from '../geometry/Polygon';
+import { Axes } from './Axes';
+import { PlotOrientation } from './BoxPlot';
+/** The sampled KDE for one violin group. */
+export interface ViolinDensity {
+    /** Value-axis positions where the density was sampled, low to high. */
+    values: number[];
+    /** Estimated density at each value. */
+    densities: number[];
+    /** Half-width of the violin at each value, in category units. */
+    halfWidths: number[];
+}
+/** Options for creating a ViolinPlot. */
+export interface ViolinPlotOptions {
+    /** One data group (number[]) or several groups (number[][]). */
+    data: number[] | number[][];
+    /** KDE bandwidth. Default: Silverman's rule of thumb per group. */
+    bandwidth?: number;
+    /** Lay violins along the x-axis ('vertical') or y-axis ('horizontal'). Default: 'vertical' */
+    orientation?: PlotOrientation;
+    /** Violin color, or a per-group color array. Default: Manim color palette */
+    colors?: string | string[];
+    /** Fill opacity for the violins. Default: 0.5 */
+    fillOpacity?: number;
+    /** Stroke width for the violin outline. Default: 2 */
+    strokeWidth?: number;
+    /** Number of KDE samples along the value axis per group. Default: 48 */
+    resolution?: number;
+    /** Maximum half-width of a violin in category units. Default: 0.4 */
+    widthScale?: number;
+    /** An existing Axes to draw onto. When omitted, one is built from the data. */
+    axes?: Axes;
+    /** Visual length of the x-axis when auto-building axes. Default: 8 */
+    xLength?: number;
+    /** Visual length of the y-axis when auto-building axes. Default: 6 */
+    yLength?: number;
+    /** Color for the axes when auto-building. Default: '#ffffff' */
+    axisColor?: string;
+}
+/**
+ * ViolinPlot - a mirrored kernel-density shape per data group.
+ *
+ * Each group estimates a Gaussian KDE over its value range and draws a shape
+ * that is symmetric about the group's category line. The widest part of the
+ * violin sits at the densest value (the mode). Groups sit side by side along
+ * the category axis.
+ *
+ * @example
+ * ```typescript
+ * const violin = new ViolinPlot({
+ *   data: [[1, 2, 2, 3, 3, 3, 4, 4, 5], [2, 3, 3, 4]],
+ *   bandwidth: 0.5,
+ * });
+ * ```
+ */
+export declare class ViolinPlot extends Group {
+    /** The coordinate system the violins are drawn on. */
+    axes: Axes;
+    protected _groupsData: number[][];
+    protected _orientation: PlotOrientation;
+    protected _densities: ViolinDensity[];
+    protected _violins: (Polygon | null)[];
+    constructor(options: ViolinPlotOptions);
+    /** Padded value range covering every data value across all groups. */
+    private _valueRange;
+    /** Sample the KDE of one group over its value range. */
+    private _sampleDensity;
+    /** Map a (category, value) pair to a world point, respecting orientation. */
+    private _toPoint;
+    /** Build the mirrored KDE polygon for one group. */
+    private _buildViolin;
+    /** Get the coordinate system. */
+    getAxes(): Axes;
+    /** Get the sampled KDE for one group. */
+    getDensity(index: number): ViolinDensity;
+    /** Get the violin polygon for one group, or null when the group is empty. */
+    getViolin(index: number): Polygon | null;
+    /** The number of data groups. */
+    get numGroups(): number;
+    copy(): ViolinPlot;
+}
+//# sourceMappingURL=ViolinPlot.d.ts.map

package/dist/mobjects/graphing/ViolinPlot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ViolinPlot.d.ts","sourceRoot":"","sources":["../../../src/mobjects/graphing/ViolinPlot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEzC,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAE9B,OAAO,EAAmB,KAAK,eAAe,EAAE,MAAM,WAAW,CAAC;AAMlE,4CAA4C;AAC5C,MAAM,WAAW,aAAa;IAC5B,uEAAuE;IACvE,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,uCAAuC;IACvC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,iEAAiE;IACjE,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,yCAAyC;AACzC,MAAM,WAAW,iBAAiB;IAChC,gEAAgE;IAChE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,EAAE,CAAC;IAC5B,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8FAA8F;IAC9F,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,6EAA6E;IAC7E,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC3B,iDAAiD;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+EAA+E;IAC/E,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,UAAW,SAAQ,KAAK;IACnC,sDAAsD;IACtD,IAAI,EAAE,IAAI,CAAC;IAEX,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,CAAC;IAClC,SAAS,CAAC,YAAY,EAAE,eAAe,CAAC;IACxC,SAAS,CAAC,UAAU,EAAE,aAAa,EAAE,CAAM;IAC3C,SAAS,CAAC,QAAQ,EAAE,CAAC,OAAO,GAAG,IAAI,CAAC,EAAE,CAAM;gBAEhC,OAAO,EAAE,iBAAiB;IAiDtC,sEAAsE;IACtE,OAAO,CAAC,WAAW;IAKnB,wDAAwD;IACxD,OAAO,CAAC,cAAc;IAiCtB,6EAA6E;IAC7E,OAAO,CAAC,QAAQ;IAMhB,oDAAoD;IACpD,OAAO,CAAC,YAAY;IA2BpB,iCAAiC;IACjC,OAAO,IAAI,IAAI;IAIf,yCAAyC;IACzC,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa;IASxC,6EAA6E;IAC7E,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI;IAIxC,iCAAiC;IACjC,IAAI,SAAS,IAAI,MAAM,CAEtB;IAEQ,IAAI,IAAI,UAAU;CAQ5B"}

package/dist/mobjects/graphing/fourier.d.ts

@@ -0,0 +1,104 @@
+import { Complex } from './ComplexPlane';
+/**
+ * A single Fourier coefficient expressed in polar form.
+ *
+ * The complex coefficient is `amplitude * e^(i * phase)`. In an epicycle
+ * drawing each coefficient is one rotating vector: `amplitude` is the circle
+ * radius, `phase` is the starting angle, and `freq` is the signed number of
+ * turns the vector makes per unit of normalized time `t`.
+ */
+export interface FourierCoefficient {
+    /** Signed integer frequency (…, -2, -1, 0, 1, 2, …), centered around 0. */
+    freq: number;
+    /** Non-negative magnitude |c_k| (the rotating-vector length / circle radius). */
+    amplitude: number;
+    /** Phase arg(c_k) in radians, in (-π, π]. */
+    phase: number;
+}
+/** Ordering strategy for the coefficient chain. */
+export type FourierOrder = 'amplitude' | 'frequency';
+/**
+ * Compute the discrete Fourier coefficients of a list of complex samples.
+ *
+ * Given `N` samples `f[0..N-1]` taken at equal spacing over one period, the
+ * coefficient for index `k` is:
+ *
+ *   c_k = (1 / N) * Σ_n f[n] * e^(-2πi · k · n / N)
+ *
+ * The returned array has one entry per `k` (DC term first, index `k = 0`).
+ * Each entry carries a *centered* signed frequency: indices in the upper half
+ * (`k > N/2`) map to the negative frequency `k - N`. Centered frequencies make
+ * the vectors rotate in their natural slow-to-fast, alternating-direction
+ * order while still reconstructing every sample exactly (see
+ * {@link reconstructSample}).
+ *
+ * @param samples - Complex path samples, equally spaced over one period.
+ * @returns One {@link FourierCoefficient} per sample index. Empty input yields `[]`.
+ */
+export declare function fourierCoefficients(samples: Complex[]): FourierCoefficient[];
+/**
+ * Evaluate the complex sum of rotating vectors at normalized time `t`.
+ *
+ * Each coefficient contributes `amplitude · e^(i · (2π · freq · t + phase))`.
+ * At `t = sampleIndex / N` this reproduces the original sample exactly, so the
+ * full coefficient set round-trips the input of {@link fourierCoefficients}.
+ *
+ * @param coefficients - Coefficients to sum (any order; order does not change the sum).
+ * @param t - Normalized time; one full period spans `t ∈ [0, 1)`.
+ * @returns The summed complex value.
+ */
+export declare function reconstructSample(coefficients: FourierCoefficient[], t: number): Complex;
+/**
+ * Sum only the first `numTerms` coefficients at normalized time `t`.
+ *
+ * This is the partial reconstruction that an {@link FourierEpicycles} pen traces
+ * when it shows `numTerms` vectors: it equals the tip of the vector chain.
+ *
+ * @param coefficients - Ordered coefficients; the first `numTerms` are summed.
+ * @param t - Normalized time; one full period spans `t ∈ [0, 1)`.
+ * @param numTerms - How many leading coefficients to include. Clamped to `[0, length]`.
+ * @returns The summed complex value. `numTerms <= 0` yields `{ re: 0, im: 0 }`.
+ */
+export declare function partialSum(coefficients: FourierCoefficient[], t: number, numTerms: number): Complex;
+/**
+ * Return a reordered copy of the coefficients for the vector chain.
+ *
+ * - `'amplitude'` (best approximation per term): largest amplitude first;
+ *   ties broken by smaller |freq|, then by larger signed freq.
+ * - `'frequency'` (the iconic 3Blue1Brown look): `0, +1, -1, +2, -2, …`;
+ *   that is, smaller |freq| first, positive before negative within a |freq|.
+ *
+ * The input array is not mutated.
+ *
+ * @param coefficients - Coefficients to order.
+ * @param order - Ordering strategy. Default `'frequency'`.
+ * @returns A new, reordered array.
+ */
+export declare function orderCoefficients(coefficients: FourierCoefficient[], order?: FourierOrder): FourierCoefficient[];
+/**
+ * Options for {@link fourierSeriesApproximation}.
+ */
+export interface FourierSeriesApproximationOptions {
+    /** Length of one period in the function's domain. Default `2π`. */
+    period?: number;
+    /** Start of the sampled period in the domain. Default `0`. */
+    start?: number;
+    /** Number of harmonics (vectors) to keep, chosen by amplitude. Default: all. */
+    numTerms?: number;
+    /** Number of samples taken over one period. Default `256`. */
+    numSamples?: number;
+}
+/**
+ * Build the truncated Fourier approximation of a real periodic function.
+ *
+ * The function is sampled over one period, its discrete coefficients are
+ * computed, the `numTerms` largest are kept, and the returned function
+ * evaluates the real part of the partial sum at any `x`. With `numTerms`
+ * equal to the sample count the approximation reproduces the samples.
+ *
+ * @param func - The real periodic function `y = f(x)`.
+ * @param options - Period, sampling, and term-count options.
+ * @returns A function `x -> y` giving the truncated approximation.
+ */
+export declare function fourierSeriesApproximation(func: (x: number) => number, options?: FourierSeriesApproximationOptions): (x: number) => number;
+//# sourceMappingURL=fourier.d.ts.map

package/dist/mobjects/graphing/fourier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fourier.d.ts","sourceRoot":"","sources":["../../../src/mobjects/graphing/fourier.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAE9C;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAC;IACb,iFAAiF;IACjF,SAAS,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAC;CACf;AAED,mDAAmD;AACnD,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,WAAW,CAAC;AAIrD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,kBAAkB,EAAE,CA+B5E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,kBAAkB,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAExF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CACxB,YAAY,EAAE,kBAAkB,EAAE,EAClC,CAAC,EAAE,MAAM,EACT,QAAQ,EAAE,MAAM,GACf,OAAO,CAaT;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,kBAAkB,EAAE,EAClC,KAAK,GAAE,YAA0B,GAChC,kBAAkB,EAAE,CAiBtB;AAED;;GAEG;AACH,MAAM,WAAW,iCAAiC;IAChD,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gFAAgF;IAChF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,EAC3B,OAAO,GAAE,iCAAsC,GAC9C,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAgBvB"}

package/dist/mobjects/graphing/index.d.ts

@@ -16,11 +16,21 @@ export { sampleColormap, valueToColor, VIRIDIS, INFERNO, COOLWARM } from './colo
 export { marchingSquares, type ContourSegment } from './marchingSquares';
 export { HeatMap, type HeatMapOptions, type ScalarField2D } from './HeatMap';
 export { ContourPlot, type ContourPlotOptions, type ContourField } from './ContourPlot';
+export { DomainColoring, phasePortraitColor, type DomainColoringOptions, type ComplexFunction, type BrightnessScheme, } from './DomainColoring';
 export { ParametricFunction, type ParametricFunctionOptions } from './ParametricFunction';
 export { VectorFieldVector, type VectorFieldVectorOptions } from './Vector';
+export { fourierCoefficients, reconstructSample, partialSum, orderCoefficients, fourierSeriesApproximation, type FourierCoefficient, type FourierOrder, type FourierSeriesApproximationOptions, } from './fourier';
+export { FourierEpicycles, type FourierEpicyclesOptions, type FourierPathInput, type ComplexPathFunction, } from './FourierEpicycles';
+export { FourierSeries, type FourierSeriesOptions } from './FourierSeries';
 export { ComplexPlane, type ComplexPlaneOptions, type Complex } from './ComplexPlane';
 export { PolarPlane, type PolarPlaneOptions } from './ComplexPlane';
 export { BarChart, type BarChartOptions } from './BarChart';
+export { CandlestickChart, type CandlestickChartOptions, type OHLC } from './CandlestickChart';
 export { PieChart, type PieChartOptions, DonutChart, type DonutChartOptions, computeSliceGeometry, type SliceGeometry, type LabelPosition, } from './PieChart';
+export { mean, stdDev, quantile, iqr, histogramBins, kde, silvermanBandwidth, boxSummary, extent, niceAxisRange, type HistogramBin, type HistogramBinsOptions, type KdeOptions, type BoxSummary, } from './stats';
+export { Histogram, type HistogramOptions } from './Histogram';
+export { ScatterPlot, type ScatterPlotOptions } from './ScatterPlot';
+export { BoxPlot, type BoxPlotOptions, type PlotOrientation } from './BoxPlot';
+export { ViolinPlot, type ViolinPlotOptions, type ViolinDensity } from './ViolinPlot';
 export { VectorField, ArrowVectorField, StreamLines, stepVectorField, type Integrator, type VectorFunction, type ColorFunction, type VectorFieldBaseOptions, type ArrowVectorFieldOptions, type StreamLinesOptions, type ContinuousMotionOptions, } from './VectorField';
 //# sourceMappingURL=index.d.ts.map

package/dist/mobjects/graphing/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mobjects/graphing/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,UAAU,EACV,KAAK,iBAAiB,EACtB,YAAY,EACZ,KAAK,mBAAmB,GACzB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,IAAI,EAAE,KAAK,WAAW,EAAE,MAAM,QAAQ,CAAC;AAGhD,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAG3D,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAGtF,OAAO,EAAE,KAAK,2BAA2B,EAAE,KAAK,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAGjG,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,KAAK,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAG/F,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAG3E,OAAO,EAAE,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAGpF,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtF,OAAO,EAAE,eAAe,EAAE,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGzE,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AAG7E,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAGxF,OAAO,EAAE,kBAAkB,EAAE,KAAK,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAG1F,OAAO,EAAE,iBAAiB,EAAE,KAAK,wBAAwB,EAAE,MAAM,UAAU,CAAC;AAG5E,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,KAAK,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAGtF,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGpE,OAAO,EAAE,QAAQ,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAG5D,OAAO,EACL,QAAQ,EACR,KAAK,eAAe,EACpB,UAAU,EACV,KAAK,iBAAiB,EACtB,oBAAoB,EACpB,KAAK,aAAa,EAClB,KAAK,aAAa,GACnB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,eAAe,EACf,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC5B,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,GAC7B,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mobjects/graphing/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,UAAU,EACV,KAAK,iBAAiB,EACtB,YAAY,EACZ,KAAK,mBAAmB,GACzB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,IAAI,EAAE,KAAK,WAAW,EAAE,MAAM,QAAQ,CAAC;AAGhD,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAG3D,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAGtF,OAAO,EAAE,KAAK,2BAA2B,EAAE,KAAK,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAGjG,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,KAAK,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAG/F,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAG3E,OAAO,EAAE,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAGpF,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtF,OAAO,EAAE,eAAe,EAAE,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGzE,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AAG7E,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAGxF,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,KAAK,qBAAqB,EAC1B,KAAK,eAAe,EACpB,KAAK,gBAAgB,GACtB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,kBAAkB,EAAE,KAAK,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAG1F,OAAO,EAAE,iBAAiB,EAAE,KAAK,wBAAwB,EAAE,MAAM,UAAU,CAAC;AAG5E,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,UAAU,EACV,iBAAiB,EACjB,0BAA0B,EAC1B,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,iCAAiC,GACvC,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,gBAAgB,EAChB,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,GACzB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAG3E,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,KAAK,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAGtF,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGpE,OAAO,EAAE,QAAQ,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAG5D,OAAO,EAAE,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,KAAK,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAG/F,OAAO,EACL,QAAQ,EACR,KAAK,eAAe,EACpB,UAAU,EACV,KAAK,iBAAiB,EACtB,oBAAoB,EACpB,KAAK,aAAa,EAClB,KAAK,aAAa,GACnB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,IAAI,EACJ,MAAM,EACN,QAAQ,EACR,GAAG,EACH,aAAa,EACb,GAAG,EACH,kBAAkB,EAClB,UAAU,EACV,MAAM,EACN,aAAa,EACb,KAAK,YAAY,EACjB,KAAK,oBAAoB,EACzB,KAAK,UAAU,EACf,KAAK,UAAU,GAChB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,SAAS,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,WAAW,CAAC;AAC/E,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAGtF,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,eAAe,EACf,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC5B,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,GAC7B,MAAM,eAAe,CAAC"}

package/dist/mobjects/graphing/stats.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Pure statistics helpers for the statistical plot suite.
+ *
+ * These functions are side-effect free and operate on plain number arrays.
+ * They are reused by Histogram, ScatterPlot, BoxPlot and ViolinPlot.
+ *
+ * Degenerate inputs never throw:
+ * - Empty data returns NaN for scalar reducers and empty results for binning.
+ * - All-equal data returns a zero inter-quartile range and a zero-width spread.
+ */
+/** One bin of a histogram. */
+export interface HistogramBin {
+    /** Left edge of the bin (inclusive). */
+    x0: number;
+    /** Right edge of the bin (exclusive, except the last bin which is inclusive). */
+    x1: number;
+    /** Number of data values that fall in the bin. */
+    count: number;
+    /** Probability density: count / (total * binWidth). Area over all bins is 1. */
+    density: number;
+}
+/** Options for {@link histogramBins}. */
+export interface HistogramBinsOptions {
+    /** Number of equal-width bins. Ignored when binEdges is given. Default: 10 */
+    bins?: number;
+    /** Explicit bin edges (length n+1 for n bins). Overrides bins. */
+    binEdges?: number[];
+}
+/** Options for {@link kde}. */
+export interface KdeOptions {
+    /** Kernel bandwidth. Default: Silverman's rule of thumb. */
+    bandwidth?: number;
+}
+/**
+ * Arithmetic mean of the data.
+ * @returns NaN when data is empty.
+ */
+export declare function mean(data: number[]): number;
+/**
+ * Standard deviation of the data.
+ * @param sample - When true, divide by n-1 (sample). Default: false (population).
+ * @returns NaN when data is empty. 0 for a single population value.
+ */
+export declare function stdDev(data: number[], sample?: boolean): number;
+/**
+ * Linear-interpolated quantile (the numpy / R type-7 definition).
+ * @param data - The sample values (not required to be sorted).
+ * @param q - Quantile in [0, 1]. Values outside are clamped.
+ * @returns NaN when data is empty.
+ */
+export declare function quantile(data: number[], q: number): number;
+/**
+ * Inter-quartile range: quantile(0.75) - quantile(0.25).
+ * @returns NaN when data is empty. 0 when all values are equal.
+ */
+export declare function iqr(data: number[]): number;
+/**
+ * Bin raw data into a histogram.
+ *
+ * With computed edges, every value lands in a bin and the counts sum to the
+ * data length. The last bin includes its right edge. With explicit binEdges,
+ * values outside the edge range are dropped.
+ *
+ * @returns An array of bins, left to right. Empty when data is empty and no
+ *   explicit edges are given.
+ */
+export declare function histogramBins(data: number[], options?: HistogramBinsOptions): HistogramBin[];
+/**
+ * Smallest and largest values in an array.
+ * @returns [0, 0] when the array is empty.
+ */
+export declare function extent(values: number[]): [number, number];
+/**
+ * Build a padded [min, max, step] axis range that covers [dataMin, dataMax].
+ *
+ * The range is padded by 5% on each side. Equal or reversed bounds expand to a
+ * unit-wide window so a plot axis is never zero-width. The step divides the
+ * padded span into about `divisions` ticks.
+ *
+ * @param dataMin - Smallest data value.
+ * @param dataMax - Largest data value.
+ * @param divisions - Target tick count. Default: 5
+ */
+export declare function niceAxisRange(dataMin: number, dataMax: number, divisions?: number): [number, number, number];
+/**
+ * Silverman's rule-of-thumb bandwidth: 1.06 * sigma * n^(-1/5).
+ * @returns 0 when data has fewer than 2 points or zero spread.
+ */
+export declare function silvermanBandwidth(data: number[]): number;
+/**
+ * Build a Gaussian kernel-density estimator for the data.
+ *
+ * @returns A function that evaluates the estimated density at a point. The
+ *   estimator returns 0 everywhere when data is empty. Zero-spread data uses a
+ *   tiny positive bandwidth so the estimator stays finite and never divides by
+ *   zero.
+ */
+export declare function kde(data: number[], options?: KdeOptions): (x: number) => number;
+/**
+ * Compute box-plot summary statistics for one group of data.
+ *
+ * The whiskers extend to the most extreme data values still inside
+ * [Q1 - factor*IQR, Q3 + factor*IQR]. Values beyond the whiskers are outliers.
+ */
+export interface BoxSummary {
+    /** First quartile (25th percentile). */
+    q1: number;
+    /** Median (50th percentile). */
+    median: number;
+    /** Third quartile (75th percentile). */
+    q3: number;
+    /** Inter-quartile range (Q3 - Q1). */
+    iqr: number;
+    /** Lower whisker end (smallest datum >= Q1 - factor*IQR). */
+    whiskerLow: number;
+    /** Upper whisker end (largest datum <= Q3 + factor*IQR). */
+    whiskerHigh: number;
+    /** Data values outside the whiskers. */
+    outliers: number[];
+}
+/**
+ * Summarise a data group for a box plot.
+ * @param factor - Whisker length as a multiple of the IQR. Default: 1.5
+ * @returns A summary whose fields are NaN and whose outliers are empty when
+ *   data is empty.
+ */
+export declare function boxSummary(data: number[], factor?: number): BoxSummary;
+//# sourceMappingURL=stats.d.ts.map

package/dist/mobjects/graphing/stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../../src/mobjects/graphing/stats.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,8BAA8B;AAC9B,MAAM,WAAW,YAAY;IAC3B,wCAAwC;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,iFAAiF;IACjF,EAAE,EAAE,MAAM,CAAC;IACX,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAC;IACd,gFAAgF;IAChF,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,yCAAyC;AACzC,MAAM,WAAW,oBAAoB;IACnC,8EAA8E;IAC9E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,+BAA+B;AAC/B,MAAM,WAAW,UAAU;IACzB,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAK3C;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,MAAM,UAAQ,GAAG,MAAM,CAW7D;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAS1D;AAED;;;GAGG;AACH,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAG1C;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,oBAAyB,GAAG,YAAY,EAAE,CAwBhG;AAmCD;;;GAGG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CASzD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,SAAS,SAAI,GACZ,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAY1B;AAOD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAKzD;AAED;;;;;;;GAOG;AACH,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,UAAe,GAAG,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAWnF;AAED;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,wCAAwC;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,sCAAsC;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,6DAA6D;IAC7D,UAAU,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,WAAW,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,MAAM,SAAM,GAAG,UAAU,CAoCnE"}