Skip to content

Run SYCL Academy lessons through autofix #432

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
TApplencourt merged 34 commits into from
Jul 23, 2026
Merged

Run SYCL Academy lessons through autofix #432

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
34 commits
Select commit Hold shift + click to select a range
cd98ef8
detect when data-noescape should be applied to a code block
MikeL270 Jul 21, 2026
cfbf8f2
update lesson checker and tests
MikeL270 Jul 21, 2026
d56b483
autofix Data_and_Dependence
MikeL270 Jul 21, 2026
ea86c04
autofix Data_Parallelism
MikeL270 Jul 21, 2026
a0defa6
only create cmakelists on extract
MikeL270 Jul 21, 2026
41d24db
autofix Device_Discovery
MikeL270 Jul 21, 2026
b84beb5
autofix Enqueueing_a_Kernel
MikeL270 Jul 21, 2026
c22668a
better handling for partial escape sequences
MikeL270 Jul 22, 2026
f8986c5
improved handling for unescaped characters in bodies
MikeL270 Jul 22, 2026
c958193
autofix Fast_Track
MikeL270 Jul 22, 2026
2e79aab
autofix Enqueueing_a_Kernel II (better auto fix)
MikeL270 Jul 22, 2026
ba3a9cc
autofix Hanlding_Errors
MikeL270 Jul 22, 2026
39f112c
autofix Image_Convolution
MikeL270 Jul 22, 2026
fb95e21
autofix Introduction_To_USM
MikeL270 Jul 22, 2026
0a83c92
autofix Local_Memory_Tiling
MikeL270 Jul 22, 2026
0b38a2a
autofix Managing_Data
MikeL270 Jul 22, 2026
007f295
autofix Matrix_Transpose
MikeL270 Jul 22, 2026
76ac842
autofix More_SYCL_Features
MikeL270 Jul 22, 2026
6fcd1b1
autofix Multiple_Devices
MikeL270 Jul 22, 2026
db88afc
autofix oneMath_gemm
MikeL270 Jul 22, 2026
2e2c4e2
autofix Using_USM
MikeL270 Jul 22, 2026
3b5564d
autofix Vectors
MikeL270 Jul 22, 2026
caaab98
fix lessonchecker
MikeL270 Jul 23, 2026
18c55e8
remove random </br>
MikeL270 Jul 23, 2026
cd9d97f
remove debug statement from lesson checker
MikeL270 Jul 23, 2026
e33fb33
re run fast track autofix
MikeL270 Jul 23, 2026
10eb4f0
check for missing data-line-numbers
MikeL270 Jul 23, 2026
3831f03
add line numbers to all lessons
MikeL270 Jul 23, 2026
a8db5ca
address feedback
MikeL270 Jul 23, 2026
94abec4
Apply suggestion from @TApplencourt
TApplencourt Jul 23, 2026
6cb8975
remove extra lesson oops
MikeL270 Jul 23, 2026
8a01d4b
refix onemath
MikeL270 Jul 23, 2026
31c239d
refix onemath x 2
MikeL270 Jul 23, 2026
1389b82
add test for charref
MikeL270 Jul 23, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
30 changes: 12 additions & 18 deletions Lesson_Materials/Advanced_Data_Flow/index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,17 +2,11 @@

<html>
<head>
<meta charset="utf-8" />
<link rel="stylesheet" href="../../Static/css/reveal.css" />
<link
rel="stylesheet"
href="../../Static/css/theme/white.css"
/>
<link rel="stylesheet" href="../../Static/css/custom.css" />
<link
rel="stylesheet"
href="../../Static/css/atom-one-light.css"
/>
<meta charset="utf-8"/>
<link rel="stylesheet" href="../../Static/css/reveal.css"/>
<link rel="stylesheet" href="../../Static/css/theme/white.css"/>
<link rel="stylesheet" href="../../Static/css/custom.css"/>
<link rel="stylesheet" href="../../Static/css/atom-one-light.css"/>
<script src="../../node_modules/reveal.js/dist/reveal.js" defer></script>
<script src="../../node_modules/reveal.js/dist/plugin/markdown.js" defer></script>
<script src="../../node_modules/reveal.js/dist/plugin/highlight.js" defer></script>
Expand Down Expand Up @@ -61,7 +55,7 @@
#### Initial data (USM)
</div>
<div class="container">
<pre><code class="language-cpp">
<pre><code class="language-cpp" data-line-numbers>
auto devicePtr = sycl::malloc_device(sizeInBytes, gpuQueue);

gpuQueue.memcpy(devicePtr, initialData, sizeInBytes).wait();
Expand All @@ -80,7 +74,7 @@
#### Initial data (USM)
</div>
<div class="container">
<pre><code class="language-cpp">
<pre><code class="language-cpp" data-line-numbers>
auto sharedData = sycl::malloc_shared(sizeInBytes, gpuQueue);
</code></pre>
</div>
Expand All @@ -96,7 +90,7 @@
#### Initial data (buffer/accessor)
</div>
<div class="container">
<pre><code class="language-cpp">
<pre><code class="language-cpp" data-line-numbers>
auto buf = sycl::buffer{initialData, sycl::range{size}};
</code></pre>
</div>
Expand All @@ -115,7 +109,7 @@
#### Use_host_pointer property
</div>
<div class="container">
<pre><code class="language-cpp">
<pre><code class="language-cpp" data-line-numbers>
auto buf = sycl::buffer{initialData, sycl::range{size},
{sycl::property::buffer::use_host_ptr{}}};
</code></pre>
Expand Down Expand Up @@ -146,7 +140,7 @@
#### Set_final_data
</div>
<div class="container">
<pre><code class="language-cpp">
<pre><code class="language-cpp" data-line-numbers>
auto buf = sycl::buffer{initialData, sycl::range{size}};

buf.set_final_data(finalData);
Expand All @@ -165,7 +159,7 @@
#### Set_final_data
</div>
<div class="container">
<pre><code class="language-cpp">
<pre><code class="language-cpp" data-line-numbers>
auto buf = sycl::buffer{initialData, sycl::range{size}};

buf.set_final_data(nullptr);
Expand All @@ -186,7 +180,7 @@
#### Uninitialized buffers (buffer/accessor)
</div>
<div class="container">
<pre><code class="language-cpp">
<pre><code class="language-cpp" data-line-numbers>
auto buf = sycl::buffer&lt;T&gt;{sycl::range{size}};
</code></pre>
</div>
Expand Down
24 changes: 9 additions & 15 deletions Lesson_Materials/Data_Parallelism/index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,17 +2,11 @@

<html>
<head>
<meta charset="utf-8" />
<link rel="stylesheet" href="../../Static/css/reveal.css" />
<link
rel="stylesheet"
href="../../Static/css/theme/white.css"
/>
<link rel="stylesheet" href="../../Static/css/custom.css" />
<link
rel="stylesheet"
href="../../Static/css/atom-one-light.css"
/>
<meta charset="utf-8"/>
<link rel="stylesheet" href="../../Static/css/reveal.css"/>
<link rel="stylesheet" href="../../Static/css/theme/white.css"/>
<link rel="stylesheet" href="../../Static/css/custom.css"/>
<link rel="stylesheet" href="../../Static/css/atom-one-light.css"/>
<script src="../../node_modules/reveal.js/dist/reveal.js" defer></script>
<script src="../../node_modules/reveal.js/dist/plugin/markdown.js" defer></script>
<script src="../../node_modules/reveal.js/dist/plugin/highlight.js" defer></script>
Expand Down Expand Up @@ -257,8 +251,8 @@
* Runtime may not always have enough information to choose the best-performing size
</div>
<div style="text-align: right;">
<img src="../../Static/images/ndrange.png" alt="ND-Range" style="width:90%" /><br />
<img src="../../Static/images/SYCL_range.png" alt="SYCL-Range" style="width:90%" />
<img src="../../Static/images/ndrange.png" alt="ND-Range" style="width:90%"/>
<img src="../../Static/images/SYCL_range.png" alt="SYCL-Range" style="width:90%"/>
</div>
</div>
</section>
Expand Down Expand Up @@ -432,8 +426,8 @@
event cpy_evt_1 = gpuQueue.copy(hA.data(), dA, hA.size());
event cpy_evt_2 = gpuQueue.copy(hB.data(), dB, hB.size());

gpuQueue.parallel_for(range&lt1&gt(dA.size()) {cpy_evt_1, cpy_evt_2},
[=](id&lt1&gt i){
gpuQueue.parallel_for(range&amp;&lt;1&gt;(dA.size()) {cpy_evt_1, cpy_evt_2},
[=](id&amp;lt1&gt; i){
<mark>out[i] = inA[i] + inB[i];</mark>
});

Expand Down
56 changes: 25 additions & 31 deletions Lesson_Materials/Data_and_Dependencies/index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,17 +2,11 @@

<html>
<head>
<meta charset="utf-8" />
<link rel="stylesheet" href="../../Static/css/reveal.css" />
<link
rel="stylesheet"
href="../../Static/css/theme/white.css"
/>
<link rel="stylesheet" href="../../Static/css/custom.css" />
<link
rel="stylesheet"
href="../../Static/css/atom-one-light.css"
/>
<meta charset="utf-8"/>
<link rel="stylesheet" href="../../Static/css/reveal.css"/>
<link rel="stylesheet" href="../../Static/css/theme/white.css"/>
<link rel="stylesheet" href="../../Static/css/custom.css"/>
<link rel="stylesheet" href="../../Static/css/atom-one-light.css"/>
<script src="../../node_modules/reveal.js/dist/reveal.js" defer></script>
<script src="../../node_modules/reveal.js/dist/plugin/markdown.js" defer></script>
<script src="../../node_modules/reveal.js/dist/plugin/highlight.js" defer></script>
Expand Down Expand Up @@ -117,10 +111,10 @@
</div>
<div class="container">
<div class="col">
<code class="code-100pc"><pre>
<pre><code class="language-cpp" data-line-numbers>
sycl::buffer buf {data, sycl::range{1024}};

gpuQueue.submit([&](sycl::handler &cgh) {
gpuQueue.submit([&amp;](sycl::handler &amp;cgh) {
sycl::accessor acc {buf, cgh};

cgh.parallel_for&lt;kernel_a&gt;(sycl::range{1024},
Expand All @@ -129,7 +123,7 @@
});
});

gpuQueue.submit([&](sycl::handler &cgh) {
gpuQueue.submit([&amp;](sycl::handler &amp;cgh) {
sycl::accessor acc{buf, cgh};

cgh.parallel_for&lt;kernel_b&gt;(sycl::range{1024},
Expand All @@ -155,10 +149,10 @@
</div>
<div class="container">
<div class="col">
<code class="code-100pc" data-noescape><pre>
<pre><code data-noescape class="language-cpp" data-line-numbers>
<mark>sycl::buffer buf {data, sycl::range{1024}};</mark>

gpuQueue.submit([&](sycl::handler &cgh) {
gpuQueue.submit([&amp;](sycl::handler &amp;cgh) {
sycl::accessor acc {buf, cgh};

cgh.parallel_for&lt;kernel_a&gt;(sycl::range{1024},
Expand All @@ -167,7 +161,7 @@
});
});

gpuQueue.submit([&](sycl::handler &cgh) {
gpuQueue.submit([&amp;](sycl::handler &amp;cgh) {
sycl::accessor acc {buf, cgh};

cgh.parallel_for&lt;kernel_b&gt;(sycl::range{1024},
Expand All @@ -194,10 +188,10 @@
</div>
<div class="container">
<div class="col">
<code class="code-100pc" data-noescape><pre>
<pre><code data-noescape class="language-cpp" data-line-numbers>
sycl::buffer buf {data, sycl::range{1024}};

gpuQueue.submit([&](sycl::handler &cgh) {
gpuQueue.submit([&amp;](sycl::handler &amp;cgh) {
<mark>sycl::accessor acc{buf, cgh};</mark>

cgh.parallel_for&lt;my_kernel&gt;(sycl::range{1024},
Expand All @@ -206,7 +200,7 @@
});
});

gpuQueue.submit([&](sycl::handler &cgh) {
gpuQueue.submit([&amp;](sycl::handler &amp;cgh) {
<mark>sycl::accessor acc{buf, cgh};</mark>

cgh.parallel_for&lt;my_kernel&gt;(sycl::range{1024},
Expand All @@ -232,10 +226,10 @@
</div>
<div class="container">
<div class="col">
<code class="code-100pc" data-noescape><pre>
<pre><code data-noescape class="language-cpp" data-line-numbers>
buf = sycl::buffer(data, sycl::range{1024});

gpuQueue.submit([&](sycl::handler &cgh) {
gpuQueue.submit([&amp;](sycl::handler &amp;cgh) {
sycl::accessor acc {buf, <mark>cgh</mark>};

cgh.parallel_for&lt;my_kernel&gt;(sycl::range{1024},
Expand All @@ -244,7 +238,7 @@
});
});

gpuQueue.submit([&](sycl::handler &cgh) {
gpuQueue.submit([&amp;](sycl::handler &amp;cgh) {
sycl::accessor acc {buf, <mark>cgh</mark>};

cgh.parallel_for&lt;my_kernel&gt;(sycl::range{1024},
Expand All @@ -269,7 +263,7 @@
</div>
<div class="container">
<div class="col">
<code class="code-100pc"><pre>
<pre><code class="language-cpp" data-line-numbers>
auto devicePtr =
sycl::malloc_device&lt;int&gt;(1024, gpuQueue);

Expand Down Expand Up @@ -308,7 +302,7 @@
</div>
<div class="container">
<div class="col">
<code class="code-100pc" data-noescape><pre>
<pre><code data-noescape class="language-cpp" data-line-numbers>
auto devicePtr =
sycl::malloc_device&lt;int&gt;(1024, gpuQueue);

Expand Down Expand Up @@ -343,7 +337,7 @@
</div>
<div class="container">
<div class="col">
<code class="code-100pc" data-noescape><pre>
<pre><code data-noescape class="language-cpp" data-line-numbers>
auto devicePtr =
sycl::malloc_device&lt;int&gt;(1024, gpuQueue);

Expand Down Expand Up @@ -396,11 +390,11 @@
</div>
<div class="container">
<div class="col">
<code class="code-100pc" data-noescape><pre>
<pre><code data-noescape class="language-cpp" data-line-numbers>
sycl::buffer bufA {dataA, sycl::range{1024}};
sycl::buffer bufB {dataB, sycl::range{1024}};

gpuQueue.submit([&](sycl::handler &cgh) {
gpuQueue.submit([&amp;](sycl::handler &amp;cgh) {
<mark>sycl::accessor accA {bufA, cgh};</mark>

cgh.parallel_for&lt;kernel_a&gt;(sycl::range{1024},
Expand All @@ -409,7 +403,7 @@
});
});

gpuQueue.submit([&](sycl::handler &cgh) {
gpuQueue.submit([&amp;](sycl::handler &amp;cgh) {
<mark>sycl::accessor accB {bufB, cgh};</mark>

cgh.parallel_for&lt;kernel_b&gt;(sycl::range{1024},
Expand All @@ -435,7 +429,7 @@
#### Concurrent data flow with USM
</div>
<div class="container">
<code class="code-100pc" data-noescape><pre>
<pre><code data-noescape class="language-cpp" data-line-numbers>
auto devicePtrA = sycl::malloc_device&lt;int&gt;(1024, gpuQueue);
auto devicePtrB = sycl::malloc_device&lt;int&gt;(1024, gpuQueue);

Expand Down Expand Up @@ -469,7 +463,7 @@
#### Concurrent data flow with USM
</div>
<div class="container">
<code class="code-100pc" data-noescape><pre>
<pre><code data-noescape class="language-cpp" data-line-numbers>
auto devicePtrA = sycl::malloc_device&lt;int&gt;(1024, gpuQueue);
auto devicePtrB = sycl::malloc_device&lt;int&gt;(1024, gpuQueue);

Expand Down
Loading
Loading