dbfs
result = dbfs(x, [full_scale=1.0])
Input: x, full_scale · Output: result
What it is
Peak level relative to full scale: 20*log10(peak(abs(x)) / full_scale). x is a scalar, Vec, or Mat/Signal, flattened; full_scale (optional number, default 1.0) must be positive. An uncalibrated digital signal can answer in dBFS with no physical unit attached — anything past that (dB SPL, a sensitivity-based unit) needs a calibration this engine does not carry yet.
Overloads
One call shape — this function is not overloaded.
| Code | Input | Output | Description |
result = dbfs(x, [full_scale=1.0]) | x scalar, Vec, Mat, or Signalx is a scalar, Vec, or Mat/Signal, flattened.full_scale number, optional (default 1.0)full_scale (optional number, default 1.0) must be positive. | result scalar, Num, or vector | Returns a scalar Num. Errors on an empty vector. |
Examples
No documentation example calls this form yet. The Core maths chapter is where one belongs.
How it works
dbfs(x, [full_scale=1.0]) -- peak level relative to full scale, 20*log10(peak(abs(x)) / full_scale). An uncalibrated digital signal can answer in dBFS with no physical unit attached; anything past that (dB SPL, dB relative to a sensitivity) needs a calibration this engine does not carry yet, so dbfs stops exactly where that would start.
From the note above this builtin in the interpreter, where the reasoning was written down as it was built.