The repository for all things vehicle dynamics (VDX) at UBC Solar! This repo holds simulation, calculation, and data analysis files for the past, present, and future development of our suspension, steering, and braking systems.
| Tracked | Added to Search Path | Purpose | |
|---|---|---|---|
| indev/ | ✗ | ✗ | local development, potentially with name collisions |
| local/ | ✗ | ✓ | private files such as .env, local development of dependencies |
| sandbox/ | ✓ | ✗ | one-off calculations, sharing rudimentary scripts |
| others | ✓ | ✓ | orderly, documented, reusable scripts (most things) |
Moving forward, vdx-simulation has deprecated binary .mlx live scripts in favour of R2025a .m plain text live scripts. This will keep our codebase more maintainable and make editing, merges, and blame easier.
All live scripts commited to the repository should first have Clear All Output ran in MATLAB to keep diff sizes small. In future, a pre-commit hook will be set up to lint for un-cleared output.
startup.m is a MATLAB startup file that automatically runs when MATLAB is launched from the repository root. It seamlessly sets up your session path to include to include cetain folders. It also runs fetches remote and prints git status on startup for convenience.
Important
Many scripts rely on dependencies in this repository, and expect them to be on your session path. As such, downloading individual scripts and attempting to run them will be unlikely to work. Clone the whole repository.