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.
- bs_simulators-0.1.2/.python-version +1 -0
- bs_simulators-0.1.2/.readthedocs.yaml +13 -0
- bs_simulators-0.1.2/AGENTS.md +37 -0
- bs_simulators-0.1.2/LICENSE +21 -0
- bs_simulators-0.1.2/LICENSE.benchmark-systems +21 -0
- bs_simulators-0.1.2/PKG-INFO +65 -0
- bs_simulators-0.1.2/README.md +49 -0
- bs_simulators-0.1.2/docs/_static/architecture/configuration-access.svg +388 -0
- bs_simulators-0.1.2/docs/_static/architecture/functional-core.svg +385 -0
- bs_simulators-0.1.2/docs/_static/architecture/runtime-sequence.svg +452 -0
- bs_simulators-0.1.2/docs/api.md +143 -0
- bs_simulators-0.1.2/docs/architecture.md +100 -0
- bs_simulators-0.1.2/docs/catalogue.md +322 -0
- bs_simulators-0.1.2/docs/common-pitfalls.md +60 -0
- bs_simulators-0.1.2/docs/conf.py +34 -0
- bs_simulators-0.1.2/docs/development.md +79 -0
- bs_simulators-0.1.2/docs/http.md +81 -0
- bs_simulators-0.1.2/docs/index.md +51 -0
- bs_simulators-0.1.2/docs/installation.md +31 -0
- bs_simulators-0.1.2/docs/pendulum.md +168 -0
- bs_simulators-0.1.2/docs/recording.md +69 -0
- bs_simulators-0.1.2/docs/requirements.txt +44 -0
- bs_simulators-0.1.2/docs/simulation.md +219 -0
- bs_simulators-0.1.2/examples/pendulum_core.ipynb +479 -0
- bs_simulators-0.1.2/examples/pendulum_signal_adapter.py +83 -0
- bs_simulators-0.1.2/examples/pendulum_sil_controller.py +66 -0
- bs_simulators-0.1.2/examples/pendulum_sil_replay.py +75 -0
- bs_simulators-0.1.2/pyproject.toml +80 -0
- bs_simulators-0.1.2/src/bs_simulators/__init__.py +44 -0
- bs_simulators-0.1.2/src/bs_simulators/__main__.py +12 -0
- bs_simulators-0.1.2/src/bs_simulators/catalogue/__init__.py +160 -0
- bs_simulators-0.1.2/src/bs_simulators/catalogue/_validation.py +159 -0
- bs_simulators-0.1.2/src/bs_simulators/catalogue/dc-motor.toml +46 -0
- bs_simulators-0.1.2/src/bs_simulators/catalogue/neutralization.toml +63 -0
- bs_simulators-0.1.2/src/bs_simulators/catalogue/pendulum.toml +37 -0
- bs_simulators-0.1.2/src/bs_simulators/cli/__init__.py +5 -0
- bs_simulators-0.1.2/src/bs_simulators/cli/commands.py +154 -0
- bs_simulators-0.1.2/src/bs_simulators/cli/configuration.py +50 -0
- bs_simulators-0.1.2/src/bs_simulators/cli/execution.py +53 -0
- bs_simulators-0.1.2/src/bs_simulators/cli/presentation.py +134 -0
- bs_simulators-0.1.2/src/bs_simulators/comms/__init__.py +5 -0
- bs_simulators-0.1.2/src/bs_simulators/comms/adapters.py +47 -0
- bs_simulators-0.1.2/src/bs_simulators/comms/http.py +179 -0
- bs_simulators-0.1.2/src/bs_simulators/runtime/__init__.py +9 -0
- bs_simulators-0.1.2/src/bs_simulators/runtime/_validation.py +51 -0
- bs_simulators-0.1.2/src/bs_simulators/runtime/core.py +471 -0
- bs_simulators-0.1.2/src/bs_simulators/runtime/protocols.py +174 -0
- bs_simulators-0.1.2/src/bs_simulators/runtime/signals.py +51 -0
- bs_simulators-0.1.2/src/bs_simulators/runtime/steppers.py +275 -0
- bs_simulators-0.1.2/src/bs_simulators/viewers/__init__.py +13 -0
- bs_simulators-0.1.2/src/bs_simulators/viewers/dc-motor.html +25 -0
- bs_simulators-0.1.2/src/bs_simulators/viewers/neutralization.html +25 -0
- bs_simulators-0.1.2/src/bs_simulators/viewers/pendulum.html +25 -0
- bs_simulators-0.1.2/src/bs_simulators/viewers/scenes.js +143 -0
- bs_simulators-0.1.2/src/bs_simulators/viewers/viewer.css +10 -0
- bs_simulators-0.1.2/src/bs_simulators/viewers/viewer.js +48 -0
- bs_simulators-0.1.2/tests/test_bundled_experiments.py +102 -0
- bs_simulators-0.1.2/tests/test_catalogue.py +186 -0
- bs_simulators-0.1.2/tests/test_cli.py +442 -0
- bs_simulators-0.1.2/tests/test_dae_failure.py +36 -0
- bs_simulators-0.1.2/tests/test_distribution.py +78 -0
- bs_simulators-0.1.2/tests/test_generic_simulation.py +453 -0
- bs_simulators-0.1.2/tests/test_simulation.py +338 -0
- bs_simulators-0.1.2/tests/test_simulation_adapters.py +336 -0
- bs_simulators-0.1.2/tests/viewer_scales.test.mjs +74 -0
|
@@ -0,0 +1 @@
|
|
|
1
|
+
3.13
|
|
@@ -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>
|