ssl_vista

Qt-based visualization app for simulation outputs generated by https://github.com/Swarm-Systems-Lab/ssl_simulator.

pip install ssl_vista

sslvista --list-layouts
sslvista --list-data
sslvista --layout 2d_canvas --data-path data_uny_test

What it provides

• CLI app: sslvista
• Configurable multi-panel layout system (JSON)
• Built-in PyVista plotters for 2D/3D scenes
• Optional Matplotlib plotters loaded from Python files

Quick start (development)

git clone https://github.com/Swarm-Systems-Lab/ssl_simulator_vista
cd ssl_vista
just setup

uv run sslvista --list-layouts
uv run sslvista --list-data
uv run sslvista --layout 2d_canvas --data-path data_uny_test

CLI usage

uv run sslvista --help

Common commands:

# bundled resources
uv run sslvista --list-layouts
uv run sslvista --list-data

# run bundled layout + bundled sample
uv run sslvista --layout 3d_canvas --data-path data_3d_test

# run custom files
uv run sslvista --layout ./my_layout.json --data-path ./my_run.csv

# start in autoplay mode
uv run sslvista --layout 2d_canvas --data-path data_uny_test --auto-play

Project structure

• src/ssl_vista/cli.py: CLI entrypoint
• src/ssl_vista/ui/main_window.py: app orchestration and playback
• src/ssl_vista/ui/grid.py: layout loader and plotter grid
• src/ssl_vista/plotters/: built-in plotters and plotter base classes
• src/ssl_vista/data/: bundled layouts, samples, and assets

License

MIT