LessonBundle

Loads a reference lesson bundle produced by the offline lesson-extractor into a ready LessonMaterial.

This is the runtime counterpart to the offline authoring tool: a client app points at a bundle directory and gets a LessonMaterial to hand straight to CalibraLiveEval / CalibraMelodyEval, with no pitch/chroma DSP at load time (the features are pre-computed).

Bundle layout (<dir>/)

  • reference-meta.jsonBundleManifest (tonic, geometry, lesson type, tempo)

  • reference-16k-mono.wav — 16 kHz mono reference audio (playback)

  • reference-pitch.tsv — pitch contour (SonixParser.parsePitchString)

  • reference-hpcp.bin — HPCP chroma frames (SonixParser.parseHpcp)

  • reference-phrases.json — phrases + note-level transcription (SonixParser.parseTransString); the segment source of truth

See also

The compute the bundle is built on.

Functions

Link copied to clipboard
fun load(directoryPath: String): LessonMaterial

Load a bundle directory into a LessonMaterial with pre-computed pitch contour and HPCP frames.