Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
42 changes: 30 additions & 12 deletions docs/bobsim/lotus-shark-import.md
Original file line number Diff line number Diff line change
Expand Up @@ -76,13 +76,18 @@ catches geometry edited after the datum was last verified.

## Overlay Report

The overlay report plots the imported ("variant") car's suspension kinematic
curves against the tracked baseline car, for both front and rear axles, across
bump, roll, and (front axle only) steer sweeps — the same curve set as the
app's own kinematics view (camber, toe, roll centre, instant centres, and
related metrics). Steer curves are plotted against the solved road-wheel
steer angle rather than commanded rack travel; the rear axle has no steer
panels, since it isn't steered.
The overlay report plots the imported ("variant") car's kinematic curves over
the tracked baseline car. It uses the same curves as the app's kinematics view.

| Sweep | Axles | Range | X-axis |
| :-- | :-- | :-- | :-- |
| Bump | Front and rear | ±40 mm jounce, 21 points | Jounce |
| Roll | Front and rear | ±1.5° body roll, 21 points | Roll angle |
| Steer | Front only | ±30 mm rack travel, 21 points | Solved road-wheel steer angle |

The steer sweep plots camber, scrub radius, mechanical trail, roll-centre y
and z, kingpin inclination, and caster. The x-axis is the steer angle that the
solver finds, not the rack travel. The rear axle has no steer panels.

```bash
make shark-overlay SHARK=<shark.shk>
Expand All @@ -95,11 +100,24 @@ _3_StandardSim/generated_results/shark_overlay_report.pdf
_3_StandardSim/generated_results/shark_overlay_report.md
```

The PDF includes a cover/notes page, paginated summary tables (design-position
values, working-range slope, peak delta, and significance ranked against
configurable tolerances via `--tol-deg`/`--tol-mm`), a headline grid of curves
that exceed tolerance, and a full appendix grid of every curve/axle pair. The
Markdown summary mirrors the same tables.
The PDF includes a cover page, a run notes page, paginated summary tables
(design-position values, working-range slope, peak delta, and significance
ranked against configurable tolerances via `--tol-deg`/`--tol-mm`), a headline
grid of curves that exceed tolerance, and a full appendix grid of every
curve/axle pair. The Markdown summary mirrors the same tables.

<article class="sample-output-card">
<p class="sample-output-label">Sample Overlay Report</p>
<p>
Generated from the rear-axle test fixture <code>tests/fixtures/rear_pushrod.shk</code>.
The datum gate is closed, so z-dependent curves are withheld. The front axle
is unchanged, so its bump, roll, and steer curves coincide.
</p>
<div class="sample-output-links">
<a href="/shark_overlay_report_69e561ac.pdf" target="_blank" rel="noreferrer">Open PDF report</a>
</div>
<PdfEmbed src="/shark_overlay_report_69e561ac.pdf" max-height="34rem" />
</article>

### Four-Post Section

Expand Down
4 changes: 4 additions & 0 deletions docs/bobsim/visualization.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,10 @@ powertrain inputs.

![BobSim Geometry setup preview showing hardpoints, suspension links, and kinematic plot controls](/images/bobsim/app-setup-geometry.png)

The kinematic plots cover bump, roll, and steer sweeps. Steer plots are front
axle only. See [Overlay Report](/bobsim/lotus-shark-import#overlay-report) for
the sweep ranges.

Tire setup has a dedicated preview path for `.tir` data. The `Load maps` tab
renders pure longitudinal, pure lateral, combined longitudinal, and combined
lateral tire force surfaces from the active tire evaluation.
Expand Down
Binary file added docs/public/shark_overlay_report_69e561ac.pdf
Binary file not shown.
Loading