From 8e1063feea0d9d02e36c4ad1d353bf812daf0f98 Mon Sep 17 00:00:00 2001 From: jayshah1819 Date: Thu, 20 Nov 2025 18:37:14 -0500 Subject: [PATCH 1/7] Update jekyll.yml --- .github/workflows/jekyll.yml | 3 +++ 1 file changed, 3 insertions(+) diff --git a/.github/workflows/jekyll.yml b/.github/workflows/jekyll.yml index 6df84b9..151c9d3 100644 --- a/.github/workflows/jekyll.yml +++ b/.github/workflows/jekyll.yml @@ -44,6 +44,9 @@ jobs: permissions: pages: write id-token: write + environment: + name: github-pages + url: ${{ steps.deployment.outputs.page_url }} steps: - name: Deploy to GitHub Pages id: deployment From 47ccef944af473e59a26df6f06d8cc3f713e2231 Mon Sep 17 00:00:00 2001 From: jayshah1819 Date: Thu, 20 Nov 2025 18:54:24 -0500 Subject: [PATCH 2/7] Update _config.yml --- docs/_config.yml | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/_config.yml b/docs/_config.yml index 97e0890..3e0d8ae 100644 --- a/docs/_config.yml +++ b/docs/_config.yml @@ -12,10 +12,14 @@ plugins: - jekyll-feed - jekyll-remote-theme -# Only show About in header navigation + header_pages: - about.markdown + +include: + - examples/ + exclude: - misc/ - Gemfile From 1df1b0422fd7d6df4d93a31ac0c237476a6c2d93 Mon Sep 17 00:00:00 2001 From: jayshah1819 Date: Thu, 20 Nov 2025 18:57:32 -0500 Subject: [PATCH 3/7] added changes in workflow --- .github/workflows/jekyll.yml | 6 +++--- docs/_config.yml | 3 --- 2 files changed, 3 insertions(+), 6 deletions(-) diff --git a/.github/workflows/jekyll.yml b/.github/workflows/jekyll.yml index 151c9d3..41b152a 100644 --- a/.github/workflows/jekyll.yml +++ b/.github/workflows/jekyll.yml @@ -3,9 +3,6 @@ name: Deploy Jekyll site to Pages on: push: branches: ["main"] - paths: - - ".github/workflows/**" - - "docs/**" workflow_dispatch: permissions: @@ -24,6 +21,9 @@ jobs: - name: Checkout uses: actions/checkout@v4 + - name: Copy examples to docs + run: cp -r examples docs/examples + - name: Setup Pages uses: actions/configure-pages@v4 diff --git a/docs/_config.yml b/docs/_config.yml index 3e0d8ae..66a4014 100644 --- a/docs/_config.yml +++ b/docs/_config.yml @@ -17,9 +17,6 @@ header_pages: - about.markdown -include: - - examples/ - exclude: - misc/ - Gemfile From f9309295782f08028da5f1a34ea066697513c2e5 Mon Sep 17 00:00:00 2001 From: jayshah1819 Date: Thu, 20 Nov 2025 18:59:45 -0500 Subject: [PATCH 4/7] Update jekyll.yml --- .github/workflows/jekyll.yml | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/.github/workflows/jekyll.yml b/.github/workflows/jekyll.yml index 41b152a..49c2a83 100644 --- a/.github/workflows/jekyll.yml +++ b/.github/workflows/jekyll.yml @@ -21,8 +21,11 @@ jobs: - name: Checkout uses: actions/checkout@v4 - - name: Copy examples to docs - run: cp -r examples docs/examples + - name: Copy examples and source files to docs + run: | + cp -r examples docs/examples + cp -r src docs/src + cp *.mjs docs/ 2>/dev/null || true - name: Setup Pages uses: actions/configure-pages@v4 From 99a38b625747bb219c4a228eaa8f2c7f280da698 Mon Sep 17 00:00:00 2001 From: jayshah1819 Date: Fri, 21 Nov 2025 14:41:32 -0500 Subject: [PATCH 5/7] Update jekyll.yml --- .github/workflows/jekyll.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/jekyll.yml b/.github/workflows/jekyll.yml index 9aed94d..45b8186 100644 --- a/.github/workflows/jekyll.yml +++ b/.github/workflows/jekyll.yml @@ -24,7 +24,7 @@ jobs: - name: Copy examples and source files to docs run: | cp -r examples docs/examples - cp -r src docs/src + cp -r docs cp *.mjs docs/ 2>/dev/null || true - name: Setup Pages From 8b6391b04c67cf867721ae76f7473daa4349f4f1 Mon Sep 17 00:00:00 2001 From: jayshah1819 Date: Fri, 21 Nov 2025 14:42:37 -0500 Subject: [PATCH 6/7] Update jekyll.yml --- .github/workflows/jekyll.yml | 1 - 1 file changed, 1 deletion(-) diff --git a/.github/workflows/jekyll.yml b/.github/workflows/jekyll.yml index 45b8186..4414a3e 100644 --- a/.github/workflows/jekyll.yml +++ b/.github/workflows/jekyll.yml @@ -24,7 +24,6 @@ jobs: - name: Copy examples and source files to docs run: | cp -r examples docs/examples - cp -r docs cp *.mjs docs/ 2>/dev/null || true - name: Setup Pages From 5b27ede65f68e3444a97ff64f159e0c6cd5d858b Mon Sep 17 00:00:00 2001 From: jayshah1819 Date: Mon, 24 Nov 2025 20:19:48 -0500 Subject: [PATCH 7/7] docs: Fix all spacing issues in relative_url filters and rebuild site --- .github/workflows/jekyll.yml | 1 - .github/workflows/main.yml | 9 +- Gemfile.lock | 314 +++++++++++++++ _site/about/index.html | 229 +++++++---- _site/architecture/index.html | 211 ++++++++++ _site/{gridwise => }/binop/index.html | 227 +++++++---- _site/{gridwise => }/buffer/index.html | 229 +++++++---- _site/builtins-strategy/index.html | 181 +++++++++ .../index.html | 109 ++--- _site/docs/2025/08/12/architecture/index.html | 109 ++--- .../webgpu-object-caching-strategy/index.html | 109 ++--- .../2025/08/18/subgroup-strategy/index.html | 109 ++--- .../2025/08/22/builtins-strategy/index.html | 109 ++--- _site/docs/2025/09/16/binop/index.html | 109 ++--- _site/docs/2025/09/16/buffer/index.html | 109 ++--- .../2025/09/16/scan-and-reduce/index.html | 109 ++--- _site/docs/2025/09/16/sort/index.html | 109 ++--- _site/docs/Gemfile | 32 -- README.md => _site/docs/README.md | 0 _site/docs/index.html | 280 +++++++------ _site/example/index.html | 202 ---------- _site/examples-guide/index.html | 316 +++++++++++++++ _site/feed.xml | 16 +- _site/gridwise/architecture/index.html | 134 ------ _site/gridwise/builtins-strategy/index.html | 104 ----- _site/gridwise/index.html | 104 ----- _site/gridwise/primitive-design/index.html | 182 --------- _site/index.html | 381 ++++++++++++------ _site/primitive-design/index.html | 259 ++++++++++++ _site/primitive.mjs | 15 +- .../{gridwise => }/scan-and-reduce/index.html | 229 +++++++---- _site/scandldf.mjs | 11 +- _site/{gridwise => }/sort/index.html | 229 +++++++---- .../subgroup-strategy/index.html | 229 +++++++---- .../{gridwise => }/timing-strategy/index.html | 229 +++++++---- .../webgpu-object-caching-strategy/index.html | 229 +++++++---- .../index.html | 229 +++++++---- {_site => docs}/README.md | 0 docs/_includes/footer.html | 2 +- docs/_includes/header.html | 6 +- docs/_posts/index.markdown | 104 +++++ docs/docs.html | 139 +++++++ docs/example.html | 206 ---------- docs/examples.html | 172 ++++++++ docs/index.markdown | 6 - 45 files changed, 3913 insertions(+), 2514 deletions(-) create mode 100644 Gemfile.lock create mode 100644 _site/architecture/index.html rename _site/{gridwise => }/binop/index.html (64%) rename _site/{gridwise => }/buffer/index.html (67%) create mode 100644 _site/builtins-strategy/index.html delete mode 100644 _site/docs/Gemfile rename README.md => _site/docs/README.md (100%) delete mode 100644 _site/example/index.html create mode 100644 _site/examples-guide/index.html delete mode 100644 _site/gridwise/architecture/index.html delete mode 100644 _site/gridwise/builtins-strategy/index.html delete mode 100644 _site/gridwise/index.html delete mode 100644 _site/gridwise/primitive-design/index.html create mode 100644 _site/primitive-design/index.html rename _site/{gridwise => }/scan-and-reduce/index.html (72%) rename _site/{gridwise => }/sort/index.html (68%) rename _site/{gridwise => }/subgroup-strategy/index.html (64%) rename _site/{gridwise => }/timing-strategy/index.html (50%) rename _site/{gridwise => }/webgpu-object-caching-strategy/index.html (65%) rename _site/{gridwise => }/writing-a-webgpu-wgsl-workgroup-reduce-function/index.html (75%) rename {_site => docs}/README.md (100%) create mode 100644 docs/_posts/index.markdown create mode 100644 docs/docs.html delete mode 100644 docs/example.html create mode 100644 docs/examples.html delete mode 100644 docs/index.markdown diff --git a/.github/workflows/jekyll.yml b/.github/workflows/jekyll.yml index 4414a3e..72a1885 100644 --- a/.github/workflows/jekyll.yml +++ b/.github/workflows/jekyll.yml @@ -2,7 +2,6 @@ name: Deploy Jekyll site to Pages on: push: - branches: ["main"] workflow_dispatch: permissions: diff --git a/.github/workflows/main.yml b/.github/workflows/main.yml index f5233c1..a4f4465 100644 --- a/.github/workflows/main.yml +++ b/.github/workflows/main.yml @@ -2,9 +2,7 @@ name: Test Jekyll Build on: push: - branches: [ test-css-fix-github-actions ] pull_request: - branches: [ main ] jobs: build: @@ -16,13 +14,10 @@ jobs: - name: Setup Ruby uses: ruby/setup-ruby@v1 with: - ruby-version: '3.1' + ruby-version: '3.2' bundler-cache: true - working-directory: ./docs - name: Build site - run: | - cd docs - bundle exec jekyll build + run: bundle exec jekyll build env: JEKYLL_ENV: production diff --git a/Gemfile.lock b/Gemfile.lock new file mode 100644 index 0000000..c26f9cd --- /dev/null +++ b/Gemfile.lock @@ -0,0 +1,314 @@ +GEM + remote: https://rubygems.org/ + specs: + activesupport (8.1.1) + base64 + bigdecimal + concurrent-ruby (~> 1.0, >= 1.3.1) + connection_pool (>= 2.2.5) + drb + i18n (>= 1.6, < 2) + json + logger (>= 1.4.2) + minitest (>= 5.1) + securerandom (>= 0.3) + tzinfo (~> 2.0, >= 2.0.5) + uri (>= 0.13.1) + addressable (2.8.7) + public_suffix (>= 2.0.2, < 7.0) + base64 (0.3.0) + bigdecimal (3.3.1) + coffee-script (2.4.1) + coffee-script-source + execjs + coffee-script-source (1.12.2) + colorator (1.1.0) + commonmarker (0.23.12) + concurrent-ruby (1.3.5) + connection_pool (2.5.4) + csv (3.3.5) + dnsruby (1.73.1) + base64 (>= 0.2) + logger (~> 1.6) + simpleidn (~> 0.2.1) + drb (2.2.3) + em-websocket (0.5.3) + eventmachine (>= 0.12.9) + http_parser.rb (~> 0) + ethon (0.15.0) + ffi (>= 1.15.0) + eventmachine (1.2.7) + execjs (2.10.0) + faraday (2.14.0) + faraday-net_http (>= 2.0, < 3.5) + json + logger + faraday-net_http (3.4.2) + net-http (~> 0.5) + ffi (1.17.2-aarch64-linux-gnu) + ffi (1.17.2-aarch64-linux-musl) + ffi (1.17.2-arm-linux-gnu) + ffi (1.17.2-arm-linux-musl) + ffi (1.17.2-arm64-darwin) + ffi (1.17.2-x86_64-darwin) + ffi (1.17.2-x86_64-linux-gnu) + ffi (1.17.2-x86_64-linux-musl) + forwardable-extended (2.6.0) + gemoji (4.1.0) + github-pages (232) + github-pages-health-check (= 1.18.2) + jekyll (= 3.10.0) + jekyll-avatar (= 0.8.0) + jekyll-coffeescript (= 1.2.2) + jekyll-commonmark-ghpages (= 0.5.1) + jekyll-default-layout (= 0.1.5) + jekyll-feed (= 0.17.0) + jekyll-gist (= 1.5.0) + jekyll-github-metadata (= 2.16.1) + jekyll-include-cache (= 0.2.1) + jekyll-mentions (= 1.6.0) + jekyll-optional-front-matter (= 0.3.2) + jekyll-paginate (= 1.1.0) + jekyll-readme-index (= 0.3.0) + jekyll-redirect-from (= 0.16.0) + jekyll-relative-links (= 0.6.1) + jekyll-remote-theme (= 0.4.3) + jekyll-sass-converter (= 1.5.2) + jekyll-seo-tag (= 2.8.0) + jekyll-sitemap (= 1.4.0) + jekyll-swiss (= 1.0.0) + jekyll-theme-architect (= 0.2.0) + jekyll-theme-cayman (= 0.2.0) + jekyll-theme-dinky (= 0.2.0) + jekyll-theme-hacker (= 0.2.0) + jekyll-theme-leap-day (= 0.2.0) + jekyll-theme-merlot (= 0.2.0) + jekyll-theme-midnight (= 0.2.0) + jekyll-theme-minimal (= 0.2.0) + jekyll-theme-modernist (= 0.2.0) + jekyll-theme-primer (= 0.6.0) + jekyll-theme-slate (= 0.2.0) + jekyll-theme-tactile (= 0.2.0) + jekyll-theme-time-machine (= 0.2.0) + jekyll-titles-from-headings (= 0.5.3) + jemoji (= 0.13.0) + kramdown (= 2.4.0) + kramdown-parser-gfm (= 1.1.0) + liquid (= 4.0.4) + mercenary (~> 0.3) + minima (= 2.5.1) + nokogiri (>= 1.16.2, < 2.0) + rouge (= 3.30.0) + terminal-table (~> 1.4) + webrick (~> 1.8) + github-pages-health-check (1.18.2) + addressable (~> 2.3) + dnsruby (~> 1.60) + octokit (>= 4, < 8) + public_suffix (>= 3.0, < 6.0) + typhoeus (~> 1.3) + html-pipeline (2.14.3) + activesupport (>= 2) + nokogiri (>= 1.4) + http_parser.rb (0.8.0) + i18n (1.14.7) + concurrent-ruby (~> 1.0) + jekyll (3.10.0) + addressable (~> 2.4) + colorator (~> 1.0) + csv (~> 3.0) + em-websocket (~> 0.5) + i18n (>= 0.7, < 2) + jekyll-sass-converter (~> 1.0) + jekyll-watch (~> 2.0) + kramdown (>= 1.17, < 3) + liquid (~> 4.0) + mercenary (~> 0.3.3) + pathutil (~> 0.9) + rouge (>= 1.7, < 4) + safe_yaml (~> 1.0) + webrick (>= 1.0) + jekyll-avatar (0.8.0) + jekyll (>= 3.0, < 5.0) + jekyll-coffeescript (1.2.2) + coffee-script (~> 2.2) + coffee-script-source (~> 1.12) + jekyll-commonmark (1.4.0) + commonmarker (~> 0.22) + jekyll-commonmark-ghpages (0.5.1) + commonmarker (>= 0.23.7, < 1.1.0) + jekyll (>= 3.9, < 4.0) + jekyll-commonmark (~> 1.4.0) + rouge (>= 2.0, < 5.0) + jekyll-default-layout (0.1.5) + jekyll (>= 3.0, < 5.0) + jekyll-feed (0.17.0) + jekyll (>= 3.7, < 5.0) + jekyll-gist (1.5.0) + octokit (~> 4.2) + jekyll-github-metadata (2.16.1) + jekyll (>= 3.4, < 5.0) + octokit (>= 4, < 7, != 4.4.0) + jekyll-include-cache (0.2.1) + jekyll (>= 3.7, < 5.0) + jekyll-mentions (1.6.0) + html-pipeline (~> 2.3) + jekyll (>= 3.7, < 5.0) + jekyll-optional-front-matter (0.3.2) + jekyll (>= 3.0, < 5.0) + jekyll-paginate (1.1.0) + jekyll-readme-index (0.3.0) + jekyll (>= 3.0, < 5.0) + jekyll-redirect-from (0.16.0) + jekyll (>= 3.3, < 5.0) + jekyll-relative-links (0.6.1) + jekyll (>= 3.3, < 5.0) + jekyll-remote-theme (0.4.3) + addressable (~> 2.0) + jekyll (>= 3.5, < 5.0) + jekyll-sass-converter (>= 1.0, <= 3.0.0, != 2.0.0) + rubyzip (>= 1.3.0, < 3.0) + jekyll-sass-converter (1.5.2) + sass (~> 3.4) + jekyll-seo-tag (2.8.0) + jekyll (>= 3.8, < 5.0) + jekyll-sitemap (1.4.0) + jekyll (>= 3.7, < 5.0) + jekyll-swiss (1.0.0) + jekyll-theme-architect (0.2.0) + jekyll (> 3.5, < 5.0) + jekyll-seo-tag (~> 2.0) + jekyll-theme-cayman (0.2.0) + jekyll (> 3.5, < 5.0) + jekyll-seo-tag (~> 2.0) + jekyll-theme-dinky (0.2.0) + jekyll (> 3.5, < 5.0) + jekyll-seo-tag (~> 2.0) + jekyll-theme-hacker (0.2.0) + jekyll (> 3.5, < 5.0) + jekyll-seo-tag (~> 2.0) + jekyll-theme-leap-day (0.2.0) + jekyll (> 3.5, < 5.0) + jekyll-seo-tag (~> 2.0) + jekyll-theme-merlot (0.2.0) + jekyll (> 3.5, < 5.0) + jekyll-seo-tag (~> 2.0) + jekyll-theme-midnight (0.2.0) + jekyll (> 3.5, < 5.0) + jekyll-seo-tag (~> 2.0) + jekyll-theme-minimal (0.2.0) + jekyll (> 3.5, < 5.0) + jekyll-seo-tag (~> 2.0) + jekyll-theme-modernist (0.2.0) + jekyll (> 3.5, < 5.0) + jekyll-seo-tag (~> 2.0) + jekyll-theme-primer (0.6.0) + jekyll (> 3.5, < 5.0) + jekyll-github-metadata (~> 2.9) + jekyll-seo-tag (~> 2.0) + jekyll-theme-slate (0.2.0) + jekyll (> 3.5, < 5.0) + jekyll-seo-tag (~> 2.0) + jekyll-theme-tactile (0.2.0) + jekyll (> 3.5, < 5.0) + jekyll-seo-tag (~> 2.0) + jekyll-theme-time-machine (0.2.0) + jekyll (> 3.5, < 5.0) + jekyll-seo-tag (~> 2.0) + jekyll-titles-from-headings (0.5.3) + jekyll (>= 3.3, < 5.0) + jekyll-watch (2.2.1) + listen (~> 3.0) + jemoji (0.13.0) + gemoji (>= 3, < 5) + html-pipeline (~> 2.2) + jekyll (>= 3.0, < 5.0) + json (2.16.0) + kramdown (2.4.0) + rexml + kramdown-parser-gfm (1.1.0) + kramdown (~> 2.0) + liquid (4.0.4) + listen (3.9.0) + rb-fsevent (~> 0.10, >= 0.10.3) + rb-inotify (~> 0.9, >= 0.9.10) + logger (1.7.0) + mercenary (0.3.6) + minima (2.5.1) + jekyll (>= 3.5, < 5.0) + jekyll-feed (~> 0.9) + jekyll-seo-tag (~> 2.1) + minitest (5.26.2) + net-http (0.8.0) + uri (>= 0.11.1) + nokogiri (1.18.10-aarch64-linux-gnu) + racc (~> 1.4) + nokogiri (1.18.10-aarch64-linux-musl) + racc (~> 1.4) + nokogiri (1.18.10-arm-linux-gnu) + racc (~> 1.4) + nokogiri (1.18.10-arm-linux-musl) + racc (~> 1.4) + nokogiri (1.18.10-arm64-darwin) + racc (~> 1.4) + nokogiri (1.18.10-x86_64-darwin) + racc (~> 1.4) + nokogiri (1.18.10-x86_64-linux-gnu) + racc (~> 1.4) + nokogiri (1.18.10-x86_64-linux-musl) + racc (~> 1.4) + octokit (4.25.1) + faraday (>= 1, < 3) + sawyer (~> 0.9) + pathutil (0.16.2) + forwardable-extended (~> 2.6) + public_suffix (5.1.1) + racc (1.8.1) + rb-fsevent (0.11.2) + rb-inotify (0.11.1) + ffi (~> 1.0) + rexml (3.4.4) + rouge (3.30.0) + rubyzip (2.4.1) + safe_yaml (1.0.5) + sass (3.7.4) + sass-listen (~> 4.0.0) + sass-listen (4.0.0) + rb-fsevent (~> 0.9, >= 0.9.4) + rb-inotify (~> 0.9, >= 0.9.7) + sawyer (0.9.3) + addressable (>= 2.3.5) + faraday (>= 0.17.3, < 3) + securerandom (0.4.1) + simpleidn (0.2.3) + terminal-table (1.8.0) + unicode-display_width (~> 1.1, >= 1.1.1) + typhoeus (1.5.0) + ethon (>= 0.9.0, < 0.16.0) + tzinfo (2.0.6) + concurrent-ruby (~> 1.0) + unicode-display_width (1.8.0) + uri (1.1.1) + webrick (1.9.1) + +PLATFORMS + aarch64-linux-gnu + aarch64-linux-musl + arm-linux-gnu + arm-linux-musl + arm64-darwin + x86_64-darwin + x86_64-linux-gnu + x86_64-linux-musl + +DEPENDENCIES + github-pages (~> 232) + http_parser.rb (~> 0.6.0) + jekyll-feed + jekyll-remote-theme + tzinfo (>= 1, < 3) + tzinfo-data + wdm (~> 0.1) + +BUNDLED WITH + 2.7.2 diff --git a/_site/about/index.html b/_site/about/index.html index 1eef0e3..6e7b113 100644 --- a/_site/about/index.html +++ b/_site/about/index.html @@ -1,106 +1,183 @@ - - - + + + About | Gridwise - - + + +{"@context":"https://schema.org","@type":"WebSite","description":"WebGPU compute primitives in JavaScript","headline":"About","name":"Gridwise","url":"https://gridwise-webgpu.github.io/gridwise/about/"} - - -
+ + +
- - -
-
-
-
+
+ + + + +
+
+

About

+
-
-

About

-
- -
-

Gridwise is a JavaScript library for WebGPU compute primitives including scan, reduce, and sort.

+
+

Gridwise is a JavaScript library for WebGPU compute primitives including scan, reduce, and sort.

View the source code on GitHub.

-
- -
- -
-
+ + + + -
- + -
+
+
+ -
-
-
-
-

WebGPU compute primitives in JavaScript

-
-
+
+

Gridwise

- +
+
+ +
-
+
+

WebGPU compute primitives in JavaScript

+
+
-
+ - +
diff --git a/_site/architecture/index.html b/_site/architecture/index.html new file mode 100644 index 0000000..d7bb81f --- /dev/null +++ b/_site/architecture/index.html @@ -0,0 +1,211 @@ + + + + + +Gridwise Architecture | Gridwise + + + + + + + + + + + + + + + + +
+
+
+ + + + +
+
+
+

Gridwise Architecture

+
+ +
+

The primary goal of Gridwise is to deliver best-in-class performance on WebGPU compute primitives while minimizing the amount of code that must be written by the library user. Ideally, a Gridwise user will declare and then execute a primitive and Gridwise will handle all low-level details of setting up and calling the necessary WebGPU primitives.

+ +

Gridwise Abstraction

+ +

Primitive

+ +

The primary abstraction in Gridwise is a Primitive. Primitives are instances of a primitive-specific subclass of a JavaScript Primitive class. They have an execute member function, and the typical usage is to instantiate a primitive using new() and then call execute() on that primitive. Both instantiation and execution have numerous options. As an example, let’s look at a scan primitive, which is an instance of the DLDFScan class (“decoupled-lookback, decoupled-fallback scan”):

+ +
const datatype = "u32";
+const dldfscanPrimitive = new DLDFScan({
+  device,
+  binop: new BinOpAdd({ datatype }),
+  type: "exclusive", // "exclusive" is the default
+  datatype,
+});
+
+await dldfscanPrimitive.execute({
+  inputBuffer,
+  outputBuffer,
+});
+
+ +

This particular primitive is parameterized by its datatype (in this case, “u32”), by the binary operation (“binop”) performed by the scan (in this case, addition on u32 data), and by the scan operation (exclusive or inclusive).

+ +

When the scan is actually executed, its arguments are buffers that store its input and output. This particular primitive has named arguments of an input buffer named inputBuffer and an output buffer named outputBuffer. These buffers can be WebGPU buffers of type GPUBuffer but can also be Buffers, described next.

+ +

The primitive performs all necessary WebGPU operations, including (optionally) setting up an encoder, building up and setting WebGPU layouts and pipelines, running the pipeline, and optionally recording GPU-side or CPU-side timing. It also caches WebGPU layouts and pipelines to avoid the expense of recreating them if they have already been created.

+ +

Buffer

+ +

One of the challenges of writing a primitive library is handling data, which may be stored on the CPU (in a JavaScript typed array) or on the GPU (as a WebGPU GPUBuffer). Gridwise’s Buffer class attempts to abstract away the details of separately managing CPU and GPU buffer data structures with one unified data structure that stores, and moves data between, both. This data structure has grown organically to handle many use cases and deserves more focus by future developers as a principled data structure in WebGPU programming.

+ +
+
+
+
+ + + +
+
+ + +
+

Gridwise

+ +
+
+ +
+ +
+

WebGPU compute primitives in JavaScript

+
+
+ +
+ +
+ + diff --git a/_site/gridwise/binop/index.html b/_site/binop/index.html similarity index 64% rename from _site/gridwise/binop/index.html rename to _site/binop/index.html index a31180c..225dda6 100644 --- a/_site/gridwise/binop/index.html +++ b/_site/binop/index.html @@ -1,64 +1,118 @@ - - - + + + Gridwise’s Binary Operator Class | Gridwise - - + + +{"@context":"https://schema.org","@type":"WebPage","description":"Understanding the BinOp class that represents monoids with binary operations, datatypes, and identity elements for use in primitives.","headline":"Gridwise’s Binary Operator Class","url":"https://gridwise-webgpu.github.io/gridwise/binop/"} - - -
+ + + +
- - -
-
-
-
+ +
+
+

Gridwise's Binary Operator Class

+
-
-

Gridwise's Binary Operator Class

-
- -
-

Gridwise’s binary operator class is called binop. This class represents a monoid, which has as its constituent parts a binary operation, a datatype for the data on which the operator is applied, and an identity element. (If we call the identity element I and the operator op, then x = I op x. For instance, addition’s identity is zero, and multiplication’s is one.) In Gridwise, we package these elements into an instance of a JS class, BinOp. This class then defines a number of objects that are used in WGSL code generation and CPU correctness checking.

+
+

Gridwise’s binary operator class is called binop. This class represents a monoid, which has as its constituent parts a binary operation, a datatype for the data on which the operator is applied, and an identity element. (If we call the identity element I and the operator op, then x = I op x. For instance, addition’s identity is zero, and multiplication’s is one.) In Gridwise, we package these elements into an instance of a JS class, BinOp. This class then defines a number of objects that are used in WGSL code generation and CPU correctness checking.

BinOp is implemented in the source file binop.md. We specialize BinOp to particular operations (e.g., Add) and then further specialize it with a datatype. Many Gridwise primitives require a BinOp argument and the common use will be something like:

@@ -135,45 +189,68 @@

What does a BinOp p }

-
- - - - -
+ + + + -
- + -
+
+
+ -
-
-
-
-

WebGPU compute primitives in JavaScript

-
-
+
+

Gridwise

- +
+
+ +
-
+
+

WebGPU compute primitives in JavaScript

+
+
-
+ - +
diff --git a/_site/gridwise/buffer/index.html b/_site/buffer/index.html similarity index 67% rename from _site/gridwise/buffer/index.html rename to _site/buffer/index.html index 9897dda..c16845c 100644 --- a/_site/gridwise/buffer/index.html +++ b/_site/buffer/index.html @@ -1,64 +1,118 @@ - - - + + + Gridwise’s Buffer Class | Gridwise - - + + +{"@context":"https://schema.org","@type":"WebPage","description":"The Buffer class encapsulates data that spans both CPU (typed arrays) and GPU (GPUBuffer), providing a unified interface for data management.","headline":"Gridwise’s Buffer Class","url":"https://gridwise-webgpu.github.io/gridwise/buffer/"} - - -
+ + +
- - -
-
-
-
+
+ + + + +
+
+

Gridwise's Buffer Class

+
-
-

Gridwise's Buffer Class

-
- -
-

During Gridwise’s development, we found a need to encapsulate the concept of a single wad of data that spans CPU and GPU. We call this class Buffer. It contains both a CPU-side JS typed array and a GPU-side GPUBuffer. The abstraction is that these two objects are (roughly) consistent with each other (they are not meant to store two logically different objects).

+
+

During Gridwise’s development, we found a need to encapsulate the concept of a single wad of data that spans CPU and GPU. We call this class Buffer. It contains both a CPU-side JS typed array and a GPU-side GPUBuffer. The abstraction is that these two objects are (roughly) consistent with each other (they are not meant to store two logically different objects).

We believe this is an object whose design could be revisited and improved, because it is generally useful in WebGPU primitive development and more generally across WebGPU development. We welcome a redesign. For that purpose, we list our use cases:

@@ -200,45 +254,68 @@

device
  • get: Returns the associated GPUDevice.
    • -

    - -
    - -
    -
    + + + + -
    - + -
    +
    +
    + -
    -
    -
    -
    -

    WebGPU compute primitives in JavaScript

    -
    -
    +
    +

    Gridwise

    - +
    +
    + +
    -
    +
    +

    WebGPU compute primitives in JavaScript

    +
    +
    -
    + - +
    diff --git a/_site/builtins-strategy/index.html b/_site/builtins-strategy/index.html new file mode 100644 index 0000000..3ec406d --- /dev/null +++ b/_site/builtins-strategy/index.html @@ -0,0 +1,181 @@ + + + + + +Gridwise WebGPU @builtins Strategy | Gridwise + + + + + + + + + + + + + + + + +
    +
    +
    + + + + +
    +
    +
    +

    Gridwise WebGPU @builtins Strategy

    +
    + +
    + + +
    +
    +
    +
    + + + +
    +
    + + +
    +

    Gridwise

    + +
    +
    + +
    + +
    +

    WebGPU compute primitives in JavaScript

    +
    +
    + +
    + +
    + + diff --git a/_site/docs/2025/04/08/writing-a-webgpu-wgsl-workgroup-reduce-function/index.html b/_site/docs/2025/04/08/writing-a-webgpu-wgsl-workgroup-reduce-function/index.html index f3fbd13..eebb5e9 100644 --- a/_site/docs/2025/04/08/writing-a-webgpu-wgsl-workgroup-reduce-function/index.html +++ b/_site/docs/2025/04/08/writing-a-webgpu-wgsl-workgroup-reduce-function/index.html @@ -1,56 +1,49 @@ - - - + + + Abstraction Challenges in Writing a WebGPU/WGSL Workgroup Reduce Function | Gridwise - - + + +{"@context":"https://schema.org","@type":"BlogPosting","dateModified":"2025-04-08T00:00:00-04:00","datePublished":"2025-04-08T00:00:00-04:00","description":"Explore the challenges of writing generic WGSL library functions, including builtin declarations and workgroup memory limitations.","headline":"Abstraction Challenges in Writing a WebGPU/WGSL Workgroup Reduce Function","mainEntityOfPage":{"@type":"WebPage","@id":"https://gridwise-webgpu.github.io/gridwise/docs/2025/04/08/writing-a-webgpu-wgsl-workgroup-reduce-function/"},"url":"https://gridwise-webgpu.github.io/gridwise/docs/2025/04/08/writing-a-webgpu-wgsl-workgroup-reduce-function/"} - - -
    - -
    - - -
    + + -
    + +
    @@ -379,40 +372,26 @@

    Conclusion

    -
    - -
    - +
    + -
    +
    +

    Gridwise

    -
    -
    -
    -
    -

    WebGPU compute primitives in JavaScript

    -
    -
    +
    +
    + +
    - +
    +

    WebGPU compute primitives in JavaScript

    +
    +
    -
    +
    - diff --git a/_site/docs/2025/08/12/architecture/index.html b/_site/docs/2025/08/12/architecture/index.html index 052526d..2ed0a92 100644 --- a/_site/docs/2025/08/12/architecture/index.html +++ b/_site/docs/2025/08/12/architecture/index.html @@ -1,56 +1,49 @@ - - - + + + Gridwise Architecture | Gridwise - - + + +{"@context":"https://schema.org","@type":"BlogPosting","dateModified":"2025-08-12T00:00:00-04:00","datePublished":"2025-08-12T00:00:00-04:00","description":"Overview of Gridwise’s core architecture designed to deliver best-in-class WebGPU compute performance with minimal code.","headline":"Gridwise Architecture","mainEntityOfPage":{"@type":"WebPage","@id":"https://gridwise-webgpu.github.io/gridwise/docs/2025/08/12/architecture/"},"url":"https://gridwise-webgpu.github.io/gridwise/docs/2025/08/12/architecture/"} - - -
    - -
    - - -
    + + -
    + +
    @@ -102,40 +95,26 @@

    Buffer

    -
    +