updated structure of how we document the optimizations

2026-05-20 09:26:22 +02:00
parent 1718a2122f
commit 3ce1c8cc2e
4 changed files with 257 additions and 166 deletions
@@ -0,0 +1,65 @@
+# Optimization: Baseline
+
+- **Author**: TBD
+- **Predecessor**: N/A (initial reference)
+- **File(s)**: variants/variant_baseline.cpp
+- **Status**: reference
+
+## What this changes
+
+This is the unoptimized reference implementation of the social force model.
+Every other optimization is measured relative to it. See the source file for
+the full implementation; key functions are `w()`, `acceleration_term_dt()`,
+`pedestrian_repulsion_dt()`, `obstacle_repulsion_dt()`, and `run_simulation()`.
+
+## Code (relevant snippet)
+
+TBD
+
+## Benchmark
+
+Conditions: TBD.
+
+### x86
+
+**Machine**:
+
+```
+TBD
+```
+
+**Frequency**: TBD
+
+| N    | W(n) [Flops] | T(n) [Cycles] | Performance [Flops/Cycle] | Diff vs Predecessor |
+| ---- | ------------ | ------------- | ------------------------- | ------------------- |
+| 50   |              |               |                           | -                   |
+| 100  |              |               |                           | -                   |
+| 200  |              |               |                           | -                   |
+| 500  |              |               |                           | -                   |
+| 1000 |              |               |                           | -                   |
+
+### ARM (Apple)
+
+**Machine**:
+
+```
+TBD
+```
+
+**Frequency**: TBD
+
+| N    | W(n) [Flops] | T(n) [Cycles] | Performance [Flops/Cycle] | Diff vs Predecessor |
+| ---- | ------------ | ------------- | ------------------------- | ------------------- |
+| 50   |              |               |                           | -                   |
+| 100  |              |               |                           | -                   |
+| 200  |              |               |                           | -                   |
+| 500  |              |               |                           | -                   |
+| 1000 |              |               |                           | -                   |
+
+## Analysis
+
+TBD
+
+## Takeaway
+
+TBD