@thi.ng/dsp 4.6.16 → 4.6.18

package/serial.js

@@ -1,66 +1,65 @@
 import { AProc } from "./aproc.js";
-export function serial(...procs) {
-    const [a, b, c, d] = procs;
-    switch (procs.length) {
-        case 2:
-            return new Serial2(a, b);
-        case 3:
-            return new Serial3(a, b, c);
-        case 4:
-            return new Serial4(a, b, c, d);
-        default:
-            return new Serial(procs);
-    }
+function serial(...procs) {
+  const [a, b, c, d] = procs;
+  switch (procs.length) {
+    case 2:
+      return new Serial2(a, b);
+    case 3:
+      return new Serial3(a, b, c);
+    case 4:
+      return new Serial4(a, b, c, d);
+    default:
+      return new Serial(procs);
+  }
 }
-export class Serial2 extends AProc {
-    _a;
-    _b;
-    constructor(_a, _b) {
-        super(null);
-        this._a = _a;
-        this._b = _b;
-    }
-    next(x) {
-        return (this._val = this._b.next(this._a.next(x)));
-    }
+class Serial2 extends AProc {
+  constructor(_a, _b) {
+    super(null);
+    this._a = _a;
+    this._b = _b;
+  }
+  next(x) {
+    return this._val = this._b.next(this._a.next(x));
+  }
 }
-export class Serial3 extends AProc {
-    _a;
-    _b;
-    _c;
-    constructor(_a, _b, _c) {
-        super(null);
-        this._a = _a;
-        this._b = _b;
-        this._c = _c;
-    }
-    next(x) {
-        return (this._val = this._c.next(this._b.next(this._a.next(x))));
-    }
+class Serial3 extends AProc {
+  constructor(_a, _b, _c) {
+    super(null);
+    this._a = _a;
+    this._b = _b;
+    this._c = _c;
+  }
+  next(x) {
+    return this._val = this._c.next(this._b.next(this._a.next(x)));
+  }
 }
-export class Serial4 extends AProc {
-    _a;
-    _b;
-    _c;
-    _d;
-    constructor(_a, _b, _c, _d) {
-        super(null);
-        this._a = _a;
-        this._b = _b;
-        this._c = _c;
-        this._d = _d;
-    }
-    next(x) {
-        return (this._val = this._d.next(this._c.next(this._b.next(this._a.next(x)))));
-    }
+class Serial4 extends AProc {
+  constructor(_a, _b, _c, _d) {
+    super(null);
+    this._a = _a;
+    this._b = _b;
+    this._c = _c;
+    this._d = _d;
+  }
+  next(x) {
+    return this._val = this._d.next(
+      this._c.next(this._b.next(this._a.next(x)))
+    );
+  }
 }
-export class Serial extends AProc {
-    _procs;
-    constructor(_procs) {
-        super(null);
-        this._procs = _procs;
-    }
-    next(x) {
-        return (this._val = this._procs.reduce((x, p) => p.next(x), x));
-    }
+class Serial extends AProc {
+  constructor(_procs) {
+    super(null);
+    this._procs = _procs;
+  }
+  next(x) {
+    return this._val = this._procs.reduce((x2, p) => p.next(x2), x);
+  }
 }
+export {
+  Serial,
+  Serial2,
+  Serial3,
+  Serial4,
+  serial
+};

package/sincos.js

@@ -1,64 +1,48 @@
 import { TAU } from "@thi.ng/math/api";
 import { AGen } from "./agen.js";
-/**
- * Generator of sine & cosine values of given frequency in the form of
- * [sin,cos] tuples. Start phase always zero.
- *
- * @remarks
- * Implementation based on a self-oscillating SVF (state-variable
- * filter) without using any trig functions. Therefore, ~30% faster, but
- * precision only useful for very low (< ~2Hz) frequencies. Due to
- * floating point error accumulation, phase & amplitude drift will occur
- * for higher frequencies.
- *
- * References:
- * - http://www.earlevel.com/main/2003/03/02/the-digital-state-variable-filter/
- *
- * @param freq - normalized freq
- * @param amp - amplitude (default: 1)
- */
-export class SinCos extends AGen {
-    _freq;
-    _amp;
-    _f;
-    _s;
-    _c;
-    constructor(_freq, _amp = 1) {
-        super([0, _amp]);
-        this._freq = _freq;
-        this._amp = _amp;
-        this.calcCoeffs();
-    }
-    copy() {
-        return new SinCos(this._freq, this._amp);
-    }
-    reset() {
-        this.calcCoeffs();
-        return this;
-    }
-    next() {
-        this._val = [this._s, this._c];
-        this._s += this._f * this._c;
-        this._c -= this._f * this._s;
-        return this._val;
-    }
-    freq() {
-        return this._freq;
-    }
-    setFreq(freq) {
-        this._freq = freq;
-        this.calcCoeffs();
-    }
-    amp() {
-        return this._amp;
-    }
-    setAmp(amp) {
-        this._amp = amp;
-        this.calcCoeffs();
-    }
-    calcCoeffs() {
-        this._f = TAU * this._freq;
-        this._s = 0;
-        this._c = this._amp;
-    }
+class SinCos extends AGen {
+  constructor(_freq, _amp = 1) {
+    super([0, _amp]);
+    this._freq = _freq;
+    this._amp = _amp;
+    this.calcCoeffs();
+  }
+  _f;
+  _s;
+  _c;
+  copy() {
+    return new SinCos(this._freq, this._amp);
+  }
+  reset() {
+    this.calcCoeffs();
+    return this;
+  }
+  next() {
+    this._val = [this._s, this._c];
+    this._s += this._f * this._c;
+    this._c -= this._f * this._s;
+    return this._val;
+  }
+  freq() {
+    return this._freq;
+  }
+  setFreq(freq) {
+    this._freq = freq;
+    this.calcCoeffs();
+  }
+  amp() {
+    return this._amp;
+  }
+  setAmp(amp) {
+    this._amp = amp;
+    this.calcCoeffs();
+  }
+  calcCoeffs() {
+    this._f = TAU * this._freq;
+    this._s = 0;
+    this._c = this._amp;
+  }
 }
+export {
+  SinCos
+};

package/sum.js

@@ -1,6 +1,7 @@
 import { MapG2, MapG3 } from "./mapg.js";
-export function sum(a, b, c) {
-    return c
-        ? new MapG3((a, b, c) => a + b + c, a, b, c, 0)
-        : new MapG2((a, b) => a + b, a, b, 0);
+function sum(a, b, c) {
+  return c ? new MapG3((a2, b2, c2) => a2 + b2 + c2, a, b, c, 0) : new MapG2((a2, b2) => a2 + b2, a, b, 0);
 }
+export {
+  sum
+};

package/svf.js

@@ -1,83 +1,79 @@
 import { PI } from "@thi.ng/math/api";
 import { clamp05 } from "@thi.ng/math/interval";
 import { AProc } from "./aproc.js";
-export const svfLP = (fc, q) => new SVF("lp", fc, q);
-export const svfHP = (fc, q) => new SVF("hp", fc, q);
-export const svfBP = (fc, q) => new SVF("bp", fc, q);
-export const svfNotch = (fc, q) => new SVF("notch", fc, q);
-export const svfPeak = (fc, q) => new SVF("peak", fc, q);
-export const svfAllpass = (fc, q) => new SVF("all", fc, q);
-/**
- * Multi-type state variable filter w/ trapezoidal integration, after
- * Andrew Simper.
- *
- * Reference:
- *
- * - https://cytomic.com/files/dsp/SvfLinearTrapOptimised2.pdf
- * - https://en.wikipedia.org/wiki/Trapezoidal_rule
- */
-export class SVF extends AProc {
-    _type;
-    _freq;
-    _q;
-    _a1;
-    _a2;
-    _c1;
-    _c2;
-    _g;
-    _k;
-    constructor(_type, _freq, _q = 0.5) {
-        super(0);
-        this._type = _type;
-        this._freq = _freq;
-        this._q = _q;
-        this.reset();
-        this.computeCoeffs();
-    }
-    reset() {
-        this._c1 = this._c2 = this._val = 0;
-        return this;
-    }
-    next(x) {
-        const { _c1, _c2 } = this;
-        const x1 = this._a1 * _c1 + this._a2 * (x - _c2);
-        const x2 = _c2 + this._g * x1;
-        this._c1 = 2 * x1 - _c1;
-        this._c2 = 2 * x2 - _c2;
-        // TODO support type morphing / interpolation?
-        switch (this._type) {
-            case "lp":
-                return (this._val = x2);
-            case "hp":
-                return (this._val = x - this._k * x1 - x2);
-            case "bp":
-                return (this._val = x1);
-            case "notch":
-                return (this._val = x - this._k * x1);
-            case "peak":
-                return (this._val = 2 * x2 - x + this._k * x1);
-            case "all":
-                return (this._val = x - 2 * this._k * x1);
-        }
-    }
-    set(fc, q) {
-        this._freq = fc;
-        this._q = q;
-        this.computeCoeffs();
-    }
-    setFreq(fc) {
-        this._freq = fc;
-        this.computeCoeffs();
-    }
-    setQ(q) {
-        this._q = q;
-        this.computeCoeffs();
-    }
-    computeCoeffs() {
-        this._freq = clamp05(this._freq);
-        const g = (this._g = Math.tan(PI * this._freq));
-        this._k = 2 - 2 * this._q;
-        this._a1 = 1 / (1 + g * (g + this._k));
-        this._a2 = g * this._a1;
+const svfLP = (fc, q) => new SVF("lp", fc, q);
+const svfHP = (fc, q) => new SVF("hp", fc, q);
+const svfBP = (fc, q) => new SVF("bp", fc, q);
+const svfNotch = (fc, q) => new SVF("notch", fc, q);
+const svfPeak = (fc, q) => new SVF("peak", fc, q);
+const svfAllpass = (fc, q) => new SVF("all", fc, q);
+class SVF extends AProc {
+  constructor(_type, _freq, _q = 0.5) {
+    super(0);
+    this._type = _type;
+    this._freq = _freq;
+    this._q = _q;
+    this.reset();
+    this.computeCoeffs();
+  }
+  _a1;
+  _a2;
+  _c1;
+  _c2;
+  _g;
+  _k;
+  reset() {
+    this._c1 = this._c2 = this._val = 0;
+    return this;
+  }
+  next(x) {
+    const { _c1, _c2 } = this;
+    const x1 = this._a1 * _c1 + this._a2 * (x - _c2);
+    const x2 = _c2 + this._g * x1;
+    this._c1 = 2 * x1 - _c1;
+    this._c2 = 2 * x2 - _c2;
+    switch (this._type) {
+      case "lp":
+        return this._val = x2;
+      case "hp":
+        return this._val = x - this._k * x1 - x2;
+      case "bp":
+        return this._val = x1;
+      case "notch":
+        return this._val = x - this._k * x1;
+      case "peak":
+        return this._val = 2 * x2 - x + this._k * x1;
+      case "all":
+        return this._val = x - 2 * this._k * x1;
     }
+  }
+  set(fc, q) {
+    this._freq = fc;
+    this._q = q;
+    this.computeCoeffs();
+  }
+  setFreq(fc) {
+    this._freq = fc;
+    this.computeCoeffs();
+  }
+  setQ(q) {
+    this._q = q;
+    this.computeCoeffs();
+  }
+  computeCoeffs() {
+    this._freq = clamp05(this._freq);
+    const g = this._g = Math.tan(PI * this._freq);
+    this._k = 2 - 2 * this._q;
+    this._a1 = 1 / (1 + g * (g + this._k));
+    this._a2 = g * this._a1;
+  }
 }
+export {
+  SVF,
+  svfAllpass,
+  svfBP,
+  svfHP,
+  svfLP,
+  svfNotch,
+  svfPeak
+};

package/sweep.js

@@ -1,29 +1,6 @@
 import { addG } from "./addg.js";
 import { curve } from "./curve.js";
-/**
- * Similar to {@link curve}, but with added accumulation (via
- * {@link addG}). Systax sugar for `addg(curve(...))` and intended for
- * creating oscillator frequency sweeps. By default, the sweep speed is
- * clamped at the given `end` value.
- *
- * @example
- * ```ts
- * // render 2 sec osc sweep from 100 - 10000Hz
- * // FS = 44100
- * osc(
- *   sin,
- *   // freq & phase gen
- *   sweep(100 / FS, 10000 / FS, 2 * FS, 0.1),
- *   // amplitude gen / envelope
- *   adsr(0.5 * FS, 1.5 * FS, 0)
- * ).take(2 * fs)
- * // [...]
- * ```
- *
- * @param start -
- * @param end -
- * @param steps -
- * @param rate -
- * @param clamp - true, if clamp at `end` value
- */
-export const sweep = (start, end, steps, rate, clamp = true) => addG(curve(start, end, steps, rate, false, clamp));
+const sweep = (start, end, steps, rate, clamp = true) => addG(curve(start, end, steps, rate, false, clamp));
+export {
+  sweep
+};

package/waveshaper.js

@@ -1,63 +1,44 @@
 import { PI } from "@thi.ng/math/api";
 import { AProc } from "./aproc.js";
-/**
- * Customizable wave shaper for user defined shaping function supporting
- * one (optional, implementation specific) adjustable curve parameter.
- * By default uses {@link waveshapeTan} and supports configurable
- * curvature. Post-amplification is applied to the transformed result
- * value (see remarks).
- *
- * @remarks
- * If `amp` is `true` (default), the curve will be normalized such that
- * input values in the [-1 .. 1] range will be mapped to the same output
- * interval.
- *
- * The following wave shaping functions are supplied by default:
- *
- * - {@link waveshapeTan}
- * - {@link waveshapeSigmoid}
- * - {@link waveshapeSin}
- *
- * Interactive graph:
- * - https://www.desmos.com/calculator/hg4i7o836i
- *
- * @param thresh - fold threshold
- * @param amp - post amplifier / autogain flag
- */
-export const waveShaper = (thresh, amp, map) => new WaveShaper(thresh, amp, map);
-export class WaveShaper extends AProc {
-    _coeff;
-    _map;
-    _amp;
-    _autoGain;
-    constructor(_coeff = 3, amp = true, _map = waveshapeSigmoid) {
-        super(0);
-        this._coeff = _coeff;
-        this._map = _map;
-        amp === true ? this.setAutoGain() : this.setAmp(amp);
-    }
-    next(x) {
-        return (this._val = this._amp * this._map(x, this._coeff));
-    }
-    coeff() {
-        return this._coeff;
-    }
-    setCoeff(t) {
-        this._coeff = Math.max(t, 0);
-        this._autoGain && this.setAutoGain();
-    }
-    amp() {
-        return this._amp;
-    }
-    setAmp(a) {
-        this._amp = a;
-        this._autoGain = false;
-    }
-    setAutoGain() {
-        this._amp = 1 / this._map(1, this._coeff);
-        this._autoGain = true;
-    }
+const waveShaper = (thresh, amp, map) => new WaveShaper(thresh, amp, map);
+class WaveShaper extends AProc {
+  constructor(_coeff = 3, amp = true, _map = waveshapeSigmoid) {
+    super(0);
+    this._coeff = _coeff;
+    this._map = _map;
+    amp === true ? this.setAutoGain() : this.setAmp(amp);
+  }
+  _amp;
+  _autoGain;
+  next(x) {
+    return this._val = this._amp * this._map(x, this._coeff);
+  }
+  coeff() {
+    return this._coeff;
+  }
+  setCoeff(t) {
+    this._coeff = Math.max(t, 0);
+    this._autoGain && this.setAutoGain();
+  }
+  amp() {
+    return this._amp;
+  }
+  setAmp(a) {
+    this._amp = a;
+    this._autoGain = false;
+  }
+  setAutoGain() {
+    this._amp = 1 / this._map(1, this._coeff);
+    this._autoGain = true;
+  }
 }
-export const waveshapeTan = (x, k) => Math.atan(k * x) / k;
-export const waveshapeSigmoid = (x, k) => 2 / (1 + Math.exp(-k * x)) - 1;
-export const waveshapeSin = (x, k) => Math.sin((PI / k) * x);
+const waveshapeTan = (x, k) => Math.atan(k * x) / k;
+const waveshapeSigmoid = (x, k) => 2 / (1 + Math.exp(-k * x)) - 1;
+const waveshapeSin = (x, k) => Math.sin(PI / k * x);
+export {
+  WaveShaper,
+  waveShaper,
+  waveshapeSigmoid,
+  waveshapeSin,
+  waveshapeTan
+};

package/white-noise.js

@@ -1,26 +1,20 @@
 import { SYSTEM } from "@thi.ng/random/system";
 import { AGen } from "./agen.js";
-/**
- * White noise gen with customizable gain and
- * [`IRandom`](https://docs.thi.ng/umbrella/random/interfaces/IRandom.html)
- * source.
- *
- * @param gain -
- * @param rnd -
- */
-export const whiteNoise = (gain, rnd) => new WhiteNoise(gain, rnd);
-export class WhiteNoise extends AGen {
-    _gain;
-    _rnd;
-    constructor(_gain = 1, _rnd = SYSTEM) {
-        super(0);
-        this._gain = _gain;
-        this._rnd = _rnd;
-    }
-    reset() {
-        return this;
-    }
-    next() {
-        return (this._val = this._rnd.norm(this._gain));
-    }
+const whiteNoise = (gain, rnd) => new WhiteNoise(gain, rnd);
+class WhiteNoise extends AGen {
+  constructor(_gain = 1, _rnd = SYSTEM) {
+    super(0);
+    this._gain = _gain;
+    this._rnd = _rnd;
+  }
+  reset() {
+    return this;
+  }
+  next() {
+    return this._val = this._rnd.norm(this._gain);
+  }
 }
+export {
+  WhiteNoise,
+  whiteNoise
+};