From 0868e5741b9ea4ef266fdcc6bcf5e2204d34a420 Mon Sep 17 00:00:00 2001 From: jayshah1819 Date: Wed, 4 Mar 2026 14:56:06 -0500 Subject: [PATCH 1/4] Each example should have a back button to return to the examples list ("Back to Examples") #33 --- examples/gridwise.css | 6 ++++++ examples/reduce_example.html | 1 + examples/reduce_perf.html | 1 + examples/regression.html | 1 + examples/scan_example.html | 1 + examples/scan_pane_example.html | 1 + examples/scan_sort_perf.html | 1 + examples/sort_example.html | 1 + 8 files changed, 13 insertions(+) diff --git a/examples/gridwise.css b/examples/gridwise.css index e02ced6..1d8f93e 100644 --- a/examples/gridwise.css +++ b/examples/gridwise.css @@ -116,3 +116,9 @@ ul.test-list li.fail { #large-section { display: none; } + +.back-link { + display: inline-block; + margin-bottom: 1em; + font-size: 0.9em; +} diff --git a/examples/reduce_example.html b/examples/reduce_example.html index 56803fd..08c5827 100644 --- a/examples/reduce_example.html +++ b/examples/reduce_example.html @@ -10,6 +10,7 @@ /> + ← Back to Examples

Gridwise Reduce Primitive Example

This example calls Gridwise's reduce primitive. You can look diff --git a/examples/reduce_perf.html b/examples/reduce_perf.html index af800f5..2e77432 100644 --- a/examples/reduce_perf.html +++ b/examples/reduce_perf.html @@ -7,6 +7,7 @@ + ← Back to Examples

Reduce Performance

This example is a self-contained use of the reduce diff --git a/examples/regression.html b/examples/regression.html index 652d2aa..0d9b762 100644 --- a/examples/regression.html +++ b/examples/regression.html @@ -6,6 +6,7 @@ + ← Back to Examples

Gridwise Regression Tests

Running…
diff --git a/examples/scan_example.html b/examples/scan_example.html index d4afc74..daa51dc 100644 --- a/examples/scan_example.html +++ b/examples/scan_example.html @@ -10,6 +10,7 @@ /> + ← Back to Examples

Gridwise Scan Primitive Example

This example calls Gridwise's scan primitive. You can look at diff --git a/examples/scan_pane_example.html b/examples/scan_pane_example.html index 0dddf56..0815da9 100644 --- a/examples/scan_pane_example.html +++ b/examples/scan_pane_example.html @@ -6,6 +6,7 @@ + ← Back to Examples

Scan / Reduce Example, with Configuration Pane

Set your parameters in the pane and click "Start" to run and validate a WebGPU scan/reduce.

diff --git a/examples/scan_sort_perf.html b/examples/scan_sort_perf.html index 4c401a8..2e6fa5d 100644 --- a/examples/scan_sort_perf.html +++ b/examples/scan_sort_perf.html @@ -7,6 +7,7 @@ + ← Back to Examples

Scan / Sort Performance

This example is a self-contained use of the scan and diff --git a/examples/sort_example.html b/examples/sort_example.html index 9bbd7f4..45f996d 100644 --- a/examples/sort_example.html +++ b/examples/sort_example.html @@ -10,6 +10,7 @@ /> + ← Back to Examples

Gridwise Sort Primitive Example

This example calls Gridwise's sort primitive. You can look at From 382509779db2253f05faef8f33dea8261f47e685 Mon Sep 17 00:00:00 2001 From: jayshah1819 Date: Wed, 4 Mar 2026 15:01:36 -0500 Subject: [PATCH 2/4] Style .back-link to match .doc-btn button design --- examples/gridwise.css | 13 ++++++++++++- 1 file changed, 12 insertions(+), 1 deletion(-) diff --git a/examples/gridwise.css b/examples/gridwise.css index 1d8f93e..d059d29 100644 --- a/examples/gridwise.css +++ b/examples/gridwise.css @@ -119,6 +119,17 @@ ul.test-list li.fail { .back-link { display: inline-block; + padding: 5px 12px; + background: #39bda7; + color: white; + text-decoration: none; + border-radius: 4px; margin-bottom: 1em; - font-size: 0.9em; + font-size: 13px; + transition: background 0.2s; +} +.back-link:hover { + background: #2a9a87; + color: white; + text-decoration: none; } From 389b9e0ef3bca38b0c049064868bcf3104a72aa6 Mon Sep 17 00:00:00 2001 From: jayshah1819 Date: Wed, 4 Mar 2026 15:02:23 -0500 Subject: [PATCH 3/4] Each example should have a back button to return to the examples list ("Back to Examples") #33 --- examples/gridwise.css | 17 +++++++++++++++++ examples/reduce_example.html | 1 + examples/reduce_perf.html | 1 + examples/regression.html | 1 + examples/scan_example.html | 1 + examples/scan_pane_example.html | 1 + examples/scan_sort_perf.html | 1 + examples/sort_example.html | 1 + 8 files changed, 24 insertions(+) diff --git a/examples/gridwise.css b/examples/gridwise.css index e02ced6..d059d29 100644 --- a/examples/gridwise.css +++ b/examples/gridwise.css @@ -116,3 +116,20 @@ ul.test-list li.fail { #large-section { display: none; } + +.back-link { + display: inline-block; + padding: 5px 12px; + background: #39bda7; + color: white; + text-decoration: none; + border-radius: 4px; + margin-bottom: 1em; + font-size: 13px; + transition: background 0.2s; +} +.back-link:hover { + background: #2a9a87; + color: white; + text-decoration: none; +} diff --git a/examples/reduce_example.html b/examples/reduce_example.html index 56803fd..08c5827 100644 --- a/examples/reduce_example.html +++ b/examples/reduce_example.html @@ -10,6 +10,7 @@ /> + ← Back to Examples

Gridwise Reduce Primitive Example

This example calls Gridwise's reduce primitive. You can look diff --git a/examples/reduce_perf.html b/examples/reduce_perf.html index af800f5..2e77432 100644 --- a/examples/reduce_perf.html +++ b/examples/reduce_perf.html @@ -7,6 +7,7 @@ + ← Back to Examples

Reduce Performance

This example is a self-contained use of the reduce diff --git a/examples/regression.html b/examples/regression.html index 652d2aa..0d9b762 100644 --- a/examples/regression.html +++ b/examples/regression.html @@ -6,6 +6,7 @@ + ← Back to Examples

Gridwise Regression Tests

Running…
diff --git a/examples/scan_example.html b/examples/scan_example.html index d4afc74..daa51dc 100644 --- a/examples/scan_example.html +++ b/examples/scan_example.html @@ -10,6 +10,7 @@ /> + ← Back to Examples

Gridwise Scan Primitive Example

This example calls Gridwise's scan primitive. You can look at diff --git a/examples/scan_pane_example.html b/examples/scan_pane_example.html index 0dddf56..0815da9 100644 --- a/examples/scan_pane_example.html +++ b/examples/scan_pane_example.html @@ -6,6 +6,7 @@ + ← Back to Examples

Scan / Reduce Example, with Configuration Pane

Set your parameters in the pane and click "Start" to run and validate a WebGPU scan/reduce.

diff --git a/examples/scan_sort_perf.html b/examples/scan_sort_perf.html index 4c401a8..2e6fa5d 100644 --- a/examples/scan_sort_perf.html +++ b/examples/scan_sort_perf.html @@ -7,6 +7,7 @@ + ← Back to Examples

Scan / Sort Performance

This example is a self-contained use of the scan and diff --git a/examples/sort_example.html b/examples/sort_example.html index 9bbd7f4..45f996d 100644 --- a/examples/sort_example.html +++ b/examples/sort_example.html @@ -10,6 +10,7 @@ /> + ← Back to Examples

Gridwise Sort Primitive Example

This example calls Gridwise's sort primitive. You can look at From f841fa45068b73f01fffcbe585608eec88d8f083 Mon Sep 17 00:00:00 2001 From: jayshah1819 Date: Wed, 4 Mar 2026 15:22:19 -0500 Subject: [PATCH 4/4] Split "examples" into "examples" and "performance" pages #34 Open --- docs/_includes/header.html | 13 ++++++++++--- docs/_includes/sidebar.html | 10 +++++++--- docs/examples.md | 25 ------------------------- docs/performance.md | 31 +++++++++++++++++++++++++++++++ examples/reduce_perf.html | 2 +- examples/scan_sort_perf.html | 2 +- 6 files changed, 50 insertions(+), 33 deletions(-) create mode 100644 docs/performance.md diff --git a/docs/_includes/header.html b/docs/_includes/header.html index 748396c..cafb0e0 100644 --- a/docs/_includes/header.html +++ b/docs/_includes/header.html @@ -35,14 +35,21 @@ Reduce Configurable Scan / Reduce (Pane) - Performance - Scan / Sort Performance - Reduce Performance Regression Regression Tests

+ +
+ Performance ▾ +
+ Benchmarks + Scan / Sort + Reduce +
+
+
Demos ▾ diff --git a/docs/_includes/sidebar.html b/docs/_includes/sidebar.html index e2eaf96..70506dc 100644 --- a/docs/_includes/sidebar.html +++ b/docs/_includes/sidebar.html @@ -14,12 +14,16 @@

Examples

  • Reduce
  • Configurable
  • Scan / Reduce (Pane)
    • -
  • Performance
    • -
  • Scan / Sort Performance
    • -
  • Reduce Performance
  • Regression
  • Regression Tests
    • + {%- elsif page.sidebar == "performance" -%} +

    Performance

    + {%- else -%}

    Documentation

    {%- assign gridwise_pages = site.pages | where: "category", "gridwise" | sort: "order" -%} diff --git a/docs/examples.md b/docs/examples.md index e45244f..0b098f5 100644 --- a/docs/examples.md +++ b/docs/examples.md @@ -54,31 +54,6 @@ validate the output. Open Example Source -## Performance Testing - -These examples benchmark Gridwise primitives over a range of input sizes (logarithmically spaced) -and plot throughput in GB/s versus input length. Both CPU and GPU timing are reported. See the -[timing strategy documentation]({{ "/timing-strategy/" | relative_url }}) for how -primitives are timed and how to interpret results. - -### Scan and Sort Performance - -Benchmarks scan, reduce, and sort over a configurable range of input sizes. Choose the primitive, -datatype, and sort direction; results are plotted after each run. Note that sort overwrites its -input, so repeated trials measure a partially-sorted array. - -Open Example -Source - -### Reduce Performance - -Benchmarks the reduce primitive over a configurable range of input sizes. Explains the -warmup-then-trials timing strategy with inline code excerpts showing how to call -`getTimingResult` after execution. - -Open Example -Source - ## Regression Testing ### Gridwise Regression Tests diff --git a/docs/performance.md b/docs/performance.md new file mode 100644 index 0000000..8980b63 --- /dev/null +++ b/docs/performance.md @@ -0,0 +1,31 @@ +--- +layout: page +title: Performance +permalink: /performance/ +sidebar: performance +--- + +Benchmarks for Gridwise primitives over a range of input sizes (logarithmically spaced), +plotting throughput in GB/s versus input length. Both CPU and GPU timing are reported. See the +[timing strategy documentation]({{ "/timing-strategy/" | relative_url }}) for how +primitives are timed and how to interpret results. + +## Scan and Sort Performance + +Benchmarks scan, reduce, and sort over a configurable range of input sizes. Choose the primitive, +datatype, and sort direction; results are plotted after each run. Note that sort overwrites its +input, so repeated trials measure a partially-sorted array. + +Open Example +Source + +## Reduce Performance + +Benchmarks the reduce primitive over a configurable range of input sizes. Explains the +warmup-then-trials timing strategy with inline code excerpts showing how to call +`getTimingResult` after execution. + +Open Example +Source + +--- diff --git a/examples/reduce_perf.html b/examples/reduce_perf.html index 2e77432..b9cc085 100644 --- a/examples/reduce_perf.html +++ b/examples/reduce_perf.html @@ -7,7 +7,7 @@ - ← Back to Examples + ← Back to Performance

    Reduce Performance

    This example is a self-contained use of the reduce diff --git a/examples/scan_sort_perf.html b/examples/scan_sort_perf.html index 2e6fa5d..72de943 100644 --- a/examples/scan_sort_perf.html +++ b/examples/scan_sort_perf.html @@ -7,7 +7,7 @@ - ← Back to Examples + ← Back to Performance

    Scan / Sort Performance

    This example is a self-contained use of the scan and