music/exemplars/instruments/GROOVE_BANDS.json
{
"_doc": "per-purpose-class rhythm bands, derived from the corpus HITS on the AUDIO tier",
"instrument": "groove_instrument",
"version": "groove-instr/1.0",
"law": "A cue must carry a pulse a listener can feel -- present, steady, and articulated against the metre by voices that tile rather than pile -- so that its rhythm is a structure and never merely a rate.",
"generated_utc": "2026-08-08T20:07:00Z",
"available": true,
"provenance": {
"pool": "corpus rows whose status is ACQUIRED or CARDED (derive_patterns.label_rows), measured on the audio tier from the source files named on their own cards",
"n_hits_measured": 30,
"min_rows_for_a_class_band": 5,
"pooled_classes": [
"BOSS (n=2)",
"CREDITS_TRIUMPH (n=4)",
"MELANCHOLIC (n=4)",
"TENSION (n=3)",
"TITLE_CHARACTER (n=4)"
],
"pooled_note": "A class with fewer than five rows does NOT get its own band. Those classes route to POOLED_ALL_CLASSES, whose denominator is every measured hit regardless of class, and that pooling is a real loss of resolution rather than a technicality.",
"analysis_cap_s": 180.0,
"hop": 256,
"onset_delta": 0.15,
"onset_env_floor": 1.0,
"seed": 20260808,
"score_tier": "NO SCORE BANDS EXIST AND NONE ARE INVENTED. The corpus is audio only; we hold no scores for it. The score axes are reported against our own rounds and against groove.py's own library values, never against a corpus band.",
"forbidden_field": "tempo_and_time_grammar.groove.onset_rate_per_s is DEGENERATE (docs/spine/DECISIONS_PENDING_JOSH.md:5685-5691) and is read nowhere in this instrument; control C4 re-derives that degeneracy live on every --check."
},
"pooled_key": "POOLED_ALL_CLASSES",
"axes": [
"pulse_salience_audio",
"beat_consistency",
"syncopation_audio",
"offbeat_weight_share",
"onset_density_per_s",
"percussive_energy_share",
"low_band_pulse_regularity"
],
"classes": {
"BATTLE": {
"pulse_salience_audio": {
"n": 5,
"p10": 0.2795,
"p50": 0.4083,
"p90": 0.4525
},
"beat_consistency": {
"n": 5,
"p10": 0.9402,
"p50": 0.9605,
"p90": 0.9734
},
"syncopation_audio": {
"n": 5,
"p10": 0.0267,
"p50": 0.1333,
"p90": 0.1733
},
"offbeat_weight_share": {
"n": 5,
"p10": 0.16,
"p50": 0.5125,
"p90": 0.5667
},
"onset_density_per_s": {
"n": 5,
"p10": 0.2533,
"p50": 0.7331,
"p90": 3.1523
},
"percussive_energy_share": {
"n": 5,
"p10": 0.1323,
"p50": 0.1972,
"p90": 0.2574
},
"low_band_pulse_regularity": {
"n": 5,
"p10": 0.0931,
"p50": 0.1488,
"p90": 0.2187
}
},
"EXPLORATION": {
"pulse_salience_audio": {
"n": 8,
"p10": 0.1527,
"p50": 0.2883,
"p90": 0.518
},
"beat_consistency": {
"n": 8,
"p10": 0.9467,
"p50": 0.9793,
"p90": 0.9833
},
"syncopation_audio": {
"n": 8,
"p10": 0.0,
"p50": 0.05,
"p90": 0.1733
},
"offbeat_weight_share": {
"n": 8,
"p10": 0.2933,
"p50": 0.4,
"p90": 0.4657
},
"onset_density_per_s": {
"n": 8,
"p10": 0.5667,
"p50": 2.1091,
"p90": 3.4283
},
"percussive_energy_share": {
"n": 8,
"p10": 0.0289,
"p50": 0.072,
"p90": 0.2467
},
"low_band_pulse_regularity": {
"n": 8,
"p10": 0.0623,
"p50": 0.1275,
"p90": 0.1883
}
},
"POOLED_ALL_CLASSES": {
"pulse_salience_audio": {
"n": 30,
"p10": 0.0789,
"p50": 0.2631,
"p90": 0.5011
},
"beat_consistency": {
"n": 30,
"p10": 0.9294,
"p50": 0.9552,
"p90": 0.9833
},
"syncopation_audio": {
"n": 30,
"p10": 0.0,
"p50": 0.0667,
"p90": 0.2
},
"offbeat_weight_share": {
"n": 30,
"p10": 0.2,
"p50": 0.4,
"p90": 0.535
},
"onset_density_per_s": {
"n": 30,
"p10": 0.3579,
"p50": 0.9308,
"p90": 3.3591
},
"percussive_energy_share": {
"n": 30,
"p10": 0.0247,
"p50": 0.115,
"p90": 0.2779
},
"low_band_pulse_regularity": {
"n": 30,
"p10": 0.0643,
"p50": 0.1181,
"p90": 0.2188
}
}
}
}