Skip to content
HALOWERK

Tonwerk

enf analysis

Decodes up to 10 minutes to 1 kHz mono. The nominal grid (50 or 60 Hz) and the strongest of the first three harmonics are chosen by the peak-to-neighbourhood ratio in a Welch spectrum (4096 points, about 0.24 Hz). The chosen harmonic is demodulated to complex baseband (0.1 s blocks, 10 Hz rate); the frequency trace comes from 2 s Hann frames (0.5 s hop, zero-padded FFT, parabolic peak interpolation) divided by the harmonic number. Phase discontinuities are sudden steps in the baseband phase.

POST https://ton.halowerk.com/v1/enf-analysis

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
audio_base64stringNoAudio recording as base64 (at most 10 MiB decoded; a data: URL prefix is accepted). Formats: WAV/RF64/W64, AIFF, FLAC, MP3/MP2, AAC (ADTS, M4A/MP4), ALAC, Ogg Vorbis/Opus, WebM/Matroska, CAF, WavPack, APE, TTA, AMR, AU, AC-3/E-AC-3, DTS, WMA (ASF), AVI, MPEG-TS/PS, FLV; for video containers the first audio track is used.
audio_urlstringNoPublic http(s) URL of the audio recording (at most 10 MiB; private and local addresses are refused).
nominal_hzstringNoNominal mains frequency; auto chooses 50 or 60 Hz from the spectrum.
harmonicintegerNoHarmonic to track (1–3); 0 chooses the strongest.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "audio_base64": {
      "type": "string",
      "minLength": 16,
      "maxLength": 14000000,
      "description": "Audio recording as base64 (at most 10 MiB decoded; a data: URL prefix is accepted). Formats: WAV/RF64/W64, AIFF, FLAC, MP3/MP2, AAC (ADTS, M4A/MP4), ALAC, Ogg Vorbis/Opus, WebM/Matroska, CAF, WavPack, APE, TTA, AMR, AU, AC-3/E-AC-3, DTS, WMA (ASF), AVI, MPEG-TS/PS, FLV; for video containers the first audio track is used."
    },
    "audio_url": {
      "type": "string",
      "format": "uri",
      "maxLength": 2048,
      "description": "Public http(s) URL of the audio recording (at most 10 MiB; private and local addresses are refused)."
    },
    "nominal_hz": {
      "type": "string",
      "enum": [
        "auto",
        "50",
        "60"
      ],
      "default": "auto",
      "description": "Nominal mains frequency; auto chooses 50 or 60 Hz from the spectrum."
    },
    "harmonic": {
      "type": "integer",
      "minimum": 0,
      "maximum": 3,
      "default": 0,
      "description": "Harmonic to track (1–3); 0 chooses the strongest."
    }
  }
}

Open original schema

Published input example

{
  "audio_base64": "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"
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.

More endpoints in this hub

All endpoints in this hub →