cantor-digitalis 0.0.2 → 0.0.4

package/README.md

@@ -83,6 +83,48 @@ Additionally, the synthesizer exposes `AudioParam` objects for the synth-level p
 | `vocalTractSize` | 0–1 | Vocal tract scaling (child to giant) |
 | `isFalsetto` | bool | Laryngeal mechanism (M1/M2) |
 
+### Custom Vowel Tables
+
+You may notice that the synthesizer sings with a french accent. The default vowels are the French vowel sounds from the research paper. The frequency and bandwidths of the formants for each vowel can change the character of the produced sound significantly. You can provide a custom vowel table, mapping locations in vowel space to a set of formant frequencies, amplitudes, and bandwidths. You can source these from other research papers, or analyze the formant frequencies of recorded vowel sounds using tools like [Praat](https://www.fon.hum.uva.nl/praat/).
+
+```typescript
+import { generateSynthParams, VowelTable, defaultVowelTable } from "cantor-digitalis";
+
+// Create a custom vowel table
+const customTable: VowelTable = {
+  vowels: [
+    {
+      ipa: "a",
+      h: 0.5,  // backness: 0 = back, 1 = front
+      v: 1,    // height: 0 = close, 1 = open
+      formants: [
+        { frequency: 700, amplitude: 0, bandwidth: 100 },
+        { frequency: 1200, amplitude: -3, bandwidth: 120 },
+        { frequency: 2500, amplitude: -10, bandwidth: 150 },
+        { frequency: 3500, amplitude: -15, bandwidth: 200 },
+        { frequency: 4500, amplitude: -20, bandwidth: 250 },
+        { frequency: 5500, amplitude: -25, bandwidth: 300 },
+      ],
+    },
+    {
+      ipa: "i",
+      h: 1, v: 0,
+      formants: [/* ... */],
+    },
+    {
+      ipa: "u",
+      h: 0, v: 0,
+      formants: [/* ... */],
+      volumeAdjustment: -5, // optional: balance overall amplitude for this vowel
+    },
+  ],
+  idwPower: 2,  // optional: interpolation sharpness (default: 2)
+};
+
+// Use with generateSynthParams
+const synthParams = generateSynthParams(params, { vowelTable: customTable });
+```
+
 ### Synth Parameters
 
 These low-level parameters directly control the audio processing and correspond to the physical/acoustic properties in the research paper.
@@ -159,6 +201,26 @@ formant.out.connect(ctx.destination);
 pulseTrain.start();
 ```
 
+## Frequency Response Analysis
+
+All nodes provide `getFrequencyResponse(frequencies, sampleRate)` for computing magnitude response at specified frequencies, useful for visualisation and analysis.
+
+```typescript
+import { linearToDb } from "cantor-digitalis";
+
+// Generate log-spaced frequencies from 20 Hz to 20 kHz
+const frequencies = Array.from({ length: 500 }, (_, i) => 20 * Math.pow(1000, i / 499));
+
+// Get response from the complete voice...
+const voiceResponse = voice.getFrequencyResponse(frequencies, ctx.sampleRate);
+// ...or individual components
+const tractResponse = voice.tract.getFrequencyResponse(frequencies, ctx.sampleRate);
+const f1Response = voice.tract.formants[0].getFrequencyResponse(frequencies, ctx.sampleRate);
+
+// Convert to dB for plotting
+const responseDb = linearToDb(voiceResponse);
+```
+
 ## License
 
 ISC

package/dist/index.d.ts

@@ -7,10 +7,9 @@
  * @packageDocumentation
  */
 export { Voice } from "./nodes/voice";
-export { generateSynthParams } from "./parameters";
-export type { PerceptualParams, SynthParams, SynthFormant, SynthFeatures } from "./parameters";
-export { interpolateFormants, vowels } from "./parameters/vowels";
-export type { Formant, VowelData } from "./parameters/vowels";
+export { generateSynthParams, defaultVowelTable } from "./parameters";
+export type { PerceptualParams, SynthParams, SynthFormant, SynthOptions, SynthFeatures, VowelTable, VowelData, Formant, } from "./parameters";
+export { interpolateFormants } from "./parameters/vowels";
 export type { Node } from "./nodes/types";
 export { GlottalFlowDerivative } from "./nodes/glottal-flow-derivative";
 export type { GlottalFlowDerivativeParams } from "./nodes/glottal-flow-derivative";
@@ -32,4 +31,5 @@ export { AntiResonance } from "./nodes/anti-resonance";
 export type { AntiResonanceParams } from "./nodes/anti-resonance";
 export { Gain } from "./nodes/gain";
 export type { GainParams } from "./nodes/gain";
+export { evaluateBiquad, evaluateFirstOrder, linearToDb, combineSeries, combineParallel, } from "./utils/frequency-response";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAGtC,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAG/F,OAAO,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClE,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAG9D,YAAY,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAG1C,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AACxE,YAAY,EAAE,2BAA2B,EAAE,MAAM,iCAAiC,CAAC;AAEnF,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,YAAY,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,YAAY,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,YAAY,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAEpE,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,YAAY,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEhE,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,YAAY,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,YAAY,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,YAAY,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAExE,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,YAAY,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAElE,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACpC,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAGtC,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACtE,YAAY,EACV,gBAAgB,EAChB,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,UAAU,EACV,SAAS,EACT,OAAO,GACR,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAG1D,YAAY,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAG1C,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AACxE,YAAY,EAAE,2BAA2B,EAAE,MAAM,iCAAiC,CAAC;AAEnF,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,YAAY,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,YAAY,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,YAAY,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAEpE,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,YAAY,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEhE,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,YAAY,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,YAAY,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,YAAY,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAExE,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,YAAY,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAElE,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACpC,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG/C,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,UAAU,EACV,aAAa,EACb,eAAe,GAChB,MAAM,4BAA4B,CAAC"}