Spaces:
Running
Running
Download app.js from thelamapi/Next-Balance: direct link, hf CLI and curl.
- Browser
- Download file 5.9 kB
-
https://huggingface.co/spaces/thelamapi/Next-Balance/resolve/main/app.js
- Command line
-
hf download hf://spaces/thelamapi/Next-Balance/app.js
-
curl -L -o app.js https://huggingface.co/spaces/thelamapi/Next-Balance/resolve/main/app.js
5.9 kB
| /* Next Balance Space: change load, delay, noise and friction; both controllers re-simulate in the browser. */ | |
| const { $, h, fmt, lineChart, legend, css } = NLUI; | |
| let ctx, last, anim = null; | |
| const COL = { pid: "#8a8f98", adaptive: "#0b6e4f", ref: "#b07d12" }; | |
| const SL = [ | |
| ["payload0", "Initial payload (kg)", 1, 4, 0.1, 2.5], | |
| ["dm", "Payload change at t = 4 s (kg)", -1, 12, 0.5, 5], | |
| ["fric_gain", "Friction multiplier at t = 7 s", 1, 6, 0.1, 2.5], | |
| ["delay_ms", "Actuator delay (ms)", 0, 80, 10, 30], | |
| ["noise_mm", "Sensor noise std (mm)", 0, 10, 0.5, 2], | |
| ["seed", "Noise seed", 1, 50, 1, 7], | |
| ]; | |
| function scenario() { | |
| const v = id => Number($(id).value); | |
| return { payload0: v("payload0"), t_load: 4.0, dm: v("dm"), c0: 3.5, F0: 2.0, t_fric: 7.0, fric_gain: v("fric_gain"), | |
| delay: Math.round(v("delay_ms") / 10), noise: v("noise_mm") / 1000, T: 12.0, seed: v("seed") }; | |
| } | |
| function run() { | |
| const sc = scenario(); | |
| for (const s of SL) $(s[0] + "_v").textContent = $(s[0]).value; | |
| const res = {}; | |
| for (const c of ["pid", "adaptive"]) { | |
| const tr = Core.simulate(sc, c, ctx.params[c], 1); | |
| res[c] = { tr, m: Core.metrics(sc, tr) }; | |
| } | |
| last = { sc, res }; | |
| draw(); | |
| return res; | |
| } | |
| function draw() { | |
| const { sc, res } = last; | |
| const pts = (tr, key) => tr.t.map((t, i) => [t, tr[key][i]]).filter((_, i) => i % 2 === 0); | |
| const s1 = [{ name: "fixed PID", color: COL.pid, points: pts(res.pid.tr, "z") }, | |
| { name: "adaptive (Next Balance)", color: COL.adaptive, points: pts(res.adaptive.tr, "z") }]; | |
| lineChart($("zc"), s1, { xlabel: "time (s)", hlines: [{ y: Core.Z_REF, color: COL.ref }], ymin: Math.min(0, ...s1.flatMap(s => s.points.map(p => p[1]))) }); | |
| legend($("zl"), s1.concat([{ name: "target 0.5 m", color: COL.ref }])); | |
| const s2 = [{ name: "fixed PID", color: COL.pid, points: pts(res.pid.tr, "u") }, { name: "adaptive", color: COL.adaptive, points: pts(res.adaptive.tr, "u") }]; | |
| lineChart($("uc"), s2, { xlabel: "time (s)", height: 170 }); | |
| const trueM = res.adaptive.tr.t.map(t => [t, 2 + sc.payload0 + (t >= sc.t_load ? sc.dm : 0)]).filter((_, i) => i % 2 === 0); | |
| const s3 = [{ name: "true mass", color: COL.ref, points: trueM, dash: [5, 4] }, { name: "adaptive estimate", color: COL.adaptive, points: pts(res.adaptive.tr, "m_hat") }]; | |
| lineChart($("mc"), s3, { xlabel: "time (s)", height: 170 }); | |
| legend($("ml"), s3); | |
| const rows = [["Largest deviation after load change", "max_deviation_m", "m", 3], | |
| ["Settling time (±1 cm, from load change)", "settling_time_s", "s", 2], ["Control energy ∫u² dt", "control_energy_kN2s", "kN²·s", 3], | |
| ["Step overshoot", "step_overshoot_m", "m", 3], ["Final error", "final_error_m", "m", 4]]; | |
| const tb = $("tbl"); tb.innerHTML = ""; | |
| tb.append(h("tr", {}, h("th", {}, "Metric"), h("th", { class: "num" }, "fixed PID"), h("th", { class: "num" }, "adaptive"))); | |
| for (const [label, k, unit, d] of rows) { | |
| const cell = c => { | |
| let txt = fmt(res[c].m[k], d) + " " + unit; | |
| if (k === "settling_time_s" && !res[c].m.settled) txt = "not settled"; | |
| return h("td", { class: "num" }, txt); | |
| }; | |
| tb.append(h("tr", {}, h("td", {}, label), cell("pid"), cell("adaptive"))); | |
| } | |
| playFrame(Math.floor(res.pid.tr.t.length * 0.5)); | |
| } | |
| function playFrame(i) { | |
| const c = $("anim"), W = c.clientWidth || 400, H = 220, dpr = window.devicePixelRatio || 1; | |
| c.width = W * dpr; c.height = H * dpr; c.style.height = H + "px"; | |
| const g = c.getContext("2d"); g.scale(dpr, dpr); | |
| g.fillStyle = css("--panel"); g.fillRect(0, 0, W, H); | |
| const { sc, res } = last, t = res.pid.tr.t[i]; | |
| const Y = z => H - 30 - (z / 1.0) * (H - 60); | |
| g.strokeStyle = COL.ref; g.setLineDash([5, 4]); g.beginPath(); g.moveTo(0, Y(0.5)); g.lineTo(W, Y(0.5)); g.stroke(); g.setLineDash([]); | |
| const m = 2 + sc.payload0 + (t >= sc.t_load ? sc.dm : 0); | |
| [["pid", W * 0.28], ["adaptive", W * 0.72]].forEach(([k, x]) => { | |
| const z = Math.max(-0.2, Math.min(1.2, res[k].tr.z[i])); | |
| g.fillStyle = css("--line"); g.fillRect(x - 3, Y(z), 6, H - 20 - Y(z)); | |
| g.fillStyle = COL[k]; g.fillRect(x - 50, Y(z) - 8, 100, 8); | |
| const box = 10 + 3 * m; g.fillStyle = css("--muted"); g.fillRect(x - box / 2, Y(z) - 8 - box, box, box); | |
| g.fillStyle = css("--ink"); g.font = "12px system-ui"; g.fillText(k === "pid" ? "fixed PID" : "adaptive", x - 28, H - 4); | |
| }); | |
| g.fillStyle = css("--muted"); g.fillText(`t = ${t.toFixed(2)} s · mass ${m.toFixed(1)} kg`, 8, 14); | |
| $("scrub").value = i; | |
| } | |
| function play() { | |
| if (anim) { cancelAnimationFrame(anim); anim = null; $("play").textContent = "Play"; return; } | |
| $("play").textContent = "Pause"; | |
| let i = 0; const n = last.res.pid.tr.t.length; | |
| const step = () => { playFrame(i); i += 4; if (i < n) anim = requestAnimationFrame(step); else { anim = null; $("play").textContent = "Play"; } }; | |
| step(); | |
| } | |
| window.__liveTest = function () { | |
| const before = run(); | |
| $("dm").value = "11"; $("delay_ms").value = "60"; $("noise_mm").value = "6"; | |
| $("dm").dispatchEvent(new Event("input")); | |
| const after = { pid: last.res.pid.m, adaptive: last.res.adaptive.m }; | |
| const tableText = $("tbl").textContent; | |
| return { ok: after.pid.max_deviation_m !== before.pid.m.max_deviation_m && tableText.includes("adaptive") && last.sc.dm === 11 && last.sc.delay === 6, | |
| pid: after.pid, adaptive: after.adaptive }; | |
| }; | |
| NLUI.boot(Core, async c => { | |
| ctx = c; | |
| const box = $("sliders"); | |
| for (const [id, label, lo, hi, step, val] of SL) { | |
| box.append(h("label", { for: id }, label, ": ", h("b", { id: id + "_v" }, String(val))), | |
| h("input", { type: "range", id, min: lo, max: hi, step, value: val, oninput: run })); | |
| } | |
| $("play").addEventListener("click", play); | |
| $("scrub").addEventListener("input", e => playFrame(Number(e.target.value))); | |
| window.addEventListener("resize", () => last && draw()); | |
| run(); | |
| $("scrub").max = last.res.pid.tr.t.length - 1; | |
| }); | |