memlnaut-nisps/schemas/modes/breakor.json

78 lines
8.2 KiB
JSON
Raw Normal View History

{
"$schema": "../schema.json",
"_note": "56-param drum-machine sequencer (NSEQUENCES=8, 7 ratio-seq params each: 3 ratios + phasor mul + phase offset + 2 amp ratios). No audio engine — emits MIDI notes (kick=36, snare=37, etc.) and i2c triggers. BPM and clock-mode handled outside ML control. No voice spaces.",
"mode_id": "breakor",
"engine_id": "breakor",
"ml": {
"input_channels": ["joy_x", "joy_y", "joy_z", "joy_w"],
"input_size": 4,
"hidden_layers": [10, 14, 18],
"output_size": 56,
refactor(ml): one runtime-configurable training default (S26) The operator's call: "there should be one default learning rate and one default max iterations and they should both be configurable at runtime." There were SIX copies, not the four the audit described, and they did not agree: nisps/ml/mlp.hpp no-arg train() hardcoding 1.f / 1000u / 0.001f — and firmware's ONLY training path calls exactly this, so firmware had no runtime knob at all wasm-iml.ts train() and trainAsync() TS default params (x2) engine-api.ts learningRate ?? 1.0, with no maxIterations knob vcv/src/iml.hpp 200 / 0.1 / 0.00001 — silently divergent external_synth_midi.hpp its own kDefaultLearningRate/kDefaultMaxIterations schemas/modes/*.json x9, identical, read by nobody at runtime Now: schemas/ml_defaults.json is the single declaration (validated against a sibling meta-schema, matching the midi_device.schema.json convention), codegen emits it to C++ and TS in the same run, and MLPCore carries a TrainConfig whose default member initialisers read the generated constant. set_train_config()/nisps_ml_set_train_config() make it runtime-overridable on every target; the explicit-argument train() overload is untouched. min_error joins the tuple — it was duplicated identically and belongs with the other two. The per-mode ml block loses default_learning_rate/default_max_iterations. default_spread stays (genuinely wired on both targets) and input_channels stays (codegen-time validated, real information for sound_analysis_midi). VCV BEHAVIOUR CHANGE, deliberate: MEMLNaut.cpp constructs IML positionally and relies on those defaults, so the module moves to 1000/1.0/0.001 — 5x the max iterations, 10x the learning rate, and a 100x looser early-stop threshold. The old values were never justified anywhere; they arrived with fbc68eb alongside an unrelated module rewrite and no tuning rationale. Firmware and WASM have shipped 1.0/1000 all along. It is now runtime-settable if this turns out worse. The generated header lands in nisps/ml/generated/, not nisps/modes/generated/ where the rest of codegen output lives: training hyperparameters are an ML fact, and nisps/ml sits below nisps/modes, so emitting them there would make mlp.hpp include upward. The agent that built this flagged the directory-crossing rather than hiding it; this is the fix. CI's generated-freshness gate learns the new directory. Gates: run-all-tests.sh ALL GREEN — 4/4 ctest, parity PASS (max delta 2.38e-7), lint clean, manifold typecheck + 17 unit + 33 e2e (which exercise train() and trainAsync() through a real browser).
2026-07-21 17:20:10 +02:00
"default_spread": 0.6
},
"params": [
{ "name": "kick_ratio0", "label": "Kick Ratio 0", "min": 0.0, "max": 1.0, "default": 0.5, "curve": "linear", "group": "kick" },
{ "name": "kick_ratio1", "label": "Kick Ratio 1", "min": 0.0, "max": 1.0, "default": 0.5, "curve": "linear", "group": "kick" },
{ "name": "kick_ratio2", "label": "Kick Ratio 2", "min": 0.0, "max": 1.0, "default": 0.5, "curve": "linear", "group": "kick" },
{ "name": "kick_pmul", "label": "Kick Phasor Mul","min": 0.0, "max": 1.0, "default": 0.0, "curve": "linear", "group": "kick" },
{ "name": "kick_poff", "label": "Kick Phase Off", "min": 0.0, "max": 1.0, "default": 0.0, "curve": "linear", "group": "kick" },
{ "name": "kick_amp0", "label": "Kick Amp 0", "min": 0.0, "max": 1.0, "default": 0.5, "curve": "linear", "group": "kick" },
{ "name": "kick_amp1", "label": "Kick Amp 1", "min": 0.0, "max": 1.0, "default": 0.5, "curve": "linear", "group": "kick" },
{ "name": "snare_ratio0", "label": "Snare Ratio 0", "min": 0.0, "max": 1.0, "default": 0.5, "curve": "linear", "group": "snare" },
{ "name": "snare_ratio1", "label": "Snare Ratio 1", "min": 0.0, "max": 1.0, "default": 0.5, "curve": "linear", "group": "snare" },
{ "name": "snare_ratio2", "label": "Snare Ratio 2", "min": 0.0, "max": 1.0, "default": 0.5, "curve": "linear", "group": "snare" },
{ "name": "snare_pmul", "label": "Snare Phasor Mul","min": 0.0, "max": 1.0, "default": 0.0, "curve": "linear", "group": "snare" },
{ "name": "snare_poff", "label": "Snare Phase Off","min": 0.0, "max": 1.0, "default": 0.0, "curve": "linear", "group": "snare" },
{ "name": "snare_amp0", "label": "Snare Amp 0", "min": 0.0, "max": 1.0, "default": 0.5, "curve": "linear", "group": "snare" },
{ "name": "snare_amp1", "label": "Snare Amp 1", "min": 0.0, "max": 1.0, "default": 0.5, "curve": "linear", "group": "snare" },
{ "name": "tom_ratio0", "label": "Tom Ratio 0", "min": 0.0, "max": 1.0, "default": 0.5, "curve": "linear", "group": "tom" },
{ "name": "tom_ratio1", "label": "Tom Ratio 1", "min": 0.0, "max": 1.0, "default": 0.5, "curve": "linear", "group": "tom" },
{ "name": "tom_ratio2", "label": "Tom Ratio 2", "min": 0.0, "max": 1.0, "default": 0.5, "curve": "linear", "group": "tom" },
{ "name": "tom_pmul", "label": "Tom Phasor Mul", "min": 0.0, "max": 1.0, "default": 0.0, "curve": "linear", "group": "tom" },
{ "name": "tom_poff", "label": "Tom Phase Off", "min": 0.0, "max": 1.0, "default": 0.0, "curve": "linear", "group": "tom" },
{ "name": "tom_amp0", "label": "Tom Amp 0", "min": 0.0, "max": 1.0, "default": 0.5, "curve": "linear", "group": "tom" },
{ "name": "tom_amp1", "label": "Tom Amp 1", "min": 0.0, "max": 1.0, "default": 0.5, "curve": "linear", "group": "tom" },
{ "name": "lowtom_ratio0", "label": "LowTom Ratio 0", "min": 0.0, "max": 1.0, "default": 0.5, "curve": "linear", "group": "lowtom" },
{ "name": "lowtom_ratio1", "label": "LowTom Ratio 1", "min": 0.0, "max": 1.0, "default": 0.5, "curve": "linear", "group": "lowtom" },
{ "name": "lowtom_ratio2", "label": "LowTom Ratio 2", "min": 0.0, "max": 1.0, "default": 0.5, "curve": "linear", "group": "lowtom" },
{ "name": "lowtom_pmul", "label": "LowTom Phasor Mul","min": 0.0, "max": 1.0, "default": 0.0, "curve": "linear", "group": "lowtom" },
{ "name": "lowtom_poff", "label": "LowTom Phase Off","min": 0.0, "max": 1.0, "default": 0.0, "curve": "linear", "group": "lowtom" },
{ "name": "lowtom_amp0", "label": "LowTom Amp 0", "min": 0.0, "max": 1.0, "default": 0.5, "curve": "linear", "group": "lowtom" },
{ "name": "lowtom_amp1", "label": "LowTom Amp 1", "min": 0.0, "max": 1.0, "default": 0.5, "curve": "linear", "group": "lowtom" },
{ "name": "rim_ratio0", "label": "Rim Ratio 0", "min": 0.0, "max": 1.0, "default": 0.5, "curve": "linear", "group": "rim" },
{ "name": "rim_ratio1", "label": "Rim Ratio 1", "min": 0.0, "max": 1.0, "default": 0.5, "curve": "linear", "group": "rim" },
{ "name": "rim_ratio2", "label": "Rim Ratio 2", "min": 0.0, "max": 1.0, "default": 0.5, "curve": "linear", "group": "rim" },
{ "name": "rim_pmul", "label": "Rim Phasor Mul", "min": 0.0, "max": 1.0, "default": 0.0, "curve": "linear", "group": "rim" },
{ "name": "rim_poff", "label": "Rim Phase Off", "min": 0.0, "max": 1.0, "default": 0.0, "curve": "linear", "group": "rim" },
{ "name": "rim_amp0", "label": "Rim Amp 0", "min": 0.0, "max": 1.0, "default": 0.5, "curve": "linear", "group": "rim" },
{ "name": "rim_amp1", "label": "Rim Amp 1", "min": 0.0, "max": 1.0, "default": 0.5, "curve": "linear", "group": "rim" },
{ "name": "hat_ratio0", "label": "Hat Ratio 0", "min": 0.0, "max": 1.0, "default": 0.5, "curve": "linear", "group": "hat" },
{ "name": "hat_ratio1", "label": "Hat Ratio 1", "min": 0.0, "max": 1.0, "default": 0.5, "curve": "linear", "group": "hat" },
{ "name": "hat_ratio2", "label": "Hat Ratio 2", "min": 0.0, "max": 1.0, "default": 0.5, "curve": "linear", "group": "hat" },
{ "name": "hat_pmul", "label": "Hat Phasor Mul", "min": 0.0, "max": 1.0, "default": 0.0, "curve": "linear", "group": "hat" },
{ "name": "hat_poff", "label": "Hat Phase Off", "min": 0.0, "max": 1.0, "default": 0.0, "curve": "linear", "group": "hat" },
{ "name": "hat_amp0", "label": "Hat Amp 0", "min": 0.0, "max": 1.0, "default": 0.5, "curve": "linear", "group": "hat" },
{ "name": "hat_amp1", "label": "Hat Amp 1", "min": 0.0, "max": 1.0, "default": 0.5, "curve": "linear", "group": "hat" },
{ "name": "ophat_ratio0", "label": "OpenHat Ratio 0","min": 0.0, "max": 1.0, "default": 0.5, "curve": "linear", "group": "openhat" },
{ "name": "ophat_ratio1", "label": "OpenHat Ratio 1","min": 0.0, "max": 1.0, "default": 0.5, "curve": "linear", "group": "openhat" },
{ "name": "ophat_ratio2", "label": "OpenHat Ratio 2","min": 0.0, "max": 1.0, "default": 0.5, "curve": "linear", "group": "openhat" },
{ "name": "ophat_pmul", "label": "OpenHat Phasor Mul","min": 0.0, "max": 1.0, "default": 0.0, "curve": "linear", "group": "openhat" },
{ "name": "ophat_poff", "label": "OpenHat Phase Off","min": 0.0, "max": 1.0, "default": 0.0, "curve": "linear", "group": "openhat" },
{ "name": "ophat_amp0", "label": "OpenHat Amp 0", "min": 0.0, "max": 1.0, "default": 0.5, "curve": "linear", "group": "openhat" },
{ "name": "ophat_amp1", "label": "OpenHat Amp 1", "min": 0.0, "max": 1.0, "default": 0.5, "curve": "linear", "group": "openhat" },
{ "name": "perc_ratio0", "label": "Perc Ratio 0", "min": 0.0, "max": 1.0, "default": 0.5, "curve": "linear", "group": "perc" },
{ "name": "perc_ratio1", "label": "Perc Ratio 1", "min": 0.0, "max": 1.0, "default": 0.5, "curve": "linear", "group": "perc" },
{ "name": "perc_ratio2", "label": "Perc Ratio 2", "min": 0.0, "max": 1.0, "default": 0.5, "curve": "linear", "group": "perc" },
{ "name": "perc_pmul", "label": "Perc Phasor Mul","min": 0.0, "max": 1.0, "default": 0.0, "curve": "linear", "group": "perc" },
{ "name": "perc_poff", "label": "Perc Phase Off", "min": 0.0, "max": 1.0, "default": 0.0, "curve": "linear", "group": "perc" },
{ "name": "perc_amp0", "label": "Perc Amp 0", "min": 0.0, "max": 1.0, "default": 0.5, "curve": "linear", "group": "perc" },
{ "name": "perc_amp1", "label": "Perc Amp 1", "min": 0.0, "max": 1.0, "default": 0.5, "curve": "linear", "group": "perc" }
],
"voice_spaces": [],
"ui": {
"primary_input": "xy_pad",
"show_voice_space_selector": false,
"show_synth_visualizer": false
}
}