@audio/spectral-flatness 1.0.0

package/README.md

@@ -0,0 +1,5 @@
+# @audio/spectral-flatness
+
+> Spectral flatness — 0..1 tonal vs noise (geometric/arithmetic mean ratio, Peeters 2004)
+
+Planned — not implemented yet. See the umbrella README for status and sources.

package/flatness.js

@@ -0,0 +1,12 @@
+// Spectral flatness — geometric/arithmetic mean ratio of the POWER spectrum, 0 (tonal) … 1 (noise).
+// Peeters 2004 §6.3; power spectrum per the audio-core fix.
+export default function flatness (mag) {
+	let n = mag.length
+	if (!n) return 0
+	let logSum = 0, sum = 0
+	for (let k = 0; k < n; k++) {
+		let p = mag[k] * mag[k] + 1e-12
+		logSum += Math.log(p); sum += p
+	}
+	return Math.exp(logSum / n) / (sum / n)
+}

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@audio/spectral-flatness",
+  "version": "1.0.0",
+  "description": "Spectral flatness — geometric/arithmetic mean ratio of the POWER spectrum, 0 (tonal) … 1 (noise).",
+  "type": "module",
+  "sideEffects": false,
+  "main": "flatness.js",
+  "exports": {
+    ".": "./flatness.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "flatness.js"
+  ],
+  "keywords": [
+    "audio",
+    "dsp",
+    "spectral",
+    "features",
+    "flatness"
+  ],
+  "license": "MIT",
+  "author": "Dmitry Iv. <dfcreative@gmail.com>",
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}