Skip to content

docs: refresh the README "Tested against" benchmark - #85

Merged
bmxcode merged 1 commit into
mainfrom
readme-tested-against-refresh
Sep 5, 2026
Merged

bmxcode merged 1 commit into
mainfrom
readme-tested-against-refresh

Conversation

@bmxcode

@bmxcode bmxcode commented Sep 5, 2026

Copy link
Copy Markdown
Owner

Closes #84. The "Tested against" figures were two deliverables stale, and refreshing them turned out to need a benchmark fix, not just a table paste (that's why it was deferred out of the 0.5.0 release).

scripts/benchmark.py

  • Scopes to the curated disc collection. It now walks only active/archive/blocked, skipping incoming/ (staging + the E-mu .exb oracle corpus that D34's stereo verification uses) and oracles/. Pointed at the whole shelf before, it counted the 60 loose E-mu bank trees from D35 as "disc images" (166 total) and listed ~60 .exb names as pseudo-sources. Those loose banks are their own README section, not disc images from the six sources.
  • Completes the by-filesystem table. Added HFS (SampleCell) and Kurzweil KMSI rows — both filesystems were converting (D28/D29, D32/D33) but absent from FS_ORDER, so their ~11.6k samples sat in the total with no row. The table now sums exactly to the sample total, and its Skipped column decomposes the headline damage count (AKAI 25 + Kurzweil 7 = 32 = damage 30 + not-placed 2).

README "Tested against"

Regenerated against the 106-disc collection:

  • 106 disc images from six sources (was 104 — nnty 9→11, raw CD 5→7), 102 converted.
  • Entries "not the file their entry placed": 104 → 2 — D38 landed. The paragraph is rewritten: 102 recovered, the two that stay refused (AMG - Loop Soup, Library.3's CHINA2-R) named.
  • Samples 137 854 → 150 640; stereo pairs 17 369 → 19 504; byte-identity 126 253 → 126 351 payloads; 170 305 WAVs written; rates across 1 761 values. The two SampleCell discs' machfs byte check is noted.

The EBL/AIFF prose and the short-image/displaced-partition narrative (D20) are unchanged — still accurate.

Verify

ruff check · ruff format --check · pytest -q all pass. The figures come from uv run python scripts/benchmark.py ~/…/sample-images (a real batch run over the collection).

🤖 Generated with Claude Code

The figures were two deliverables stale and the benchmark walked staging.

scripts/benchmark.py now walks only the curated disc states
(active/archive/blocked), skipping incoming/ (staging and the E-mu .exb
oracle corpus) and oracles/ — so it counts the six disc sources (106
images), not the 60 loose bank trees D35 converts, which have their own
README section. It also gains an HFS (SampleCell) and a Kurzweil (KMSI)
row in the by-filesystem table; both filesystems were converting but
absent from it, so the table now sums exactly to the sample total.

README "Tested against" is regenerated against the 106-disc collection:
102 of 106 converted, 150 640 samples, and — the headline change — the
"entries not the file their entry placed" count falls 104 → 2 as D38's
recovery lands (the paragraph is rewritten to match, naming the two that
stay refused). Byte-identity 126 351 payloads, 170 305 WAVs written,
rates across 1 761 values; the SampleCell discs' machfs check is noted.

Closes #84.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@bmxcode
bmxcode merged commit 47c7d92 into main Sep 5, 2026
2 checks passed
@bmxcode
bmxcode deleted the readme-tested-against-refresh branch September 5, 2026 11:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Refresh the README "Tested against" section for the grown disc shelf

1 participant