feat(slp-workshop): new MEMLCelium-based mode + port Jolt & OU-noise RL learning
New SLP-Workshop firmware variant (Synth Library Portland), built on the
MEMLCelium engine + MLP shape. Ports the two post-fork learning-algorithm
changes from upstream memllib InterfaceRL into the shared nisps/ml core,
runtime-configurable (no compile-time switch), inert by default:
- nisps/ml/jolt.hpp: Jolt — held continuous weight morph over the flat
weight buffer + post-release LR ramp (kJolt* constants verbatim).
- nisps/ml/ou_noise.hpp: OUNoise<N> — Ornstein-Uhlenbeck exploration walk
on the output vector (theta=0.02, dt=0.001, kMaxAmplitude=0.65).
Both wired into ModeBase so every mode gains jolt_press/jolt_release/
jolt_lr_scale + set_explore_intensity; gated so existing modes stay
bit-identical (parity + golden tests green). Firmware surfaces them on
TogB1 (Jolt) and RVX1 (explore). New SLPWorkshopMode mode + schema +
codegen; firmware alias + .ino variant; playground mode registration.
Tests: jolt + OU unit tests, ModeBase learning integration incl. an
inert-parity test proving SLP-Workshop == MEMLCelium with features off.
Verified: cpp tests, wasm build, native↔wasm parity, lint, codegen
golden, playground typecheck. Firmware compile/e2e/hardware are
environment-bound (no arduino-cli/submodules/browser here).
Refs ergo 019f0fca.
2026-06-28 22:15:36 +02:00
{
"$schema" : "../schema.json" ,
"_note" : "SLP-Workshop — the Synth Library Portland workshop instrument. Reuses the MEMLCelium engine (engine_id 'memlcelium', 56-param dual-voice PAF synth + 2-track ratio sequencer) and MLP shape verbatim; it exists as a distinct mode so the workshop build carries its own identity (preset dir, display name) and surfaces the adaptive-learning gestures ported from upstream InterfaceRL: Jolt (held continuous weight morph) and OU exploration noise. Both live in the shared ModeBase, so the mapping/params are identical to MEMLCelium — only the surfaced controls differ." ,
"mode_id" : "slp_workshop" ,
"engine_id" : "memlcelium" ,
"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
feat(slp-workshop): new MEMLCelium-based mode + port Jolt & OU-noise RL learning
New SLP-Workshop firmware variant (Synth Library Portland), built on the
MEMLCelium engine + MLP shape. Ports the two post-fork learning-algorithm
changes from upstream memllib InterfaceRL into the shared nisps/ml core,
runtime-configurable (no compile-time switch), inert by default:
- nisps/ml/jolt.hpp: Jolt — held continuous weight morph over the flat
weight buffer + post-release LR ramp (kJolt* constants verbatim).
- nisps/ml/ou_noise.hpp: OUNoise<N> — Ornstein-Uhlenbeck exploration walk
on the output vector (theta=0.02, dt=0.001, kMaxAmplitude=0.65).
Both wired into ModeBase so every mode gains jolt_press/jolt_release/
jolt_lr_scale + set_explore_intensity; gated so existing modes stay
bit-identical (parity + golden tests green). Firmware surfaces them on
TogB1 (Jolt) and RVX1 (explore). New SLPWorkshopMode mode + schema +
codegen; firmware alias + .ino variant; playground mode registration.
Tests: jolt + OU unit tests, ModeBase learning integration incl. an
inert-parity test proving SLP-Workshop == MEMLCelium with features off.
Verified: cpp tests, wasm build, native↔wasm parity, lint, codegen
golden, playground typecheck. Firmware compile/e2e/hardware are
environment-bound (no arduino-cli/submodules/browser here).
Refs ergo 019f0fca.
2026-06-28 22:15:36 +02:00
} ,
"params" : [
{ "name" : "seq0_ratio0" , "label" : "Seq0 Ratio 0" , "min" : 0.0 , "max" : 1.0 , "default" : 0.5 , "curve" : "linear" , "group" : "sequencer" } ,
{ "name" : "seq0_ratio1" , "label" : "Seq0 Ratio 1" , "min" : 0.0 , "max" : 1.0 , "default" : 0.5 , "curve" : "linear" , "group" : "sequencer" } ,
{ "name" : "seq0_ratio2" , "label" : "Seq0 Ratio 2" , "min" : 0.0 , "max" : 1.0 , "default" : 0.5 , "curve" : "linear" , "group" : "sequencer" } ,
{ "name" : "seq0_phasor_mul" , "label" : "Seq0 Phasor Mul" , "min" : 0.0 , "max" : 1.0 , "default" : 0.0 , "curve" : "linear" , "group" : "sequencer" } ,
{ "name" : "seq0_phase_off" , "label" : "Seq0 Phase Off" , "min" : 0.0 , "max" : 1.0 , "default" : 0.0 , "curve" : "linear" , "group" : "sequencer" } ,
{ "name" : "seq0_amp0" , "label" : "Seq0 Amp 0" , "min" : 0.0 , "max" : 1.0 , "default" : 0.5 , "curve" : "linear" , "group" : "sequencer" } ,
{ "name" : "seq0_amp1" , "label" : "Seq0 Amp 1" , "min" : 0.0 , "max" : 1.0 , "default" : 0.5 , "curve" : "linear" , "group" : "sequencer" } ,
{ "name" : "seq1_ratio0" , "label" : "Seq1 Ratio 0" , "min" : 0.0 , "max" : 1.0 , "default" : 0.5 , "curve" : "linear" , "group" : "sequencer" } ,
{ "name" : "seq1_ratio1" , "label" : "Seq1 Ratio 1" , "min" : 0.0 , "max" : 1.0 , "default" : 0.5 , "curve" : "linear" , "group" : "sequencer" } ,
{ "name" : "seq1_ratio2" , "label" : "Seq1 Ratio 2" , "min" : 0.0 , "max" : 1.0 , "default" : 0.5 , "curve" : "linear" , "group" : "sequencer" } ,
{ "name" : "seq1_phasor_mul" , "label" : "Seq1 Phasor Mul" , "min" : 0.0 , "max" : 1.0 , "default" : 0.0 , "curve" : "linear" , "group" : "sequencer" } ,
{ "name" : "seq1_phase_off" , "label" : "Seq1 Phase Off" , "min" : 0.0 , "max" : 1.0 , "default" : 0.0 , "curve" : "linear" , "group" : "sequencer" } ,
{ "name" : "seq1_amp0" , "label" : "Seq1 Amp 0" , "min" : 0.0 , "max" : 1.0 , "default" : 0.5 , "curve" : "linear" , "group" : "sequencer" } ,
{ "name" : "seq1_amp1" , "label" : "Seq1 Amp 1" , "min" : 0.0 , "max" : 1.0 , "default" : 0.5 , "curve" : "linear" , "group" : "sequencer" } ,
{ "name" : "v0_base_freq" , "label" : "V0 Base Freq" , "min" : 0.0 , "max" : 1.0 , "default" : 0.5 , "curve" : "linear" , "group" : "v0_synth" } ,
{ "name" : "v0_paf0_cf" , "label" : "V0 PAF0 CF" , "min" : 0.0 , "max" : 1.0 , "default" : 0.5 , "curve" : "linear" , "group" : "v0_synth" } ,
{ "name" : "v0_paf1_cf" , "label" : "V0 PAF1 CF" , "min" : 0.0 , "max" : 1.0 , "default" : 0.5 , "curve" : "linear" , "group" : "v0_synth" } ,
{ "name" : "v0_paf2_cf" , "label" : "V0 PAF2 CF" , "min" : 0.0 , "max" : 1.0 , "default" : 0.5 , "curve" : "linear" , "group" : "v0_synth" } ,
{ "name" : "v0_paf0_bw" , "label" : "V0 PAF0 BW" , "min" : 0.0 , "max" : 1.0 , "default" : 0.5 , "curve" : "linear" , "group" : "v0_synth" } ,
{ "name" : "v0_paf1_bw" , "label" : "V0 PAF1 BW" , "min" : 0.0 , "max" : 1.0 , "default" : 0.5 , "curve" : "linear" , "group" : "v0_synth" } ,
{ "name" : "v0_paf2_bw" , "label" : "V0 PAF2 BW" , "min" : 0.0 , "max" : 1.0 , "default" : 0.5 , "curve" : "linear" , "group" : "v0_synth" } ,
{ "name" : "v0_paf_vib" , "label" : "V0 PAF Vib" , "min" : 0.0 , "max" : 1.0 , "default" : 0.0 , "curve" : "square" , "group" : "v0_synth" } ,
{ "name" : "v0_paf_vfr" , "label" : "V0 PAF Vib Rate" , "min" : 0.0 , "max" : 1.0 , "default" : 0.5 , "curve" : "square" , "group" : "v0_synth" } ,
{ "name" : "v0_paf0_shift" , "label" : "V0 PAF0 Shift" , "min" : 0.0 , "max" : 1.0 , "default" : 0.5 , "curve" : "linear" , "group" : "v0_synth" } ,
{ "name" : "v0_paf1_shift" , "label" : "V0 PAF1 Shift" , "min" : 0.0 , "max" : 1.0 , "default" : 0.5 , "curve" : "linear" , "group" : "v0_synth" } ,
{ "name" : "v0_paf2_shift" , "label" : "V0 PAF2 Shift" , "min" : 0.0 , "max" : 1.0 , "default" : 0.5 , "curve" : "linear" , "group" : "v0_synth" } ,
{ "name" : "v0_amp_attack" , "label" : "V0 Amp Attack" , "min" : 0.0 , "max" : 1.0 , "default" : 0.0 , "curve" : "linear" , "group" : "v0_env" } ,
{ "name" : "v0_amp_decay" , "label" : "V0 Amp Decay" , "min" : 0.0 , "max" : 1.0 , "default" : 0.3 , "curve" : "square" , "group" : "v0_env" } ,
{ "name" : "v0_amp_sustain" , "label" : "V0 Amp Sustain" , "min" : 0.0 , "max" : 1.0 , "default" : 0.5 , "curve" : "linear" , "group" : "v0_env" } ,
{ "name" : "v0_amp_release" , "label" : "V0 Amp Release" , "min" : 0.0 , "max" : 1.0 , "default" : 0.3 , "curve" : "square" , "group" : "v0_env" } ,
{ "name" : "v0_pitch_attack" , "label" : "V0 Pitch Attack" , "min" : 0.0 , "max" : 1.0 , "default" : 0.0 , "curve" : "linear" , "group" : "v0_env" } ,
{ "name" : "v0_pitch_decay" , "label" : "V0 Pitch Decay" , "min" : 0.0 , "max" : 1.0 , "default" : 0.3 , "curve" : "square" , "group" : "v0_env" } ,
{ "name" : "v0_pitch_emph" , "label" : "V0 Pitch Emph" , "min" : 0.0 , "max" : 1.0 , "default" : 0.0 , "curve" : "linear" , "group" : "v0_env" } ,
{ "name" : "v0_shape_gain" , "label" : "V0 Shape Gain" , "min" : 0.0 , "max" : 1.0 , "default" : 0.0 , "curve" : "linear" , "group" : "v0_synth" } ,
{ "name" : "v0_shape_asym" , "label" : "V0 Shape Asym" , "min" : 0.0 , "max" : 1.0 , "default" : 0.0 , "curve" : "linear" , "group" : "v0_synth" } ,
{ "name" : "v0_shape_mix" , "label" : "V0 Shape Mix" , "min" : 0.0 , "max" : 1.0 , "default" : 0.0 , "curve" : "linear" , "group" : "v0_synth" } ,
{ "name" : "v0_rm_gain" , "label" : "V0 RingMod Gain" , "min" : 0.0 , "max" : 1.0 , "default" : 0.0 , "curve" : "linear" , "group" : "v0_synth" } ,
{ "name" : "v1_base_freq" , "label" : "V1 Base Freq" , "min" : 0.0 , "max" : 1.0 , "default" : 0.5 , "curve" : "linear" , "group" : "v1_synth" } ,
{ "name" : "v1_detune1" , "label" : "V1 Detune 1" , "min" : 0.0 , "max" : 1.0 , "default" : 0.0 , "curve" : "linear" , "group" : "v1_synth" } ,
{ "name" : "v1_detune2" , "label" : "V1 Detune 2" , "min" : 0.0 , "max" : 1.0 , "default" : 0.0 , "curve" : "linear" , "group" : "v1_synth" } ,
{ "name" : "v1_paf0_cf" , "label" : "V1 PAF0 CF" , "min" : 0.0 , "max" : 1.0 , "default" : 0.5 , "curve" : "linear" , "group" : "v1_synth" } ,
{ "name" : "v1_paf1_cf" , "label" : "V1 PAF1 CF" , "min" : 0.0 , "max" : 1.0 , "default" : 0.5 , "curve" : "linear" , "group" : "v1_synth" } ,
{ "name" : "v1_paf2_cf" , "label" : "V1 PAF2 CF" , "min" : 0.0 , "max" : 1.0 , "default" : 0.5 , "curve" : "linear" , "group" : "v1_synth" } ,
{ "name" : "v1_paf0_bw" , "label" : "V1 PAF0 BW" , "min" : 0.0 , "max" : 1.0 , "default" : 0.5 , "curve" : "linear" , "group" : "v1_synth" } ,
{ "name" : "v1_paf1_bw" , "label" : "V1 PAF1 BW" , "min" : 0.0 , "max" : 1.0 , "default" : 0.5 , "curve" : "linear" , "group" : "v1_synth" } ,
{ "name" : "v1_paf2_bw" , "label" : "V1 PAF2 BW" , "min" : 0.0 , "max" : 1.0 , "default" : 0.5 , "curve" : "linear" , "group" : "v1_synth" } ,
{ "name" : "v1_paf0_shift" , "label" : "V1 PAF0 Shift" , "min" : 0.0 , "max" : 1.0 , "default" : 0.5 , "curve" : "linear" , "group" : "v1_synth" } ,
{ "name" : "v1_paf1_shift" , "label" : "V1 PAF1 Shift" , "min" : 0.0 , "max" : 1.0 , "default" : 0.5 , "curve" : "linear" , "group" : "v1_synth" } ,
{ "name" : "v1_paf2_shift" , "label" : "V1 PAF2 Shift" , "min" : 0.0 , "max" : 1.0 , "default" : 0.5 , "curve" : "linear" , "group" : "v1_synth" } ,
{ "name" : "v1_amp_attack" , "label" : "V1 Amp Attack" , "min" : 0.0 , "max" : 1.0 , "default" : 0.0 , "curve" : "linear" , "group" : "v1_env" } ,
{ "name" : "v1_amp_decay" , "label" : "V1 Amp Decay" , "min" : 0.0 , "max" : 1.0 , "default" : 0.3 , "curve" : "square" , "group" : "v1_env" } ,
{ "name" : "v1_amp_sustain" , "label" : "V1 Amp Sustain" , "min" : 0.0 , "max" : 1.0 , "default" : 0.5 , "curve" : "linear" , "group" : "v1_env" } ,
{ "name" : "v1_amp_release" , "label" : "V1 Amp Release" , "min" : 0.0 , "max" : 1.0 , "default" : 0.3 , "curve" : "square" , "group" : "v1_env" } ,
{ "name" : "v1_pitch_attack" , "label" : "V1 Pitch Attack" , "min" : 0.0 , "max" : 1.0 , "default" : 0.0 , "curve" : "linear" , "group" : "v1_env" } ,
{ "name" : "v1_pitch_decay" , "label" : "V1 Pitch Decay" , "min" : 0.0 , "max" : 1.0 , "default" : 0.3 , "curve" : "square" , "group" : "v1_env" } ,
{ "name" : "v1_pitch_emph" , "label" : "V1 Pitch Emph" , "min" : 0.0 , "max" : 1.0 , "default" : 0.0 , "curve" : "linear" , "group" : "v1_env" }
] ,
"voice_spaces" : [
"Direct"
] ,
"ui" : {
"primary_input" : "xy_pad" ,
"show_voice_space_selector" : false ,
"show_synth_visualizer" : true
}
}
