Skip to content

docs: document Blackwell (sm 12.0) GPU support in README#750

Open
waltsims wants to merge 1 commit into
masterfrom
docs-readme-blackwell-support
Open

docs: document Blackwell (sm 12.0) GPU support in README#750
waltsims wants to merge 1 commit into
masterfrom
docs-readme-blackwell-support

Conversation

@waltsims
Copy link
Copy Markdown
Owner

@waltsims waltsims commented May 21, 2026

Summary

  • README claimed NVIDIA support as sm 5.0–9.0a (Maxwell→Hopper), but v0.6.2 pinned the bundled binaries to v1.4.1 which adds sm 12.0 (Blackwell)
  • Update the support range in docs/README.md:7 so RTX 50-series / Blackwell users know the project covers their hardware

Test plan

  • Visual check that the rendered README on the PR page reads cleanly
  • Confirm sm 12.0 is the only addition vs. the pre-edit line

🤖 Generated with Claude Code

Greptile Summary

This PR updates the one-line description in docs/README.md to advertise Blackwell GPU support (sm 12.0) alongside the existing Maxwell–Hopper range (sm 5.0–9.0a), aligning the README with the bundled k-Wave C++ binary v1.4.1.

  • The parenthetical (sm 5.0–9.0a, sm 12.0) is factually correct, but the prose "from Maxwell through Blackwell" overstates coverage: Blackwell spans sm 10.0 (B200/GB200), sm 10.3 (B300/GB300), sm 11.0 (Jetson T5000/T4000), sm 12.0 (consumer/workstation RTX 50xx), and sm 12.1 (GB10), so datacenter Blackwell users would be misled into thinking their hardware is supported.

Confidence Score: 3/5

The README change advertises broader Blackwell support than the binary actually delivers — datacenter Blackwell users (B200, GB200, GB300) would be misled.

The parenthetical (sm 5.0–9.0a, sm 12.0) is accurate, but the surrounding prose "from Maxwell through Blackwell" covers only a subset of the Blackwell family. Blackwell spans sm 10.0, sm 10.3, sm 11.0, sm 12.0, and sm 12.1; only sm 12.0 is added here. A B200 or GB200 user (sm 10.0) reading the README would reasonably believe their card is supported and waste time debugging a runtime failure.

docs/README.md — the one changed line needs the prose tightened to match what the parenthetical already states correctly.

Important Files Changed

Filename Overview
docs/README.md Single-line update expanding GPU support description to include sm 12.0 (Blackwell), but "from Maxwell through Blackwell" overstates coverage since Blackwell also includes sm 10.0 and sm 10.3 which are not listed.

Reviews (1): Last reviewed commit: "docs: document Blackwell (sm 12.0) GPU s..." | Re-trigger Greptile

Greptile also left 1 inline comment on this PR.

The README's GPU support claim was stale at sm 5.0–9.0a; v0.6.2
pinned the bundled C++ binaries to v1.4.1, which adds sm 12.0
(Blackwell) on Linux CUDA. Update the architecture range so users
with RTX 50-series / Blackwell hardware know the project supports
them.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Comment thread docs/README.md
[![codecov](https://codecov.io/gh/waltsims/k-wave-python/graph/badge.svg?token=6ofwtPiDNG)](https://codecov.io/gh/waltsims/k-wave-python)

A Python implementation of [k-Wave](http://www.k-wave.org/) — an acoustics toolbox for time-domain simulation of acoustic wave fields. Includes a pure NumPy/CuPy solver (`backend="python"`) and an interface to the pre-compiled k-Wave C++ binaries (`backend="cpp"`) with NVIDIA GPU support (sm 5.0–9.0a).
A Python implementation of [k-Wave](http://www.k-wave.org/) — an acoustics toolbox for time-domain simulation of acoustic wave fields. Includes a pure NumPy/CuPy solver (`backend="python"`) and an interface to the pre-compiled k-Wave C++ binaries (`backend="cpp"`) with NVIDIA GPU support from Maxwell through Blackwell (sm 5.0–9.0a, sm 12.0).
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 The phrase "from Maxwell through Blackwell" implies coverage of the entire Blackwell generation, but Blackwell spans multiple distinct compute capabilities: sm 10.0 (B200/GB200), sm 10.3 (B300/GB300), sm 11.0 (Jetson T5000/T4000), sm 12.0 (GeForce RTX 50xx, RTX PRO 6000), and sm 12.1 (GB10 DGX Spark). Only sm 12.0 is added here, so datacenter Blackwell users (B200, GB200, GB300) would read "through Blackwell" and attempt to run on unsupported hardware. The parenthetical list is precise; the prose around it should match.

Suggested change
A Python implementation of [k-Wave](http://www.k-wave.org/) — an acoustics toolbox for time-domain simulation of acoustic wave fields. Includes a pure NumPy/CuPy solver (`backend="python"`) and an interface to the pre-compiled k-Wave C++ binaries (`backend="cpp"`) with NVIDIA GPU support from Maxwell through Blackwell (sm 5.0–9.0a, sm 12.0).
A Python implementation of [k-Wave](http://www.k-wave.org/) — an acoustics toolbox for time-domain simulation of acoustic wave fields. Includes a pure NumPy/CuPy solver (`backend="python"`) and an interface to the pre-compiled k-Wave C++ binaries (`backend="cpp"`) with NVIDIA GPU support for sm 5.0–9.0a (Maxwell → Hopper) and sm 12.0 (consumer/workstation Blackwell).

@codecov
Copy link
Copy Markdown

codecov Bot commented May 21, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 75.81%. Comparing base (0ba7876) to head (d54adac).
⚠️ Report is 8 commits behind head on master.

Additional details and impacted files
@@            Coverage Diff             @@
##           master     #750      +/-   ##
==========================================
+ Coverage   75.55%   75.81%   +0.25%     
==========================================
  Files          57       57              
  Lines        8187     8303     +116     
  Branches     1598     1649      +51     
==========================================
+ Hits         6186     6295     +109     
- Misses       1380     1382       +2     
- Partials      621      626       +5     
Flag Coverage Δ
3.10 75.75% <ø> (+0.23%) ⬆️
3.11 75.75% <ø> (+0.23%) ⬆️
3.12 75.75% <ø> (+0.23%) ⬆️
3.13 75.75% <ø> (+0.23%) ⬆️
macos-latest 75.69% <ø> (+0.23%) ⬆️
ubuntu-latest 75.69% <ø> (+0.23%) ⬆️
windows-latest 75.49% <ø> (+0.18%) ⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

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.

1 participant