bs-simulators 0.1.2__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (65) hide show
  1. bs_simulators-0.1.2/.python-version +1 -0
  2. bs_simulators-0.1.2/.readthedocs.yaml +13 -0
  3. bs_simulators-0.1.2/AGENTS.md +37 -0
  4. bs_simulators-0.1.2/LICENSE +21 -0
  5. bs_simulators-0.1.2/LICENSE.benchmark-systems +21 -0
  6. bs_simulators-0.1.2/PKG-INFO +65 -0
  7. bs_simulators-0.1.2/README.md +49 -0
  8. bs_simulators-0.1.2/docs/_static/architecture/configuration-access.svg +388 -0
  9. bs_simulators-0.1.2/docs/_static/architecture/functional-core.svg +385 -0
  10. bs_simulators-0.1.2/docs/_static/architecture/runtime-sequence.svg +452 -0
  11. bs_simulators-0.1.2/docs/api.md +143 -0
  12. bs_simulators-0.1.2/docs/architecture.md +100 -0
  13. bs_simulators-0.1.2/docs/catalogue.md +322 -0
  14. bs_simulators-0.1.2/docs/common-pitfalls.md +60 -0
  15. bs_simulators-0.1.2/docs/conf.py +34 -0
  16. bs_simulators-0.1.2/docs/development.md +79 -0
  17. bs_simulators-0.1.2/docs/http.md +81 -0
  18. bs_simulators-0.1.2/docs/index.md +51 -0
  19. bs_simulators-0.1.2/docs/installation.md +31 -0
  20. bs_simulators-0.1.2/docs/pendulum.md +168 -0
  21. bs_simulators-0.1.2/docs/recording.md +69 -0
  22. bs_simulators-0.1.2/docs/requirements.txt +44 -0
  23. bs_simulators-0.1.2/docs/simulation.md +219 -0
  24. bs_simulators-0.1.2/examples/pendulum_core.ipynb +479 -0
  25. bs_simulators-0.1.2/examples/pendulum_signal_adapter.py +83 -0
  26. bs_simulators-0.1.2/examples/pendulum_sil_controller.py +66 -0
  27. bs_simulators-0.1.2/examples/pendulum_sil_replay.py +75 -0
  28. bs_simulators-0.1.2/pyproject.toml +80 -0
  29. bs_simulators-0.1.2/src/bs_simulators/__init__.py +44 -0
  30. bs_simulators-0.1.2/src/bs_simulators/__main__.py +12 -0
  31. bs_simulators-0.1.2/src/bs_simulators/catalogue/__init__.py +160 -0
  32. bs_simulators-0.1.2/src/bs_simulators/catalogue/_validation.py +159 -0
  33. bs_simulators-0.1.2/src/bs_simulators/catalogue/dc-motor.toml +46 -0
  34. bs_simulators-0.1.2/src/bs_simulators/catalogue/neutralization.toml +63 -0
  35. bs_simulators-0.1.2/src/bs_simulators/catalogue/pendulum.toml +37 -0
  36. bs_simulators-0.1.2/src/bs_simulators/cli/__init__.py +5 -0
  37. bs_simulators-0.1.2/src/bs_simulators/cli/commands.py +154 -0
  38. bs_simulators-0.1.2/src/bs_simulators/cli/configuration.py +50 -0
  39. bs_simulators-0.1.2/src/bs_simulators/cli/execution.py +53 -0
  40. bs_simulators-0.1.2/src/bs_simulators/cli/presentation.py +134 -0
  41. bs_simulators-0.1.2/src/bs_simulators/comms/__init__.py +5 -0
  42. bs_simulators-0.1.2/src/bs_simulators/comms/adapters.py +47 -0
  43. bs_simulators-0.1.2/src/bs_simulators/comms/http.py +179 -0
  44. bs_simulators-0.1.2/src/bs_simulators/runtime/__init__.py +9 -0
  45. bs_simulators-0.1.2/src/bs_simulators/runtime/_validation.py +51 -0
  46. bs_simulators-0.1.2/src/bs_simulators/runtime/core.py +471 -0
  47. bs_simulators-0.1.2/src/bs_simulators/runtime/protocols.py +174 -0
  48. bs_simulators-0.1.2/src/bs_simulators/runtime/signals.py +51 -0
  49. bs_simulators-0.1.2/src/bs_simulators/runtime/steppers.py +275 -0
  50. bs_simulators-0.1.2/src/bs_simulators/viewers/__init__.py +13 -0
  51. bs_simulators-0.1.2/src/bs_simulators/viewers/dc-motor.html +25 -0
  52. bs_simulators-0.1.2/src/bs_simulators/viewers/neutralization.html +25 -0
  53. bs_simulators-0.1.2/src/bs_simulators/viewers/pendulum.html +25 -0
  54. bs_simulators-0.1.2/src/bs_simulators/viewers/scenes.js +143 -0
  55. bs_simulators-0.1.2/src/bs_simulators/viewers/viewer.css +10 -0
  56. bs_simulators-0.1.2/src/bs_simulators/viewers/viewer.js +48 -0
  57. bs_simulators-0.1.2/tests/test_bundled_experiments.py +102 -0
  58. bs_simulators-0.1.2/tests/test_catalogue.py +186 -0
  59. bs_simulators-0.1.2/tests/test_cli.py +442 -0
  60. bs_simulators-0.1.2/tests/test_dae_failure.py +36 -0
  61. bs_simulators-0.1.2/tests/test_distribution.py +78 -0
  62. bs_simulators-0.1.2/tests/test_generic_simulation.py +453 -0
  63. bs_simulators-0.1.2/tests/test_simulation.py +338 -0
  64. bs_simulators-0.1.2/tests/test_simulation_adapters.py +336 -0
  65. bs_simulators-0.1.2/tests/viewer_scales.test.mjs +74 -0
@@ -0,0 +1 @@
1
+ 3.13
@@ -0,0 +1,13 @@
1
+ version: 2
2
+ build:
3
+ os: ubuntu-24.04
4
+ tools:
5
+ python: "3.13"
6
+ sphinx:
7
+ configuration: docs/conf.py
8
+ fail_on_warning: true
9
+ python:
10
+ install:
11
+ - requirements: docs/requirements.txt
12
+ - method: pip
13
+ path: .
@@ -0,0 +1,37 @@
1
+ # Repository Guide
2
+
3
+ ## Version Control
4
+ - Apply new changes on `develop`. Check the branch before editing and preserve existing local changes.
5
+ - Merge into `main` and push only when the user explicitly requests those actions.
6
+ - Before a user-requested merge into `main` for a new push, increment the patch version on `develop` and synchronize `pyproject.toml` and `src/bs_simulators/__init__.py`.
7
+ - This package starts at `0.1.0`; its version is independent of `benchmark-systems`.
8
+
9
+ ## Environment
10
+ - Use Python 3.13 or later and PDM. Build with `pdm build`.
11
+ - Do not edit generated lockfiles or build/distribution files by hand.
12
+ - On this Windows/OneDrive checkout, build-directory cleanup may encounter read-only directories. Use the supported `pdm build -C no-clean-build=true` option when that occurs instead of editing generated files manually.
13
+ - Use `pdm lock -G dev -G replay` when changing dependencies, then `pdm sync -G dev`.
14
+ - Resolve benchmark-systems from PyPI using the version requirements in pyproject.toml. Do not introduce Git resolution overrides or workstation-specific paths into distribution requirements.
15
+ - The `replay` extra supplies Matplotlib through `benchmark-systems[anim]` and Pillow. Include it with `pdm sync -G dev -G replay` when testing GIF generation.
16
+
17
+ ## Package Boundaries
18
+ - Source lives under `src/bs_simulators`; examples consume the package.
19
+ - `runtime` exposes one model-independent Simulation. Numerical integration belongs to ODEStepper or DAEStepper through the structural Stepper protocol. Omitting stepper creates a fresh RK45 ODE stepper per run; DAE selection remains explicit. Optional catalogue TOML data configures models without subclassing Simulation. Users can override physical parameters and initial data for every run. It owns the clock, ZOH, controller selection and signal descriptions. It must not import `comms` or `viewers`.
20
+ - `cli` owns the Typer terminal application and execution lifecycle. Expose model-independent options only: x0/u0 are complete vectors and physical parameters use repeated --parameter; do not add model-specific flags. Keep runtime imports lazy so --help does not initialize scientific or HTTP components.
21
+ - `comms` owns transport adapters and HTTP. Network I/O must stay outside the physics worker.
22
+ - `viewers` owns packaged browser assets. Load them with `importlib.resources`, not a checkout-relative path.
23
+ - Import models and offline animations from `benchmark-systems`; never copy their implementation into this package.
24
+ - Preserve existing offline workflows. Expose live simulation as the additional workflow; stepping remains internal.
25
+ - Describe interfaces as Python protocols. Avoid introducing a public manual-stepping mode.
26
+ - OPC UA and Modbus are future bridges; do not claim physical PLC validation until it exists.
27
+
28
+ ## Verification
29
+ - Keep docs/ focused on final-user guides and API reference; remove partial reports instead of adding session history.
30
+ - Install docs tooling with pdm sync -G dev -G docs. Build with pdm run docs-build, execute examples with pdm run docs-test, and preview with pdm run docs-serve.
31
+ - After documentation dependency changes, regenerate docs/requirements.txt with pdm export --no-default -G docs --without-hashes -o docs/requirements.txt. Keep all documentation output under ignored docs/_build/.
32
+ - Write public Markdown documentation and notebook explanations in English for end users. Keep conversation notes and implementation-session history out of public guides.
33
+ - Run `pdm run pytest` and `pdm run python -c "import bs_simulators; import bs_simulators.runtime"`.
34
+ - Preserve evidence for ZOH, interval boundaries, controller ownership, indefinite input retention and monotonic receipt timestamps, independent structural engines, real subprocess HTTP and viewer resource loading.
35
+ - Build a wheel and sdist with PDM; verify the wheel contains `viewers/pendulum.html` and catalogue TOML resources and test imports/HTTP from an installed wheel outside the source checkout.
36
+ - For visual changes, provide a preview and preserve the simple Matplotlib-style scene.
37
+ - Keep public exports and runtime/package versions synchronized. Validate non-pendulum models, multi-input/zero-input plants, nonzero initial time, and atomic ODE/DAE failures. DAE consistency currently supports index at most one; fixed_x identifies states preserved during input-boundary corrections.
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 ggonzm
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2025 SUPPRESS Research Group
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
@@ -0,0 +1,65 @@
1
+ Metadata-Version: 2.1
2
+ Name: bs-simulators
3
+ Version: 0.1.2
4
+ Summary: Live simulators and transport adapters for benchmark-systems models
5
+ License: MIT
6
+ Requires-Python: >=3.13
7
+ Requires-Dist: benchmark-systems>=1.2.0
8
+ Requires-Dist: numpy>=2.1.0
9
+ Requires-Dist: scipy>=1.14.1
10
+ Requires-Dist: solve-dae>=0.2.4
11
+ Requires-Dist: typer>=0.27.3
12
+ Provides-Extra: replay
13
+ Requires-Dist: benchmark-systems[anim]>=1.2.0; extra == "replay"
14
+ Requires-Dist: Pillow>=11.0.0; extra == "replay"
15
+ Description-Content-Type: text/markdown
16
+
17
+ # bs-simulators
18
+
19
+ `bs-simulators` runs [benchmark-systems](https://benchmark-systems.readthedocs.io/en/latest/)
20
+ models as virtual plants for live control experiments. A controller interacts
21
+ with the simulation as it would with a physical plant: it reads sensor
22
+ measurements and sends actuator commands while the plant evolves independently.
23
+
24
+ ## Installation
25
+
26
+ Install from PyPI with Python 3.13 or later:
27
+
28
+ ```shell
29
+ python -m pip install bs-simulators
30
+ ```
31
+
32
+ See the [documentation on Read the Docs](https://bs-simulators.readthedocs.io/en/latest/)
33
+ for examples and the API reference.
34
+
35
+ ## Run a virtual pendulum
36
+
37
+ After installation, launch the bundled pendulum and open
38
+ <http://127.0.0.1:8765/> to watch it evolve.
39
+
40
+ ```shell
41
+ bs-simulators --catalogue pendulum
42
+ ```
43
+
44
+ The catalogue also includes a DC motor and a pH neutralization process.
45
+ Use `bs-simulators --list-catalogue` to see the available configurations.
46
+
47
+ ## Run a simulation from Python
48
+
49
+ ```python
50
+ from benchmark_systems.models import pendulum
51
+ from bs_simulators import Simulation
52
+
53
+ simulation = Simulation(
54
+ pendulum, x0=[0.6, 0.0], u0=[0.0],
55
+ parameters={"m": 1.0, "L": 1.0},
56
+ )
57
+ simulation.start(duration=1.0)
58
+ simulation.wait()
59
+ ```
60
+
61
+ The [pendulum control example](https://bs-simulators.readthedocs.io/en/latest/pendulum.html)
62
+ shows how to read measurements and send commands in a control loop. A controller
63
+ in a separate process can use the [HTTP interface](https://bs-simulators.readthedocs.io/en/latest/http.html).
64
+
65
+ [MIT License](LICENSE)
@@ -0,0 +1,49 @@
1
+ # bs-simulators
2
+
3
+ `bs-simulators` runs [benchmark-systems](https://benchmark-systems.readthedocs.io/en/latest/)
4
+ models as virtual plants for live control experiments. A controller interacts
5
+ with the simulation as it would with a physical plant: it reads sensor
6
+ measurements and sends actuator commands while the plant evolves independently.
7
+
8
+ ## Installation
9
+
10
+ Install from PyPI with Python 3.13 or later:
11
+
12
+ ```shell
13
+ python -m pip install bs-simulators
14
+ ```
15
+
16
+ See the [documentation on Read the Docs](https://bs-simulators.readthedocs.io/en/latest/)
17
+ for examples and the API reference.
18
+
19
+ ## Run a virtual pendulum
20
+
21
+ After installation, launch the bundled pendulum and open
22
+ <http://127.0.0.1:8765/> to watch it evolve.
23
+
24
+ ```shell
25
+ bs-simulators --catalogue pendulum
26
+ ```
27
+
28
+ The catalogue also includes a DC motor and a pH neutralization process.
29
+ Use `bs-simulators --list-catalogue` to see the available configurations.
30
+
31
+ ## Run a simulation from Python
32
+
33
+ ```python
34
+ from benchmark_systems.models import pendulum
35
+ from bs_simulators import Simulation
36
+
37
+ simulation = Simulation(
38
+ pendulum, x0=[0.6, 0.0], u0=[0.0],
39
+ parameters={"m": 1.0, "L": 1.0},
40
+ )
41
+ simulation.start(duration=1.0)
42
+ simulation.wait()
43
+ ```
44
+
45
+ The [pendulum control example](https://bs-simulators.readthedocs.io/en/latest/pendulum.html)
46
+ shows how to read measurements and send commands in a control loop. A controller
47
+ in a separate process can use the [HTTP interface](https://bs-simulators.readthedocs.io/en/latest/http.html).
48
+
49
+ [MIT License](LICENSE)
@@ -0,0 +1,388 @@
1
+ <?xml version="1.0" encoding="utf-8" standalone="no"?>
2
+ <!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN"
3
+ "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
4
+ <svg xmlns:xlink="http://www.w3.org/1999/xlink" width="864pt" height="806.4pt" viewBox="0 0 864 806.4" xmlns="http://www.w3.org/2000/svg" version="1.1">
5
+ <metadata>
6
+ <rdf:RDF xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:cc="http://creativecommons.org/ns#" xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#">
7
+ <cc:Work>
8
+ <dc:type rdf:resource="http://purl.org/dc/dcmitype/StillImage"/>
9
+ <dc:date>2026-11-05T13:17:28.739163</dc:date>
10
+ <dc:format>image/svg+xml</dc:format>
11
+ <dc:creator>
12
+ <cc:Agent>
13
+ <dc:title>Matplotlib v3.11.2, https://matplotlib.org/</dc:title>
14
+ </cc:Agent>
15
+ </dc:creator>
16
+ </cc:Work>
17
+ </rdf:RDF>
18
+ </metadata>
19
+ <defs>
20
+ <style type="text/css">*{stroke-linejoin: round; stroke-linecap: butt}</style>
21
+ </defs>
22
+ <g id="figure_1">
23
+ <g id="patch_1">
24
+ <path d="M 0 806.4
25
+ L 864 806.4
26
+ L 864 0
27
+ L 0 0
28
+ z
29
+ " style="fill: #ffffff"/>
30
+ </g>
31
+ <g id="axes_1">
32
+ <g id="patch_2">
33
+ <path d="M 32.6304 27.1152
34
+ L 252.7776 27.1152
35
+ Q 257.7168 27.1152 257.7168 32.0544
36
+ L 257.7168 132.2496
37
+ Q 257.7168 137.1888 252.7776 137.1888
38
+ L 32.6304 137.1888
39
+ Q 27.6912 137.1888 27.6912 132.2496
40
+ L 27.6912 32.0544
41
+ Q 27.6912 27.1152 32.6304 27.1152
42
+ z
43
+ " clip-path="url(#p3f8ce5a2b4)" style="fill: #edf4fb; stroke: #668098; stroke-width: 1.1; stroke-linejoin: miter"/>
44
+ </g>
45
+ <g id="patch_3">
46
+ <path d="M 321.9264 27.1152
47
+ L 542.0736 27.1152
48
+ Q 547.0128 27.1152 547.0128 32.0544
49
+ L 547.0128 132.2496
50
+ Q 547.0128 137.1888 542.0736 137.1888
51
+ L 321.9264 137.1888
52
+ Q 316.9872 137.1888 316.9872 132.2496
53
+ L 316.9872 32.0544
54
+ Q 316.9872 27.1152 321.9264 27.1152
55
+ z
56
+ " clip-path="url(#p3f8ce5a2b4)" style="fill: #edf4fb; stroke: #668098; stroke-width: 1.1; stroke-linejoin: miter"/>
57
+ </g>
58
+ <g id="patch_4">
59
+ <path d="M 611.2224 27.1152
60
+ L 831.3696 27.1152
61
+ Q 836.3088 27.1152 836.3088 32.0544
62
+ L 836.3088 132.2496
63
+ Q 836.3088 137.1888 831.3696 137.1888
64
+ L 611.2224 137.1888
65
+ Q 606.2832 137.1888 606.2832 132.2496
66
+ L 606.2832 32.0544
67
+ Q 606.2832 27.1152 611.2224 27.1152
68
+ z
69
+ " clip-path="url(#p3f8ce5a2b4)" style="fill: #edf4fb; stroke: #668098; stroke-width: 1.1; stroke-linejoin: miter"/>
70
+ </g>
71
+ <g id="patch_5">
72
+ <path d="M 321.9264 217.6272
73
+ L 542.0736 217.6272
74
+ Q 547.0128 217.6272 547.0128 222.5664
75
+ L 547.0128 343.9296
76
+ Q 547.0128 348.8688 542.0736 348.8688
77
+ L 321.9264 348.8688
78
+ Q 316.9872 348.8688 316.9872 343.9296
79
+ L 316.9872 222.5664
80
+ Q 316.9872 217.6272 321.9264 217.6272
81
+ z
82
+ " clip-path="url(#p3f8ce5a2b4)" style="fill: #edf4fb; stroke: #668098; stroke-width: 1.1; stroke-linejoin: miter"/>
83
+ </g>
84
+ <g id="patch_6">
85
+ <path d="M 32.6304 443.4192
86
+ L 252.7776 443.4192
87
+ Q 257.7168 443.4192 257.7168 448.3584
88
+ L 257.7168 569.7216
89
+ Q 257.7168 574.6608 252.7776 574.6608
90
+ L 32.6304 574.6608
91
+ Q 27.6912 574.6608 27.6912 569.7216
92
+ L 27.6912 448.3584
93
+ Q 27.6912 443.4192 32.6304 443.4192
94
+ z
95
+ " clip-path="url(#p3f8ce5a2b4)" style="fill: #edf4fb; stroke: #668098; stroke-width: 1.1; stroke-linejoin: miter"/>
96
+ </g>
97
+ <g id="patch_7">
98
+ <path d="M 321.9264 443.4192
99
+ L 542.0736 443.4192
100
+ Q 547.0128 443.4192 547.0128 448.3584
101
+ L 547.0128 569.7216
102
+ Q 547.0128 574.6608 542.0736 574.6608
103
+ L 321.9264 574.6608
104
+ Q 316.9872 574.6608 316.9872 569.7216
105
+ L 316.9872 448.3584
106
+ Q 316.9872 443.4192 321.9264 443.4192
107
+ z
108
+ " clip-path="url(#p3f8ce5a2b4)" style="fill: #edf4fb; stroke: #668098; stroke-width: 1.1; stroke-linejoin: miter"/>
109
+ </g>
110
+ <g id="patch_8">
111
+ <path d="M 611.2224 443.4192
112
+ L 831.3696 443.4192
113
+ Q 836.3088 443.4192 836.3088 448.3584
114
+ L 836.3088 569.7216
115
+ Q 836.3088 574.6608 831.3696 574.6608
116
+ L 611.2224 574.6608
117
+ Q 606.2832 574.6608 606.2832 569.7216
118
+ L 606.2832 448.3584
119
+ Q 606.2832 443.4192 611.2224 443.4192
120
+ z
121
+ " clip-path="url(#p3f8ce5a2b4)" style="fill: #edf4fb; stroke: #668098; stroke-width: 1.1; stroke-linejoin: miter"/>
122
+ </g>
123
+ <g id="patch_9">
124
+ <path d="M 611.2224 669.2112
125
+ L 831.3696 669.2112
126
+ Q 836.3088 669.2112 836.3088 674.1504
127
+ L 836.3088 767.2896
128
+ Q 836.3088 772.2288 831.3696 772.2288
129
+ L 611.2224 772.2288
130
+ Q 606.2832 772.2288 606.2832 767.2896
131
+ L 606.2832 674.1504
132
+ Q 606.2832 669.2112 611.2224 669.2112
133
+ z
134
+ " clip-path="url(#p3f8ce5a2b4)" style="fill: #edf4fb; stroke: #668098; stroke-width: 1.1; stroke-linejoin: miter"/>
135
+ </g>
136
+ <g id="patch_10">
137
+ <path d="M 142.704 137.07588
138
+ Q 142.704 290.30576 142.704 442.305803
139
+ " clip-path="url(#p3f8ce5a2b4)" style="fill: none; stroke: #253b50; stroke-width: 1.1; stroke-linecap: round"/>
140
+ <path d="M 144.904 437.905803
141
+ L 142.704 442.305803
142
+ L 140.504 437.905803
143
+ z
144
+ " clip-path="url(#p3f8ce5a2b4)" style="fill: #253b50; stroke: #253b50; stroke-width: 1.1; stroke-linecap: round"/>
145
+ </g>
146
+ <g id="patch_11">
147
+ <path d="M 432 137.06942
148
+ Q 432 177.406329 432 216.513401
149
+ " clip-path="url(#p3f8ce5a2b4)" style="fill: none; stroke: #253b50; stroke-width: 1.1; stroke-linecap: round"/>
150
+ <path d="M 434.2 212.113401
151
+ L 432 216.513401
152
+ L 429.8 212.113401
153
+ z
154
+ " clip-path="url(#p3f8ce5a2b4)" style="fill: #253b50; stroke: #253b50; stroke-width: 1.1; stroke-linecap: round"/>
155
+ </g>
156
+ <g id="patch_12">
157
+ <path d="M 719.705235 136.280982
158
+ Q 633.096829 202.10337 547.467574 267.181604
159
+ " clip-path="url(#p3f8ce5a2b4)" style="fill: none; stroke: #253b50; stroke-width: 1.1; stroke-linecap: round"/>
160
+ <path d="M 552.301871 266.270794
161
+ L 547.467574 267.181604
162
+ L 549.639505 262.76768
163
+ z
164
+ " clip-path="url(#p3f8ce5a2b4)" style="fill: #253b50; stroke: #253b50; stroke-width: 1.1; stroke-linecap: round"/>
165
+ </g>
166
+ <g id="patch_13">
167
+ <path d="M 317.727275 305.865185
168
+ Q 252.07303 374.974916 187.265835 443.193016
169
+ " clip-path="url(#p3f8ce5a2b4)" style="fill: none; stroke: #253b50; stroke-width: 1.1; stroke-linecap: round"/>
170
+ <path d="M 191.891331 441.518268
171
+ L 187.265835 443.193016
172
+ L 188.701333 438.48777
173
+ z
174
+ " clip-path="url(#p3f8ce5a2b4)" style="fill: #253b50; stroke: #253b50; stroke-width: 1.1; stroke-linecap: round"/>
175
+ </g>
176
+ <g id="patch_14">
177
+ <path d="M 317.107872 509.04
178
+ Q 287.354415 509.04 258.830795 509.04
179
+ " clip-path="url(#p3f8ce5a2b4)" style="fill: none; stroke: #253b50; stroke-width: 1.1; stroke-linecap: round"/>
180
+ <path d="M 263.230795 511.24
181
+ L 258.830795 509.04
182
+ L 263.230795 506.84
183
+ z
184
+ " clip-path="url(#p3f8ce5a2b4)" style="fill: #253b50; stroke: #253b50; stroke-width: 1.1; stroke-linecap: round"/>
185
+ </g>
186
+ <g id="patch_15">
187
+ <path d="M 606.403872 509.04
188
+ Q 576.650415 509.04 548.126795 509.04
189
+ " clip-path="url(#p3f8ce5a2b4)" style="fill: none; stroke: #253b50; stroke-width: 1.1; stroke-linecap: round"/>
190
+ <path d="M 552.526795 511.24
191
+ L 548.126795 509.04
192
+ L 552.526795 506.84
193
+ z
194
+ " clip-path="url(#p3f8ce5a2b4)" style="fill: #253b50; stroke: #253b50; stroke-width: 1.1; stroke-linecap: round"/>
195
+ </g>
196
+ <g id="patch_16">
197
+ <path d="M 721.296 669.329288
198
+ Q 721.296 621.936455 721.296 575.77346
199
+ " clip-path="url(#p3f8ce5a2b4)" style="fill: none; stroke: #253b50; stroke-width: 1.1; stroke-linecap: round"/>
200
+ <path d="M 719.096 580.17346
201
+ L 721.296 575.77346
202
+ L 723.496 580.17346
203
+ z
204
+ " clip-path="url(#p3f8ce5a2b4)" style="fill: #253b50; stroke: #253b50; stroke-width: 1.1; stroke-linecap: round"/>
205
+ </g>
206
+ <g id="line2d_1">
207
+ <path d="M 36.864 64.512
208
+ L 248.544 64.512
209
+ " clip-path="url(#p3f8ce5a2b4)" style="fill: none; stroke: #bdcddd; stroke-width: 0.8; stroke-linecap: square"/>
210
+ </g>
211
+ <g id="line2d_2">
212
+ <path d="M 326.16 64.512
213
+ L 537.84 64.512
214
+ " clip-path="url(#p3f8ce5a2b4)" style="fill: none; stroke: #bdcddd; stroke-width: 0.8; stroke-linecap: square"/>
215
+ </g>
216
+ <g id="line2d_3">
217
+ <path d="M 615.456 64.512
218
+ L 827.136 64.512
219
+ " clip-path="url(#p3f8ce5a2b4)" style="fill: none; stroke: #bdcddd; stroke-width: 0.8; stroke-linecap: square"/>
220
+ </g>
221
+ <g id="line2d_4">
222
+ <path d="M 326.16 255.024
223
+ L 537.84 255.024
224
+ " clip-path="url(#p3f8ce5a2b4)" style="fill: none; stroke: #bdcddd; stroke-width: 0.8; stroke-linecap: square"/>
225
+ </g>
226
+ <g id="line2d_5">
227
+ <path d="M 36.864 480.816
228
+ L 248.544 480.816
229
+ " clip-path="url(#p3f8ce5a2b4)" style="fill: none; stroke: #bdcddd; stroke-width: 0.8; stroke-linecap: square"/>
230
+ </g>
231
+ <g id="line2d_6">
232
+ <path d="M 326.16 480.816
233
+ L 537.84 480.816
234
+ " clip-path="url(#p3f8ce5a2b4)" style="fill: none; stroke: #bdcddd; stroke-width: 0.8; stroke-linecap: square"/>
235
+ </g>
236
+ <g id="line2d_7">
237
+ <path d="M 615.456 480.816
238
+ L 827.136 480.816
239
+ " clip-path="url(#p3f8ce5a2b4)" style="fill: none; stroke: #bdcddd; stroke-width: 0.8; stroke-linecap: square"/>
240
+ </g>
241
+ <g id="line2d_8">
242
+ <path d="M 615.456 706.608
243
+ L 827.136 706.608
244
+ " clip-path="url(#p3f8ce5a2b4)" style="fill: none; stroke: #bdcddd; stroke-width: 0.8; stroke-linecap: square"/>
245
+ </g>
246
+ <g id="text_1">
247
+ <text style="font-weight: 700; font-size: 11px; font-family: 'DejaVu Sans'; text-anchor: middle; fill: #253b50" x="142.704" y="53.257852" transform="rotate(-0 142.704 53.257852)">Direct Python setup</text>
248
+ </g>
249
+ <g id="text_2">
250
+ <text style="font-size: 10px; font-family: 'DejaVu Sans'; text-anchor: start; fill: #253b50" x="40.392" y="85.355375" transform="rotate(-0 40.392 85.355375)">model, parameters, x0, u0</text>
251
+ </g>
252
+ <g id="text_3">
253
+ <text style="font-weight: 700; font-size: 11px; font-family: 'DejaVu Sans'; text-anchor: middle; fill: #253b50" x="432" y="53.257852" transform="rotate(-0 432 53.257852)">Bundled / custom TOML</text>
254
+ </g>
255
+ <g id="text_4">
256
+ <text style="font-size: 10px; font-family: 'DejaVu Sans'; text-anchor: start; fill: #253b50" x="329.688" y="85.355375" transform="rotate(-0 329.688 85.355375)">Reusable experiment data</text>
257
+ </g>
258
+ <g id="text_5">
259
+ <text style="font-weight: 700; font-size: 11px; font-family: 'DejaVu Sans'; text-anchor: middle; fill: #253b50" x="721.296" y="53.257422" transform="rotate(-0 721.296 53.257422)">Typer CLI</text>
260
+ </g>
261
+ <g id="text_6">
262
+ <text style="font-size: 10px; font-family: 'DejaVu Sans'; text-anchor: start; fill: #253b50" x="618.984" y="86.324125" transform="rotate(-0 618.984 86.324125)">Selection and overrides</text>
263
+ </g>
264
+ <g id="text_7">
265
+ <text style="font-weight: 700; font-size: 11px; font-family: 'DejaVu Sans'; text-anchor: middle; fill: #253b50" x="432" y="243.769852" transform="rotate(-0 432 243.769852)">SimulationConfiguration</text>
266
+ </g>
267
+ <g id="text_8">
268
+ <text style="font-size: 10px; font-family: 'DejaVu Sans'; fill: #253b50" transform="translate(329.688 275.867375)">Reusable setup data</text>
269
+ <text style="font-size: 10px; font-family: 'DejaVu Sans'; fill: #253b50" transform="translate(329.688 291.247844)">create(overrides)</text>
270
+ </g>
271
+ <g id="text_9">
272
+ <text style="font-weight: 700; font-size: 11px; font-family: 'DejaVu Sans'; text-anchor: middle; fill: #253b50" x="142.704" y="469.561852" transform="rotate(-0 142.704 469.561852)">Simulation</text>
273
+ </g>
274
+ <g id="text_10">
275
+ <text style="font-size: 10px; font-family: 'DejaVu Sans'; fill: #253b50" transform="translate(40.392 501.659375)">Worker, clock, snapshots</text>
276
+ <text style="font-size: 10px; font-family: 'DejaVu Sans'; fill: #253b50" transform="translate(40.392 516.571094)">Owns a Stepper</text>
277
+ </g>
278
+ <g id="text_11">
279
+ <text style="font-weight: 700; font-size: 11px; font-family: 'DejaVu Sans'; text-anchor: middle; fill: #253b50" x="432" y="469.561852" transform="rotate(-0 432 469.561852)">InMemoryAdapter</text>
280
+ </g>
281
+ <g id="text_12">
282
+ <text style="font-size: 10px; font-family: 'DejaVu Sans'; fill: #253b50" transform="translate(329.688 502.628125)">Uses SimulationPort</text>
283
+ <text style="font-size: 10px; font-family: 'DejaVu Sans'; fill: #253b50" transform="translate(329.688 516.659375)">Binds controller identity</text>
284
+ </g>
285
+ <g id="text_13">
286
+ <text style="font-weight: 700; font-size: 11px; font-family: 'DejaVu Sans'; text-anchor: middle; fill: #253b50" x="721.296" y="469.561852" transform="rotate(-0 721.296 469.561852)">Local HTTP server</text>
287
+ </g>
288
+ <g id="text_14">
289
+ <text style="font-size: 10px; font-family: 'DejaVu Sans'; fill: #253b50" transform="translate(618.984 501.659375)">Reads state / submits inputs</text>
290
+ <text style="font-size: 10px; font-family: 'DejaVu Sans'; fill: #253b50" transform="translate(618.984 516.659375)">Serves a packaged scene</text>
291
+ </g>
292
+ <g id="text_15">
293
+ <text style="font-weight: 700; font-size: 11px; font-family: 'DejaVu Sans'; text-anchor: middle; fill: #253b50" x="721.296" y="695.353852" transform="rotate(-0 721.296 695.353852)">Browser / HTTP client</text>
294
+ </g>
295
+ <g id="text_16">
296
+ <text style="font-size: 10px; font-family: 'DejaVu Sans'; text-anchor: start; fill: #253b50" x="618.984" y="728.420125" transform="rotate(-0 618.984 728.420125)">Poll state or send commands</text>
297
+ </g>
298
+ <g id="text_17">
299
+ <g id="patch_17">
300
+ <path d="M 120.585797 284.238
301
+ L 164.822203 284.238
302
+ L 164.822203 273.258
303
+ L 120.585797 273.258
304
+ z
305
+ " style="fill: #ffffff"/>
306
+ </g>
307
+ <text style="font-size: 9px; font-family: 'DejaVu Sans'; text-anchor: middle; fill: #253b50" x="142.704" y="281.085891" transform="rotate(-0 142.704 281.085891)">construct</text>
308
+ </g>
309
+ <g id="text_18">
310
+ <g id="patch_18">
311
+ <path d="M 421.391953 171.342
312
+ L 442.608047 171.342
313
+ L 442.608047 160.361297
314
+ L 421.391953 160.361297
315
+ z
316
+ " style="fill: #ffffff"/>
317
+ </g>
318
+ <text style="font-size: 9px; font-family: 'DejaVu Sans'; text-anchor: middle; fill: #253b50" x="432" y="168.189891" transform="rotate(-0 432 168.189891)">load</text>
319
+ </g>
320
+ <g id="text_19">
321
+ <g id="patch_19">
322
+ <path d="M 629.309375 196.008
323
+ L 693.330625 196.008
324
+ L 693.330625 186.087375
325
+ L 629.309375 186.087375
326
+ z
327
+ " style="fill: #ffffff"/>
328
+ </g>
329
+ <text style="font-size: 8px; font-family: 'DejaVu Sans'; text-anchor: middle; fill: #253b50" x="661.32" y="193.126125" transform="rotate(-0 661.32 193.126125)">select + override</text>
330
+ </g>
331
+ <g id="text_20">
332
+ <g id="patch_20">
333
+ <path d="M 226.229906 368.91
334
+ L 263.802094 368.91
335
+ L 263.802094 357.93
336
+ L 226.229906 357.93
337
+ z
338
+ " style="fill: #ffffff"/>
339
+ </g>
340
+ <text style="font-size: 9px; font-family: 'DejaVu Sans'; text-anchor: middle; fill: #253b50" x="245.016" y="365.757891" transform="rotate(-0 245.016 365.757891)">create()</text>
341
+ </g>
342
+ <g id="text_21">
343
+ <g id="patch_21">
344
+ <path d="M 276.052781 502.974
345
+ L 298.651219 502.974
346
+ L 298.651219 491.994
347
+ L 276.052781 491.994
348
+ z
349
+ " style="fill: #ffffff"/>
350
+ </g>
351
+ <text style="font-size: 9px; font-family: 'DejaVu Sans'; text-anchor: middle; fill: #253b50" x="287.352" y="499.821891" transform="rotate(-0 287.352 499.821891)">uses</text>
352
+ </g>
353
+ <g id="text_22">
354
+ <g id="patch_22">
355
+ <path d="M 565.348781 502.974
356
+ L 587.947219 502.974
357
+ L 587.947219 491.994
358
+ L 565.348781 491.994
359
+ z
360
+ " style="fill: #ffffff"/>
361
+ </g>
362
+ <text style="font-size: 9px; font-family: 'DejaVu Sans'; text-anchor: middle; fill: #253b50" x="576.648" y="499.821891" transform="rotate(-0 576.648 499.821891)">uses</text>
363
+ </g>
364
+ <g id="text_23">
365
+ <g id="patch_23">
366
+ <path d="M 708.790219 615.87
367
+ L 733.801781 615.87
368
+ L 733.801781 604.89
369
+ L 708.790219 604.89
370
+ z
371
+ " style="fill: #ffffff"/>
372
+ </g>
373
+ <text style="font-size: 9px; font-family: 'DejaVu Sans'; text-anchor: middle; fill: #253b50" x="721.296" y="612.717891" transform="rotate(-0 721.296 612.717891)">HTTP</text>
374
+ </g>
375
+ <g id="text_24">
376
+ <text style="font-size: 9px; font-family: 'DejaVu Sans'; text-anchor: middle; fill: #253b50" x="432" y="389.088" transform="rotate(-0 432 389.088)">Configuration ends at construction; the core runs independently.</text>
377
+ </g>
378
+ <g id="text_25">
379
+ <text style="font-size: 9px; font-family: 'DejaVu Sans'; text-anchor: middle; fill: #253b50" x="432" y="621.936" transform="rotate(-0 432 621.936)">CLI owns simulation and server lifecycle. Direct Python code can own them instead.</text>
380
+ </g>
381
+ </g>
382
+ </g>
383
+ <defs>
384
+ <clipPath id="p3f8ce5a2b4">
385
+ <rect x="8.64" y="8.064" width="846.72" height="790.272"/>
386
+ </clipPath>
387
+ </defs>
388
+ </svg>