ssl-vista 0.2.3

A Qt-based visualization app

ssl_vista

Qt-based visualization app for simulation outputs generated by ssl-simulator.

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
• docs/: MkDocs documentation

Development tasks

just test
just test-fast
just lint
just typecheck
just security
just docs
just docs-build
just validate-docs

Documentation

See MkDocs pages in docs/:

• usage and controls
• architecture
• layout and data schemas
• plotter development
• API reference
• troubleshooting

License

MIT