Frequency Analyzer

Frequency Analyzer operator properties for Script Engine. Verifies that the incoming audio is a clean sine wave at a specific target frequency, without changing the audio. Useful as an automated test signal verifier — for example confirming that a 1 kHz reference tone is making it through the audio chain at the right frequency, with the right shape, and at a sufficient level. Reports the measured frequency, a match flag, and a consistency percentage.

Property	Type	Access	Description
`Frequency`	`int`	`get/set`	Target frequency to verify, in Hz. [min=50, max=5000, default=1000]. 1000 Hz is the standard EBU/SMPTE reference tone. Set to whatever pitch your test signal is supposed to have.
`FrequencyTolerance`	`int`	`get/set`	How many Hz the measured frequency may deviate from `Frequency` and still count as a match. [min=1, max=100, default=20]. Tighter tolerances catch small drift but can flag a perfectly good source if its frequency isn't perfectly stable.
`ShapeTolerance`	`float`	`get/set`	Strictness of the sine-wave shape check. [min=0.1, max=20, default=0.1]. Lower values demand a near-perfect sine; higher values accept some distortion. Use stricter values when verifying a clean test tone.
`MinAmplitudeDb`	`float`	`get/set`	Lowest signal level that counts as a real signal, in decibels. [min=-36, max=0, default=-12]. Audio quieter than this is treated as silence or background noise and ignored. Stops the analyzer from reporting a "sine wave" detection on a near-silent input.
`AnalysisWindowSeconds`	`int`	`get/set`	Time window over which consistency and average frequency are calculated, in seconds. [min=1, max=60, default=1]. Shorter windows respond faster to changes in the input; longer windows give a more stable consistency reading at the cost of slower reaction.
`ActualFrequency`	`int`	`get`	Average frequency detected on the input, in Hz (read-only). Averaged over `AnalysisWindowSeconds`. Compare against `Frequency` to see how close the input is to the target.
`IsMatch`	`bool`	`get`	True when the input matches the target frequency, shape, and level (read-only). Useful from a script to react to verification — for example, log an alert when the expected tone disappears or fails to meet quality.
`ConsistencyPercentage`	`int`	`get`	Percentage of the analysis window that matched the target, 0–100 (read-only). 100 means every measurement in the window was a match; lower values indicate the signal drifted in and out of spec during the window.
`ResetCommand`	`Command`	`get`	Reset all settings to their defaults (1000 Hz, ±20 Hz, strict shape, −12 dB minimum, 1 s window).

Inherits from: AbstractAudioOperator, AbstractOperator, AbstractAudioMetering.

See also: Frequency Analyzer in Operators — user-facing introduction, screenshots, and section summaries.