# Vehicle Lab: A Reusable Engineering Notebook

> Connect design intent, inspectable 3D geometry, revision decisions, and recorded simulation evidence in a portable project.

## Summary
Vehicle Lab turns an experimental vehicle study into a reusable engineering notebook. A 96-second film follows real CAD-derived geometry through ideation, digital prototyping, mechanical inspection, revision comparison, and an archived Project Chrono obstacle run. Create a separate project, import grouped OBJ geometry, inspect revision decisions and original evidence, and attach recorded body states through a documented JSON contract. A small linear-stage example retains a failed fit alongside its revised clearance check. The viewer preserves failed results and source hashes; the vehicle remains unqualified for fabrication or riding.

## Project Figures

![Vehicle Lab body study in the interactive engineering notebook](https://zack-dev-cm.github.io/docs/images/vehicle-lab-poster.jpg)

![Mechanical inspection of the vehicle frame, suspension, wheels, and chain drive](https://zack-dev-cm.github.io/docs/images/vehicle-lab-inspection.jpg)

## Project Link
https://zack-dev-cm.github.io/projects/vehicle-lab-a-reusable-engineering-notebook.md

## Key Features
- Reusable project CLI, manifest schema, and original desk-rover starter
- 3D orbit, subsystem isolation, wireframe, and exploded inspection
- Revision graph and scoped evidence with source and asset checksums
- Engine-neutral replay interface with an explicit recorded-pose contract
- Eleven documentation pages and a captioned 1080p pipeline film

## Tech Stack
- Python
- Three.js
- FreeCAD exports
- Project Chrono data
- Playwright
- FFmpeg

## Benchmarks & Analytics
- Film: 96 seconds (1920 x 1080, 24 fps; actual browser capture)
- Vehicle studies: 4 (CAD-derived display snapshots with separate engineering scopes)
- Physical validation: Open (Digital examples; no qualified hardware release)

## Links
- [Source on GitHub](https://github.com/zack-dev-cm/vehicle-lab)
- [Explore Vehicle Lab](https://zack-dev-cm.github.io/docs/vehicle-lab/)
- [Read the documentation](https://zack-dev-cm.github.io/docs/vehicle-lab/docs/)
- [Download source v0.1.0](https://zack-dev-cm.github.io/docs/vehicle-lab/downloads/vehicle-lab-0.1.0.tar.gz)