Skip to content

Commit c26f4b7

Browse files
authored
Merge pull request #97 from IgnitionAI/release/dev-to-main-20261115b
Release dev → main : Dock spatial entraînable (DQN, #96) + GLB allégés (#94)
2 parents 2b0d127 + 6bd3616 commit c26f4b7

32 files changed

Lines changed: 1204 additions & 39 deletions

‎packages/backend-tfjs/src/defaults.ts‎

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,3 @@
1-
import type { AlgorithmType } from '@ignitionai/core';
2-
31
export const DQN_DEFAULTS: Record<string, unknown> = {
42
hiddenLayers: [64, 64],
53
gamma: 0.99,

‎packages/demo-space-dock/ASSETS.md‎

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -8,13 +8,13 @@ Licence : les quatre modèles originaux sont couverts par la licence MIT de `Ign
88

99
| Asset | Octets | Triangles | Meshes | SHA-256 |
1010
|---|---:|---:|---:|---|
11-
| `drone-remorqueur.glb` | 755 040 | 10 448 | 21 | `f5b646dbdaaa37e0a605723d4c4fd65b53aed09c54e96f20e88bc937718e373a` |
12-
| `cargo-orbitale.glb` | 914 796 | 12 636 | 6 | `3fcb44848c941ca34daa9a7ee58019ca3b7bccd602f08947da9adf1e8819a203` |
13-
| `poste-arrimage.glb` | 1 211 488 | 16 684 | 12 | `29b711743137c0fef813e7bb3bfe962fb9f912092fb5ef1d91246a79c5074e0d` |
14-
| `hangar-orbital.glb` | 1 911 040 | 26 430 | 10 | `c004741dffc17a18f9d66d04b21e7a28001a693a689ca872f54114c7aa58b8ee` |
15-
| **Total** | **4 792 364** | **66 198** | **49** | — |
11+
| `drone-remorqueur.glb` | 227 860 | 10 448 | 21 | `57f7fe737076b54ce7ae5ca48d8e45b2321076339c29189d79387dcacb3a7dce` |
12+
| `cargo-orbitale.glb` | 237 016 | 12 636 | 6 | `e50162c7553895bde65debeac279aab32f8020d007d73fa71b2f8c4e223f4297` |
13+
| `poste-arrimage.glb` | 331 240 | 16 684 | 12 | `f5b0432ffc9117700383b932d9735ea0b8c75871b414653109cd46a1e06bad50` |
14+
| `hangar-orbital.glb` | 636 036 | 26 430 | 10 | `da6076c750b128f0c8ccdbcdbfcc2f8738969da3774328d0827e88eae8ac68e9` |
15+
| **Total** | **1 432 152** | **66 198** | **49** | — |
1616

17-
Budget sans compression Draco/Meshopt : **4,79 Mo**, aucune texture image. Les détails visibles sont de la géométrie chanfreinée et des matériaux PBR, pas des primitives de fallback. Les meshes statiques sont fusionnés par matériau ; les pivots mécaniques et les tuyères d’action restent séparés. Le berth est aligné pour anneau `x=6` et paroi `x=10,5` après rotation d’intégration.
17+
Budget sans compression Draco/Meshopt : **1,43 Mo**, aucune texture image. Les sommets identiques sont soudés et indexés (`gltf-transform weld`), à géométrie inchangée. Les détails visibles sont de la géométrie chanfreinée et des matériaux PBR, pas des primitives de fallback. Les meshes statiques sont fusionnés par matériau ; les pivots mécaniques et les tuyères d’action restent séparés. Le berth est aligné pour anneau `x=6` et paroi `x=10,5` après rotation d’intégration.
1818

1919
## Conventions
2020

@@ -87,7 +87,7 @@ max (17.660225, 14.869, 9.6), mesuré par GLTFLoader/Box3.
8787

8888
L'instance statique est ajoutée au vrai World R3F à l'identité, sans adaptation,
8989
clip, collider ni interaction physique. 10 meshes et 26 430 triangles mesurés
90-
dans le vrai GLB avec Three 0.162.0. Les 66 198 triangles / 49 meshes / 4 792 364
90+
dans le vrai GLB avec Three 0.162.0. Les 66 198 triangles / 49 meshes / 1 432 152
9191
octets sont les totaux des fichiers, pas une mesure des appels de rendu ou du GPU.
9292
Aucune texture image externe ; aucun achat ni nouvelle dépendance. Les captures
9393
amont d'assets ne prouvent pas l'intégration. Licence MIT et attribution comme ci-dessus.

‎packages/demo-space-dock/package.json‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -12,8 +12,10 @@
1212
},
1313
"dependencies": {
1414
"@dimforge/rapier3d-compat": "0.15.0",
15+
"@ignitionai/backend-tfjs": "workspace:*",
1516
"@ignitionai/core": "workspace:*",
1617
"@react-three/fiber": "^9.1.2",
18+
"@tensorflow/tfjs": "^4.22.0",
1719
"react": "^19.0.0",
1820
"react-dom": "^19.0.0",
1921
"three": "^0.162.0"
-662 KB
Binary file not shown.
-515 KB
Binary file not shown.
-1.22 MB
Binary file not shown.
-860 KB
Binary file not shown.

‎packages/demo-space-dock/public/models/validation.json‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"drone-remorqueur": {
3-
"bytes": 755040,
3+
"bytes": 227860,
44
"meshes": 21,
55
"triangles": 10448,
66
"nodes": [
@@ -39,7 +39,7 @@
3939
"messages": []
4040
},
4141
"cargo-orbitale": {
42-
"bytes": 914796,
42+
"bytes": 237016,
4343
"meshes": 6,
4444
"triangles": 12636,
4545
"nodes": [
@@ -57,7 +57,7 @@
5757
"messages": []
5858
},
5959
"poste-arrimage": {
60-
"bytes": 1211488,
60+
"bytes": 331240,
6161
"meshes": 12,
6262
"triangles": 16684,
6363
"nodes": [

‎packages/demo-space-dock/src/App.tsx‎

Lines changed: 38 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -2,12 +2,15 @@ import { useEffect, useState } from 'react';
22
import Scene from './scene-adapter';
33
import Hud from './Hud';
44
import { SpaceDockEnv } from './space-dock-env';
5+
import type { TrainingSession } from './training-session';
6+
import type { TrainingPanel as Panel } from './TrainingPanel';
57
import { DockRuntime } from './runtime';
68
import { attachControls } from './controls';
79
import { ACTIONS } from './simulation-contract';
810
import type { Action } from './simulation-contract';
911

1012
type Loading = { status: 'loading' } | { status: 'error'; message: string } | { status: 'ready'; runtime: DockRuntime };
13+
type Learning = { status: 'loading' } | { status: 'error'; message: string } | { status: 'ready'; session: TrainingSession; Panel: typeof Panel };
1114
const SHORTCUTS = ['X', 'W / ↑', 'S / ↓', 'A / ←', 'D / →', 'Q', 'E', 'Espace'];
1215
function useMediaQuery(query: string) {
1316
const [matches, setMatches] = useState(() => window.matchMedia(query).matches);
@@ -24,19 +27,27 @@ export default function App() {
2427
const compact = useMediaQuery('(max-width: 600px)');
2528
const reducedMotion = useMediaQuery('(prefers-reduced-motion: reduce)');
2629
const [loading, setLoading] = useState<Loading>({ status: 'loading' });
30+
const [learning, setLearning] = useState<Learning>({ status: 'loading' });
2731
const [, repaint] = useState(0);
2832
const [seed, setSeed] = useState('42');
2933
const [inputError, setInputError] = useState('');
3034
const publish = () => repaint(value => value + 1);
3135
useEffect(() => {
32-
let alive = true, owner: DockRuntime | undefined, frame = 0;
36+
let alive = true, owner: DockRuntime | undefined, trainer: TrainingSession | undefined, frame = 0;
3337
let detach: (() => void) | undefined;
3438
void SpaceDockEnv.create(42).then(env => {
3539
if (!alive) { env.dispose(); return; }
3640
const runtime = new DockRuntime(env); owner = runtime;
3741
detach = attachControls(runtime, window, document, publish);
3842
if (document.hidden) runtime.setPaused(true);
3943
setLoading({ status: 'ready', runtime });
44+
void import('./learning').then(async ({ startLearning, TrainingPanel }) => {
45+
if (!alive) return;
46+
const session = await startLearning(env, runtime);
47+
if (!alive) { void session.dispose(); return; }
48+
trainer = session; session.onChange = () => { if (alive) publish(); };
49+
setLearning({ status: 'ready', session, Panel: TrainingPanel });
50+
}).catch((error: unknown) => { if (alive) setLearning({ status: 'error', message: String(error) }); });
4051
let previous: number | undefined;
4152
const animate = (now: number) => {
4253
if (!alive) return;
@@ -51,12 +62,24 @@ export default function App() {
5162
};
5263
frame = requestAnimationFrame(animate);
5364
}).catch((error: unknown) => { if (alive) setLoading({ status: 'error', message: String(error) }); });
54-
return () => { alive = false; cancelAnimationFrame(frame); detach?.(); owner?.dispose(); };
65+
return () => {
66+
alive = false; cancelAnimationFrame(frame); detach?.();
67+
// The session stops after any in-flight fit, then the runtime frees the shared Rapier world.
68+
const runtime = owner;
69+
void (trainer ? trainer.dispose() : Promise.resolve()).finally(() => runtime?.dispose());
70+
};
5571
}, []);
5672
if (loading.status === 'loading') return <main><h1>Dock spatial</h1><p role="status">Initialisation Rapier WASM…</p></main>;
5773
if (loading.status === 'error') return <main><h1>Dock spatial</h1><p role="alert">Initialisation ou simulation interrompue : {loading.message}</p></main>;
5874
const { runtime } = loading;
75+
const session = learning.status === 'ready' ? learning.session : undefined;
76+
const snapshot = session?.snapshot();
77+
const external = runtime.isExternal;
5978
const change = (action: () => void) => { action(); publish(); };
79+
// Manual and PD stay available as references: choosing one hands the dock back from the network.
80+
const choose = (mode: 'manual' | 'auto') => {
81+
void (session?.stop() ?? Promise.resolve()).then(() => change(() => runtime.setMode(mode)));
82+
};
6083
const reset = () => {
6184
try {
6285
if (seed.trim() === '') throw new RangeError('Graine uint32 requise');
@@ -67,21 +90,23 @@ export default function App() {
6790
<header><p className="eyebrow">Démo · physique Rapier</p><h1>Dock spatial</h1>
6891
<p className="temporary">Modèles 3D originaux sous licence MIT ; voir les <a href={`${(import.meta as ImportMeta & { env: { BASE_URL: string } }).env.BASE_URL}models/LICENSE.txt`}>mentions de licence</a>.</p>
6992
<p>Transportez le cargo vers le poste d’arrimage ; le témoin devient vert au succès. La poussée change la vitesse ; anticipez le freinage.</p>
70-
<strong>{runtime.currentMode === 'auto' ? 'AUTO DÉMO — PD SCRIPTÉ, NON ENTRAÎNÉ' : 'MANUEL — 8 ACTIONS'}</strong>
93+
<p>Vous pouvez aussi entraîner un réseau de neurones (DQN) dans ce navigateur, puis le regarder piloter le remorqueur.</p>
94+
<strong>{external ? (snapshot?.mode === 'inference' || snapshot?.resumeMode === 'inference' ? 'AGENT DQN — INFÉRENCE SANS EXPLORATION' : 'ENTRAÎNEMENT DQN — EXPLORATION ε')
95+
: runtime.currentMode === 'auto' ? 'AUTO DÉMO — PD SCRIPTÉ, NON ENTRAÎNÉ' : 'MANUEL — 8 ACTIONS'}</strong>
7196
</header>
7297
<div className="toolbar">
73-
<button onClick={() => change(() => runtime.setMode('manual'))} aria-pressed={runtime.currentMode === 'manual'}>Manuel</button>
74-
<button onClick={() => change(() => runtime.setMode('auto'))} aria-pressed={runtime.currentMode === 'auto'}>Autodémo scriptée</button>
75-
<button onClick={() => change(() => runtime.setPaused(!runtime.isPaused))}>{runtime.isPaused ? 'Reprendre' : 'Pause'} (P)</button>
98+
<button onClick={() => choose('manual')} aria-pressed={!external && runtime.currentMode === 'manual'}>Manuel</button>
99+
<button onClick={() => choose('auto')} aria-pressed={!external && runtime.currentMode === 'auto'}>Autodémo scriptée</button>
100+
<button disabled={external} onClick={() => change(() => runtime.setPaused(!runtime.isPaused))}>{runtime.isPaused ? 'Reprendre' : 'Pause'} (P)</button>
76101
<label>Graine uint32 <input value={seed} inputMode="numeric" onChange={e => setSeed(e.target.value)} /></label>
77-
<button onClick={reset}>Reset seedé</button>
102+
<button disabled={external} onClick={reset}>Reset seedé</button>
78103
</div>
79104
{inputError && <p role="alert">{inputError}</p>}
80105
<div className="viewport" style={{ minHeight: compact ? 320 : 460 }} aria-label="Vue 3D du cargo, du remorqueur et du dock ; télémétrie textuelle ci-dessous">
81106
<Scene env={runtime.env} compact={compact} reducedMotion={reducedMotion} />
82107
</div>
83108
<div className="controls" aria-label="Commandes de poussée">
84-
{ACTIONS.map((label, index) => <button key={label} disabled={runtime.isPaused || runtime.currentMode !== 'manual' || runtime.env.done()}
109+
{ACTIONS.map((label, index) => <button key={label} disabled={external || runtime.isPaused || runtime.currentMode !== 'manual' || runtime.env.done()}
85110
onPointerDown={event => { event.preventDefault(); event.currentTarget.setPointerCapture(event.pointerId); runtime.press(`pointer-${event.pointerId}`, index as Action); }}
86111
onPointerUp={event => runtime.release(`pointer-${event.pointerId}`)} onPointerCancel={event => runtime.release(`pointer-${event.pointerId}`)}
87112
onLostPointerCapture={event => runtime.release(`pointer-${event.pointerId}`)}
@@ -90,7 +115,11 @@ export default function App() {
90115
{label}<small>{SHORTCUTS[index]}</small>
91116
</button>)}
92117
</div>
93-
<p>P : pause · R : rejouer la graine courante. Perte de focus ou onglet masqué : commandes effacées et pause ; reprise explicite.</p>
118+
<p>P : pause · R : rejouer la graine courante. Perte de focus ou onglet masqué : commandes effacées et pause ; reprise explicite.
119+
Pendant l’entraînement ou l’inférence, le réseau pilote seul : commandes manuelles, pause et reset du runtime sont inactifs.</p>
120+
{learning.status === 'ready' && snapshot ? <learning.Panel session={learning.session} snapshot={snapshot} />
121+
: learning.status === 'error' ? <p role="alert">Entraînement indisponible : {learning.message}</p>
122+
: <p role="status">Chargement de TensorFlow.js pour l’entraînement…</p>}
94123
<Hud runtime={runtime} />
95124
</main>;
96125
}

‎packages/demo-space-dock/src/Hud.tsx‎

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -25,8 +25,9 @@ export default function Hud({ runtime }: { runtime: DockRuntime }) {
2525
couple {P.torque} Nm. Frein : −840 v, −1315 ω, bornés à 600 N / 300 Nm.</p>
2626
<p>PD NON ENTRAÎNÉ : Kp {PD_GAINS.position}, Kd {PD_GAINS.velocity}, lacet Kp {PD_GAINS.yaw}, Kd {PD_GAINS.angularVelocity}.
2727
Qualification limitée aux départs axiaux seedés, sans évitement d’obstacles.</p>
28-
<p>Contrat TrainingEnv disponible : 26 observations normalisées, 8 actions discrètes.
29-
Aucun entraînement ni checkpoint livré. Récompense : progression signée + orientation, coûts temps/poussée/contact, bonus terminal unique.</p>
28+
<p>Contrat TrainingEnv : 26 observations normalisées, 8 actions discrètes. Le panneau DQN entraîne un réseau dans ce navigateur
29+
via DockTrainingEnv (récompense bornée, épisode de 30 s simulées, collision = échec). Un agent pré-entraîné hors ligne peut être chargé depuis ce panneau.
30+
Récompense de cette télémétrie (runtime manuel / PD) : progression signée + orientation, coûts temps/poussée/contact, bonus terminal unique.</p>
3031
</details>
3132
<details><summary>Historique des 64 dernières transitions</summary><ol>
3233
{runtime.history.map((r, i) => <li key={`${r.elapsed}-${i}`}>{r.elapsed.toFixed(2)} s · {ACTIONS[r.action]} · r={r.reward.toFixed(4)}</li>)}

0 commit comments

Comments
 (0)