@libraz/libsonare 1.7.2 → 1.8.0

package/dist/feature_resample.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature_resample.d.ts","sourceRoot":"","sources":["../src/feature_resample.ts"],"names":[],"mappings":"AAUA;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,YAAY,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,YAAY,CAAC;AACjE,wBAAgB,QAAQ,CAAC,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY,CAAC"}

package/dist/feature_spectral.d.ts

@@ -0,0 +1,137 @@
+/**
+ * Frame-level spectral descriptors: the scalar shape measures taken per STFT
+ * frame, and the zero-crossing counts beside them.
+ */
+import type { WasmMatrix2dResult } from './sonare.js';
+/** Canonical request form for frame-based spectral feature extraction. */
+export interface SpectralFrameRequest {
+    samples: Float32Array;
+    sampleRate?: number;
+    nFft?: number;
+    hopLength?: number;
+}
+export interface SpectralRolloffRequest extends SpectralFrameRequest {
+    rollPercent?: number;
+}
+export interface ZeroCrossingRateRequest {
+    samples: Float32Array;
+    sampleRate?: number;
+    frameLength?: number;
+    hopLength?: number;
+}
+export interface SpectralContrastRequest extends SpectralFrameRequest {
+    nBands?: number;
+    fmin?: number;
+    quantile?: number;
+}
+export interface PolyFeaturesRequest extends SpectralFrameRequest {
+    order?: number;
+}
+export interface ZeroCrossingsRequest {
+    samples: Float32Array;
+    threshold?: number;
+    refMagnitude?: boolean;
+    pad?: boolean;
+    zeroPos?: boolean;
+}
+/**
+ * Compute spectral centroid (center of mass of spectrum).
+ *
+ * @param samples - Audio samples (mono, float32)
+ * @param sampleRate - Sample rate in Hz (default: 22050)
+ * @param nFft - FFT size (default: 2048)
+ * @param hopLength - Hop length (default: 512)
+ * @returns Spectral centroid in Hz for each frame
+ */
+export declare function spectralCentroid(request: SpectralFrameRequest): Float32Array;
+export declare function spectralCentroid(samples: Float32Array, sampleRate?: number, nFft?: number, hopLength?: number): Float32Array;
+/**
+ * Compute spectral contrast (librosa.feature.spectral_contrast).
+ *
+ * @remarks
+ * Band 0 spans `[0, fmin]`, so an `fmin` below one analysis bin
+ * (`sampleRate / nFft`) leaves it empty after the band trim. Row 0 is still
+ * finite, but comes from the other bands' extremes rather than from itself, and
+ * is neither level-invariant nor confined to the band. Keep `fmin` at or above
+ * one bin width for row 0 to mean anything — at the defaults (22050 Hz, 2048)
+ * one bin is 10.8 Hz, so only a small `nFft` or a tiny `fmin` reaches this.
+ *
+ * @returns Matrix2d of shape (nBands + 1) x nFrames.
+ */
+export declare function spectralContrast(request: SpectralContrastRequest): WasmMatrix2dResult;
+export declare function spectralContrast(samples: Float32Array, sampleRate?: number, nFft?: number, hopLength?: number, nBands?: number, fmin?: number, quantile?: number): WasmMatrix2dResult;
+/**
+ * Fit per-frame polynomial coefficients (librosa.feature.poly_features).
+ *
+ * @returns Matrix2d of shape (order + 1) x nFrames.
+ */
+export declare function polyFeatures(request: PolyFeaturesRequest): WasmMatrix2dResult;
+export declare function polyFeatures(samples: Float32Array, sampleRate?: number, nFft?: number, hopLength?: number, order?: number): WasmMatrix2dResult;
+/**
+ * Locate zero-crossing indices of a signal (librosa.zero_crossings).
+ */
+export declare function zeroCrossings(request: ZeroCrossingsRequest): Int32Array;
+export declare function zeroCrossings(samples: Float32Array, threshold?: number, refMagnitude?: boolean, pad?: boolean, zeroPos?: boolean): Int32Array;
+/**
+ * Compute spectral bandwidth.
+ *
+ * @param samples - Audio samples (mono, float32)
+ * @param sampleRate - Sample rate in Hz (default: 22050)
+ * @param nFft - FFT size (default: 2048)
+ * @param hopLength - Hop length (default: 512)
+ * @returns Spectral bandwidth in Hz for each frame
+ */
+export declare function spectralBandwidth(request: SpectralFrameRequest & {
+    p?: number;
+}): Float32Array;
+export declare function spectralBandwidth(samples: Float32Array, sampleRate?: number, nFft?: number, hopLength?: number, p?: number): Float32Array;
+/**
+ * Compute spectral rolloff frequency.
+ *
+ * @param samples - Audio samples (mono, float32)
+ * @param sampleRate - Sample rate in Hz (default: 22050)
+ * @param nFft - FFT size (default: 2048)
+ * @param hopLength - Hop length (default: 512)
+ * @param rollPercent - Percentage threshold (default: 0.85)
+ * @returns Rolloff frequency in Hz for each frame
+ */
+export declare function spectralRolloff(request: SpectralRolloffRequest): Float32Array;
+export declare function spectralRolloff(samples: Float32Array, sampleRate?: number, nFft?: number, hopLength?: number, rollPercent?: number): Float32Array;
+/**
+ * Compute spectral flatness.
+ *
+ * @param samples - Audio samples (mono, float32)
+ * @param sampleRate - Sample rate in Hz (default: 22050)
+ * @param nFft - FFT size (default: 2048)
+ * @param hopLength - Hop length (default: 512)
+ * @returns Spectral flatness for each frame (0 = tonal, 1 = noise-like)
+ */
+export declare function spectralFlatness(request: SpectralFrameRequest): Float32Array;
+export declare function spectralFlatness(samples: Float32Array, sampleRate?: number, nFft?: number, hopLength?: number): Float32Array;
+export declare function spectralFlux(request: SpectralFrameRequest & {
+    lag?: number;
+}): Float32Array;
+export declare function spectralFlux(samples: Float32Array, sampleRate?: number, nFft?: number, hopLength?: number, lag?: number): Float32Array;
+/**
+ * Compute zero crossing rate.
+ *
+ * @param samples - Audio samples (mono, float32)
+ * @param sampleRate - Sample rate in Hz (default: 22050)
+ * @param frameLength - Frame length (default: 2048)
+ * @param hopLength - Hop length (default: 512)
+ * @returns Zero crossing rate for each frame
+ */
+export declare function zeroCrossingRate(request: ZeroCrossingRateRequest): Float32Array;
+export declare function zeroCrossingRate(samples: Float32Array, sampleRate?: number, frameLength?: number, hopLength?: number): Float32Array;
+/**
+ * Compute RMS energy.
+ *
+ * @param samples - Audio samples (mono, float32)
+ * @param sampleRate - Sample rate in Hz (default: 22050)
+ * @param frameLength - Frame length (default: 2048)
+ * @param hopLength - Hop length (default: 512)
+ * @returns RMS energy for each frame
+ */
+export declare function rmsEnergy(request: ZeroCrossingRateRequest): Float32Array;
+export declare function rmsEnergy(samples: Float32Array, sampleRate?: number, frameLength?: number, hopLength?: number): Float32Array;
+//# sourceMappingURL=feature_spectral.d.ts.map

package/dist/feature_spectral.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature_spectral.d.ts","sourceRoot":"","sources":["../src/feature_spectral.ts"],"names":[],"mappings":"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"}

package/dist/feature_spectrogram.d.ts

@@ -0,0 +1,198 @@
+/**
+ * Spectrogram and chroma representations, and the silence trim that shares
+ * their input checks.
+ */
+import type { GuardedOptions } from './_feature_validation';
+import type { ChromaResult, MelSpectrogramResult, MfccResult, ReassignedSpectrogramResult, StftResult } from './public_types';
+/** Canonical request form for basic frame-based spectrogram features. */
+export interface SpectrogramRequest extends GuardedOptions {
+    samples: Float32Array;
+    sampleRate?: number;
+    nFft?: number;
+    hopLength?: number;
+}
+/**
+ * Options for the constant-Q chroma variants.
+ *
+ * Carries no `nFft`: these are built on a constant-Q transform, which resolves
+ * frequency through per-bin filter lengths rather than a framed FFT, so there
+ * is no FFT size to set. Use `chroma` for the STFT-framed chromagram.
+ */
+export interface ChromaSpectrogramRequest extends GuardedOptions {
+    samples: Float32Array;
+    sampleRate?: number;
+    hopLength?: number;
+    nChroma?: number;
+    binsPerOctave?: number;
+}
+/**
+ * Options for the bass-focused chroma.
+ *
+ * Unlike {@link ChromaSpectrogramRequest} this carries no `binsPerOctave`: the
+ * bass chroma fixes its bin count and its lowest frequency together, so the
+ * resolution is not independently settable through this entry point.
+ */
+export interface BassChromaSpectrogramRequest extends GuardedOptions {
+    samples: Float32Array;
+    sampleRate?: number;
+    hopLength?: number;
+    nChroma?: number;
+}
+export interface MelSpectrogramRequest extends SpectrogramRequest {
+    nMels?: number;
+    fmin?: number;
+    fmax?: number;
+    htk?: boolean;
+}
+export interface MfccRequest extends MelSpectrogramRequest {
+    nMfcc?: number;
+    lifter?: number;
+}
+export interface MelDeltaRequest extends GuardedOptions {
+    features: Float32Array;
+    nFeatures: number;
+    nFrames: number;
+    width?: number;
+}
+export interface ReassignedSpectrogramRequest extends SpectrogramRequest {
+    refPower?: number;
+    fillNan?: boolean;
+}
+export interface TrimRequest extends GuardedOptions {
+    samples: Float32Array;
+    sampleRate: number;
+    thresholdDb?: number;
+    frameLength?: number;
+    hopLength?: number;
+}
+/**
+ * Trim silence from beginning and end of audio.
+ *
+ * @param samples - Audio samples (mono, float32)
+ * @param sampleRate - Sample rate in Hz
+ * @param thresholdDb - Silence threshold in dB (default: -60 dB)
+ * @returns Trimmed audio
+ */
+export declare function trim(request: TrimRequest): Float32Array;
+export declare function trim(samples: Float32Array, sampleRate: number, thresholdDb?: number, options?: GuardedOptions): Float32Array;
+export declare function trim(samples: Float32Array, sampleRate: number, thresholdDb?: number, frameLength?: number, hopLength?: number, options?: GuardedOptions): Float32Array;
+/**
+ * Compute Short-Time Fourier Transform (STFT).
+ *
+ * @param samples - Audio samples (mono, float32)
+ * @param sampleRate - Sample rate in Hz (default: 22050)
+ * @param nFft - FFT size (default: 2048)
+ * @param hopLength - Hop length (default: 512)
+ * @returns STFT result with magnitude and power spectrograms
+ */
+export declare function stft(request: SpectrogramRequest): StftResult;
+export declare function stft(samples: Float32Array, sampleRate?: number, nFft?: number, hopLength?: number, options?: GuardedOptions): StftResult;
+/**
+ * Compute STFT and return magnitude in decibels.
+ *
+ * @param samples - Audio samples (mono, float32)
+ * @param sampleRate - Sample rate in Hz (default: 22050)
+ * @param nFft - FFT size (default: 2048)
+ * @param hopLength - Hop length (default: 512)
+ * @returns STFT result with dB values
+ */
+export declare function stftDb(request: SpectrogramRequest): {
+    nBins: number;
+    nFrames: number;
+    db: Float32Array;
+};
+export declare function stftDb(samples: Float32Array, sampleRate?: number, nFft?: number, hopLength?: number, options?: GuardedOptions): {
+    nBins: number;
+    nFrames: number;
+    db: Float32Array;
+};
+/**
+ * Compute Chroma Energy Normalized Statistics.
+ *
+ * @param samples - Audio samples (mono, float32)
+ * @param sampleRate - Sample rate in Hz (default: 22050)
+ * @param hopLength - Hop length (default: 512)
+ * @param nChroma - Number of chroma bins (default: 12)
+ * @returns Chroma result
+ */
+export declare function chromaCens(request: ChromaSpectrogramRequest): ChromaResult;
+export declare function chromaCens(samples: Float32Array, sampleRate?: number, hopLength?: number, nChroma?: number, binsPerOctave?: number, options?: GuardedOptions): ChromaResult;
+/**
+ * Compute a constant-Q chromagram (librosa.feature.chroma_cqt).
+ *
+ * @param samples - Audio samples (mono, float32)
+ * @param sampleRate - Sample rate in Hz (default: 22050)
+ * @param hopLength - Hop length (default: 512)
+ * @param nChroma - Number of chroma bins (default: 12)
+ * @returns Chroma result
+ */
+export declare function chromaCqt(request: ChromaSpectrogramRequest): ChromaResult;
+export declare function chromaCqt(samples: Float32Array, sampleRate?: number, hopLength?: number, nChroma?: number, binsPerOctave?: number, options?: GuardedOptions): ChromaResult;
+/**
+ * Compute low-frequency bass chroma.
+ *
+ * @param samples - Audio samples (mono, float32)
+ * @param sampleRate - Sample rate in Hz (default: 22050)
+ * @param hopLength - Hop length (default: 512)
+ * @param nChroma - Number of chroma bins (default: 12)
+ * @returns Chroma result
+ */
+export declare function bassChroma(request: BassChromaSpectrogramRequest): ChromaResult;
+export declare function bassChroma(samples: Float32Array, sampleRate?: number, hopLength?: number, nChroma?: number, options?: GuardedOptions): ChromaResult;
+/**
+ * Compute Mel spectrogram.
+ *
+ * @param samples - Audio samples (mono, float32)
+ * @param sampleRate - Sample rate in Hz (default: 22050)
+ * @param nFft - FFT size (default: 2048)
+ * @param hopLength - Hop length (default: 512)
+ * @param nMels - Number of Mel bands (default: 128)
+ * @param fmin - Minimum Mel frequency in Hz (default: 0 = librosa default).
+ *   Set with `fmax` to round-trip with `melToStft` / `melToAudio`.
+ * @param fmax - Maximum Mel frequency in Hz (default: 0 = sampleRate / 2)
+ * @param htk - Use the HTK Mel formula instead of Slaney (default: false)
+ * @returns Mel spectrogram result
+ */
+export declare function melSpectrogram(request: MelSpectrogramRequest): MelSpectrogramResult;
+export declare function melSpectrogram(samples: Float32Array, sampleRate?: number, nFft?: number, hopLength?: number, nMels?: number, fmin?: number, fmax?: number, htk?: boolean, options?: GuardedOptions): MelSpectrogramResult;
+/**
+ * Compute MFCC (Mel-Frequency Cepstral Coefficients).
+ *
+ * @param samples - Audio samples (mono, float32)
+ * @param sampleRate - Sample rate in Hz (default: 22050)
+ * @param nFft - FFT size (default: 2048)
+ * @param hopLength - Hop length (default: 512)
+ * @param nMels - Number of Mel bands (default: 128)
+ * @param nMfcc - Number of MFCC coefficients (default: 20)
+ * @param fmin - Minimum Mel frequency in Hz (default: 0 = librosa default)
+ * @param fmax - Maximum Mel frequency in Hz (default: 0 = sampleRate / 2)
+ * @param htk - Use the HTK Mel formula instead of Slaney (default: false)
+ * @param lifter - Cepstral liftering coefficient (default: 0 = no liftering)
+ * @returns MFCC result
+ */
+export declare function mfcc(request: MfccRequest): MfccResult;
+export declare function mfcc(samples: Float32Array, sampleRate?: number, nFft?: number, hopLength?: number, nMels?: number, nMfcc?: number, fmin?: number, fmax?: number, htk?: boolean, lifter?: number, options?: GuardedOptions): MfccResult;
+/** First-order regression delta of a row-major feature matrix. */
+export declare function melDelta(request: MelDeltaRequest): Float32Array;
+export declare function melDelta(features: Float32Array, nFeatures: number, nFrames: number, width?: number): Float32Array;
+/** Auger-Flandrin reassigned spectrogram (row-major [nBins x nFrames] arrays). */
+export declare function reassignedSpectrogram(request: ReassignedSpectrogramRequest): ReassignedSpectrogramResult;
+export declare function reassignedSpectrogram(samples: Float32Array, sampleRate?: number, nFft?: number, hopLength?: number, refPower?: number, fillNan?: boolean): ReassignedSpectrogramResult;
+/**
+ * Compute STFT chromagram (librosa.feature.chroma_stft).
+ *
+ * The chroma filterbank uses a fixed tuning of 0 (concert A440). Unlike
+ * librosa.feature.chroma_stft — which estimates tuning from the signal when none
+ * is given — this does NOT auto-estimate and takes no tuning argument. A
+ * tuning offset from {@link estimateTuning} is applied through `analyze`'s
+ * `tuning` option (and to chords through `detectChords`).
+ *
+ * @param samples - Audio samples (mono, float32)
+ * @param sampleRate - Sample rate in Hz (default: 22050)
+ * @param nFft - FFT size (default: 2048)
+ * @param hopLength - Hop length (default: 512)
+ * @returns Chroma features result
+ */
+export declare function chroma(request: SpectrogramRequest): ChromaResult;
+export declare function chroma(samples: Float32Array, sampleRate?: number, nFft?: number, hopLength?: number, options?: GuardedOptions): ChromaResult;
+//# sourceMappingURL=feature_spectrogram.d.ts.map

package/dist/feature_spectrogram.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature_spectrogram.d.ts","sourceRoot":"","sources":["../src/feature_spectrogram.ts"],"names":[],"mappings":"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"}

package/dist/features.d.ts

@@ -0,0 +1,10 @@
+export { amplitudeToDb, chirp, clicks, cyclicTempogram, dbToAmplitude, dbToPower, deemphasis, fixFrames, fixLength, frameSignal, framesToSamples, framesToTime, hzToMel, hzToMidi, hzToNote, melToHz, midiToHz, noteToHz, onsetBacktrack, padCenter, pcen, peakPick, plp, powerToDb, preemphasis, samplesToFrames, splitSilence, splitSilenceCommon, splitSilenceCommonWithReport, tempogram, timeToFrames, tone, tonnetz, trimSilence, vectorNormalize, } from './feature_core';
+export { decompose, decomposeStems, decomposeStemsLinked, decomposeWithInit, hpssWithResidual, nnFilter, remix, remixAlignedIntervals, segmentAgglomerative, segmentCrossSimilarity, segmentLagToRecurrence, segmentPathEnhance, segmentRecurrenceMatrix, segmentRecurrenceToLag, segmentSubsegment, } from './feature_decompose';
+export { griffinLim, melToAudio, melToStft, mfccToAudio, mfccToMel, phaseVocoder, } from './feature_inverse';
+export { ebur128LoudnessRange, lufsInterleaved, lufsSeriesInterleaved } from './feature_loudness';
+export { analyzeMelody, analyzeSections, cqt, cqtToAudio, detectBoundaries, fourierTempogram, hybridCqt, lufs, momentaryLufs, nnlsChroma, onsetEnvelope, onsetStrengthMulti, pseudoCqt, shortTermLufs, tempogramRatio, vqt, vqtToAudio, } from './feature_music';
+export { estimateTuning, noteSegments, piptrack, pitchPyin, pitchTuning, pitchYin, } from './feature_pitch';
+export { resample } from './feature_resample';
+export { polyFeatures, rmsEnergy, spectralBandwidth, spectralCentroid, spectralContrast, spectralFlatness, spectralFlux, spectralRolloff, zeroCrossingRate, zeroCrossings, } from './feature_spectral';
+export { bassChroma, chroma, chromaCens, chromaCqt, melDelta, melSpectrogram, mfcc, reassignedSpectrogram, stft, stftDb, trim, } from './feature_spectrogram';
+//# sourceMappingURL=features.d.ts.map

package/dist/features.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"features.d.ts","sourceRoot":"","sources":["../src/features.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,KAAK,EACL,MAAM,EACN,eAAe,EACf,aAAa,EACb,SAAS,EACT,UAAU,EACV,SAAS,EACT,SAAS,EACT,WAAW,EACX,eAAe,EACf,YAAY,EACZ,OAAO,EACP,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,QAAQ,EACR,cAAc,EACd,SAAS,EACT,IAAI,EACJ,QAAQ,EACR,GAAG,EACH,SAAS,EACT,WAAW,EACX,eAAe,EACf,YAAY,EACZ,kBAAkB,EAClB,4BAA4B,EAC5B,SAAS,EACT,YAAY,EACZ,IAAI,EACJ,OAAO,EACP,WAAW,EACX,eAAe,GAChB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,SAAS,EACT,cAAc,EACd,oBAAoB,EACpB,iBAAiB,EACjB,gBAAgB,EAChB,QAAQ,EACR,KAAK,EACL,qBAAqB,EACrB,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,EACtB,kBAAkB,EAClB,uBAAuB,EACvB,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,UAAU,EACV,UAAU,EACV,SAAS,EACT,WAAW,EACX,SAAS,EACT,YAAY,GACb,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAClG,OAAO,EACL,aAAa,EACb,eAAe,EACf,GAAG,EACH,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,SAAS,EACT,IAAI,EACJ,aAAa,EACb,UAAU,EACV,aAAa,EACb,kBAAkB,EAClB,SAAS,EACT,aAAa,EACb,cAAc,EACd,GAAG,EACH,UAAU,GACX,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,cAAc,EACd,YAAY,EACZ,QAAQ,EACR,SAAS,EACT,WAAW,EACX,QAAQ,GACT,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EACL,YAAY,EACZ,SAAS,EACT,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,aAAa,GACd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,UAAU,EACV,MAAM,EACN,UAAU,EACV,SAAS,EACT,QAAQ,EACR,cAAc,EACd,IAAI,EACJ,qBAAqB,EACrB,IAAI,EACJ,MAAM,EACN,IAAI,GACL,MAAM,uBAAuB,CAAC"}