@danielsimonjr/mathts-functions 0.33.0 → 0.34.0

package/dist/signal-filter-extra.d.ts

@@ -1,4 +1,12 @@
+/**
+ * Digital filter design + application (Wave D / remaining). FIR window design
+ * (`firwin`), IIR Butterworth design (`butter`), the direct-form filter (`lfilter`),
+ * and zero-phase filtering (`filtfilt`). Matches `scipy.signal`. `butter` reuses the
+ * core `Complex` type for the analog-pole bilinear-transform pipeline.
+ */
+import { Complex } from '@danielsimonjr/mathts-core';
 type Vec = readonly number[] | Float64Array;
+export declare const sinc: (x: number) => number;
 /**
  * FIR lowpass filter coefficients by the windowed-sinc method (Hamming window,
  * normalized to unit DC gain) — `scipy.signal.firwin(numtaps, cutoff)` with the
@@ -22,12 +30,43 @@ export declare function lfilterZi(b: Vec, a: Vec): number[];
  * magnitude response is applied with no phase distortion.
  */
 export declare function filtfilt(b: Vec, a: Vec, x: Vec): number[];
+export declare const cAdd: (p: Complex, q: Complex) => Complex;
+export declare const cSub: (p: Complex, q: Complex) => Complex;
+export declare const cMul: (p: Complex, q: Complex) => Complex;
+export declare const cDiv: (p: Complex, q: Complex) => Complex;
+/** Scale a Complex by a real number (`Complex.mul` only accepts `Scalar`, not `number`). */
+export declare const cScale: (p: Complex, s: number) => Complex;
+/** Real polynomial coefficients (highest degree first) of ∏(x − rₖ). */
+export declare function polyFromRoots(roots: Complex[]): number[];
+/** Analog lowpass prototype: zeros, poles, gain (cutoff normalized to 1 rad/s). */
+export interface AnalogProto {
+    z: Complex[];
+    p: Complex[];
+    k: number;
+}
+export type FilterBtype = 'low' | 'high' | 'bandpass' | 'bandstop';
+/** zpk → transfer-function coefficients (scipy `zpk2tf`). */
+export declare function zpkToTf(z: Complex[], p: Complex[], k: number): {
+    b: number[];
+    a: number[];
+};
+/**
+ * Digital IIR filter design pipeline shared by butter/cheby1/cheby2/ellip:
+ * pre-warp `Wn` → frequency-transform the analog lowpass prototype (`proto`,
+ * cutoff normalized to 1 rad/s) to the requested `btype` → bilinear transform →
+ * zpk2tf. Matches `scipy.signal.iirfilter`'s internal pipeline (fs = 2 convention).
+ */
+export declare function analogToDigital(proto: AnalogProto, Wn: number | readonly number[], btype: FilterBtype): {
+    b: number[];
+    a: number[];
+};
 /**
  * Butterworth IIR filter design — returns `{ b, a }` transfer-function coefficients.
- * `N` is the order, `Wn` the cutoff normalized to Nyquist (0..1). Lowpass only
- * (`btype='low'`, the common case). Matches `scipy.signal.butter(N, Wn)`.
+ * `N` is the order, `Wn` the cutoff (scalar) or `[low, high]` band edges, normalized
+ * to Nyquist (0..1). `btype` defaults to `'low'` (matches the original 2-arg call
+ * unchanged). Matches `scipy.signal.butter(N, Wn, btype)`.
  */
-export declare function butter(N: number, Wn: number): {
+export declare function butter(N: number, Wn: number | readonly number[], btype?: FilterBtype): {
     b: number[];
     a: number[];
 };

package/dist/signal-filter-extra.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"signal-filter-extra.d.ts","sourceRoot":"","sources":["../src/signal-filter-extra.ts"],"names":[],"mappings":"AAYA,KAAK,GAAG,GAAG,SAAS,MAAM,EAAE,GAAG,YAAY,CAAC;AAK5C;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAahE;AAkCD;;;GAGG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,GAAG,MAAM,EAAE,CAExD;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,GAAG,MAAM,EAAE,CAqBlD;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,GAAG,MAAM,EAAE,CAqBzD;AAuBD;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG;IAAE,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CA4B1E"}
+{"version":3,"file":"signal-filter-extra.d.ts","sourceRoot":"","sources":["../src/signal-filter-extra.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAMrD,KAAK,GAAG,GAAG,SAAS,MAAM,EAAE,GAAG,YAAY,CAAC;AAG5C,eAAO,MAAM,IAAI,GAAI,GAAG,MAAM,KAAG,MAA+D,CAAC;AAEjG;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAahE;AAkCD;;;GAGG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,GAAG,MAAM,EAAE,CAExD;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,GAAG,MAAM,EAAE,CAuBlD;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,GAAG,MAAM,EAAE,CA+BzD;AAMD,eAAO,MAAM,IAAI,GAAI,GAAG,OAAO,EAAE,GAAG,OAAO,KAAG,OAAmB,CAAC;AAClE,eAAO,MAAM,IAAI,GAAI,GAAG,OAAO,EAAE,GAAG,OAAO,KAAG,OAAmB,CAAC;AAClE,eAAO,MAAM,IAAI,GAAI,GAAG,OAAO,EAAE,GAAG,OAAO,KAAG,OAAwB,CAAC;AACvE,eAAO,MAAM,IAAI,GAAI,GAAG,OAAO,EAAE,GAAG,OAAO,KAAG,OAAsB,CAAC;AACrE,4FAA4F;AAC5F,eAAO,MAAM,MAAM,GAAI,GAAG,OAAO,EAAE,GAAG,MAAM,KAAG,OAAqC,CAAC;AAErF,wEAAwE;AACxE,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,MAAM,EAAE,CAWxD;AAED,mFAAmF;AACnF,MAAM,WAAW,WAAW;IAC1B,CAAC,EAAE,OAAO,EAAE,CAAC;IACb,CAAC,EAAE,OAAO,EAAE,CAAC;IACb,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,MAAM,GAAG,UAAU,GAAG,UAAU,CAAC;AAoFnE,6DAA6D;AAC7D,wBAAgB,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG;IAAE,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAE3F;AAgBD;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,WAAW,EAClB,EAAE,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,EAC9B,KAAK,EAAE,WAAW,GACjB;IAAE,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAgB9B;AAaD;;;;;GAKG;AACH,wBAAgB,MAAM,CACpB,CAAC,EAAE,MAAM,EACT,EAAE,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,EAC9B,KAAK,GAAE,WAAmB,GACzB;IAAE,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAG9B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@danielsimonjr/mathts-functions",
-  "version": "0.33.0",
+  "version": "0.34.0",
   "description": "Mathematical functions for MathTS - arithmetic, algebra, trigonometry, statistics, and more",
   "author": "Daniel Simon Jr.",
   "license": "MIT",