Skip to content

Commit e03830f

Browse files
RFloEngclaude
andcommitted
Add virtual scroll, bundle loading, and quick-start docs
Browser: - Virtual scroll engine (vsFlush/vsInit/_vsFrame) for Index and Heatmap tables — only ~70 DOM rows rendered at any time regardless of library size; 1 400+ cars scroll smoothly - index.json + curves.json bundle loading: drop pre-generated Python exports directly onto the browser for instant load without raw SVJ files; curves.json restores torque/power/damper curve data - Blue info banner in bundle mode; warning when curves.json is absent - Fixed row height CSS (30 px) for predictable virtual-scroll geometry Docs: - Added Quick start section to MANUAL.md covering both tools from scratch (open HTML file, pip install + CLI command) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
1 parent b0189f7 commit e03830f

2 files changed

Lines changed: 288 additions & 77 deletions

File tree

MANUAL.md

Lines changed: 39 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,45 @@ This manual covers both delivery modes — the single-file HTML browser and the
44

55
---
66

7+
## Quick start
8+
9+
### HTML browser (no install)
10+
11+
1. Locate `svj_library_browser.html` in the project folder.
12+
2. Double-click it — it opens in your default browser. Or right-click → *Open with* → choose Chrome, Edge, Firefox, or Safari.
13+
3. Drag your SVJ library (folder, `.zip`, or individual `.svj.json` files) onto the **drop bar** at the top of the page, or use the **Pick folder** / **Pick files** buttons.
14+
4. Done — all tabs are live immediately.
15+
16+
> **No internet? No problem.** The file works offline once opened. The only online requirement is the first load of Plotly and JSZip from their CDN. For permanent air-gapped use, download both JS libraries and replace the two `<script src="…">` lines at the top of the HTML.
17+
18+
### Python toolkit
19+
20+
**Requirements:** Python 3.9 or later, plus one package:
21+
22+
```bash
23+
pip install openpyxl
24+
```
25+
26+
**Run it:**
27+
28+
```bash
29+
# Point at a folder of .svj.json files (any depth of subfolders)
30+
python svj_analyze.py /path/to/your/svj_library --out ./report
31+
32+
# Or point at a .zip archive
33+
python svj_analyze.py library_snapshot.zip --out ./report
34+
```
35+
36+
Outputs land in `./report/`: an Excel workbook (`library.xlsx`) plus six JSON files. Drop `index.json` and `curves.json` from that folder onto the HTML browser for instant large-library browsing — no re-parsing needed.
37+
38+
**Sanity checks only (no file output):**
39+
40+
```bash
41+
python svj_analyze.py check /path/to/your/svj_library
42+
```
43+
44+
---
45+
746
## Contents
847

948
1. [HTML browser](#1-html-browser)

0 commit comments

Comments
 (0)