Sound Zoom Diff
sound_zoom_diffPinpoints where a test audio render differs from reference takes beyond their natural spread, listing hot-spot text and outlining spots in a PNG. Use it to locate wrong word parts or verify fixes.
Instructions
Where a sound differs from what it should match, beyond the reference's own take-to-take spread: hot-spot text first (scale, band, quarter of the word, brighter or darker, z, the control rate in the same cell), then a PNG (at most 1600 px) of the test above the anchor take with the spots outlined. Reach for it when you need to find where my render, synth or copy differs from the real takes, which part of a word is wrong, or whether a fix closed a spot. test: the source under test; refs: >= 3 sources, takes of the same words (3 give the spread; a 4th makes the own-source control: each take in the test's place, judged by the takes that are neither). With 3 the spots are listed uncontrolled and none is counted; with fewer it refuses, as there is no absolute threshold to fall back on. seconds: [t0, t1] of the word in test (s in the file; None = the whole file); ref_seconds: one [t0, t1] per ref (default: test's, for a clip timed from a take). anchor: the ref the test is compared with. f_lo/f_hi: list spots only in this band (Hz). level_lufs: every clip is set to this loudness first, then kept under a 0.89 peak (whole file, vox's loud at -25 LUFS); None when you level-matched them yourself. Cut long files to the line first: the level match and the spread assume one line of words. Measured on power (blur and band means of power, then dB), never on mean of dB. z is in units of the reference's own spread per time-frequency cell, at three scales: grain (cells), strokes, plumes. A spot counts only where the control lights its cell less often than the test does; every spot shows its control rate and whether it is beyond every control spot in that cell. debias=True removes a smooth per-band offset, so a deficit across a whole band is absorbed and does not show as a spot: for a band-wide level run debias=False or read region_measure on the band. params: zoom.DEFAULTS overrides (z_thr, min_cells, top_spots, ...); the defaults are the tested method.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| out | No | ||
| top | No | ||
| f_hi | No | ||
| f_lo | No | ||
| refs | Yes | ||
| test | Yes | ||
| word | No | ||
| anchor | No | ||
| debias | No | ||
| params | No | ||
| project | Yes | ||
| seconds | No | ||
| level_lufs | No | ||
| ref_seconds | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |