build based on 9175ba6

Author: Documenter.jl

previews/PR559/.documenter-siteinfo.json

@@ -1 +1 @@
-{"documenter":{"julia_version":"1.10.10","generation_timestamp":"2025-12-16T09:17:08","documenter_version":"1.16.1"}}
+{"documenter":{"julia_version":"1.10.10","generation_timestamp":"2025-12-16T09:57:36","documenter_version":"1.16.1"}}

previews/PR559/api/arrays/index.html

@@ -94,4 +94,4 @@
 c = vec(b)  # Returns 1D view</code></pre><h2 id="Advanced:-Custom-Array-Wrappers"><a class="docs-heading-anchor" href="#Advanced:-Custom-Array-Wrappers">Advanced: Custom Array Wrappers</a><a id="Advanced:-Custom-Array-Wrappers-1"></a><a class="docs-heading-anchor-permalink" href="#Advanced:-Custom-Array-Wrappers" title="Permalink"></a></h2><p>For advanced use cases, oneAPI.jl provides type aliases for array wrappers:</p><ul><li><code>oneDenseArray</code>: Dense contiguous arrays</li><li><code>oneStridedArray</code>: Arrays with arbitrary strides (including views)</li><li><code>oneWrappedArray</code>: Any array backed by a oneArray</li></ul><p>These are useful for writing functions that accept various array types:</p><pre><code class="language-julia hljs">function my_kernel!(a::oneStridedArray{Float32})
     # Accepts oneArray and views
     a .+= 1.0f0
-end</code></pre></article><nav class="docs-footer"><a class="docs-footer-prevpage" href="../context/">« Context &amp; Device Management</a><a class="docs-footer-nextpage" href="../kernels/">Kernel Programming »</a><div class="flexbox-break"></div><p class="footer-message">Powered by <a href="https://github.com/JuliaDocs/Documenter.jl">Documenter.jl</a> and the <a href="https://julialang.org/">Julia Programming Language</a>.</p></nav></div><div class="modal" id="documenter-settings"><div class="modal-background"></div><div class="modal-card"><header class="modal-card-head"><p class="modal-card-title">Settings</p><button class="delete"></button></header><section class="modal-card-body"><p><label class="label">Theme</label><div class="select"><select id="documenter-themepicker"><option value="auto">Automatic (OS)</option><option value="documenter-light">documenter-light</option><option value="documenter-dark">documenter-dark</option><option value="catppuccin-latte">catppuccin-latte</option><option value="catppuccin-frappe">catppuccin-frappe</option><option value="catppuccin-macchiato">catppuccin-macchiato</option><option value="catppuccin-mocha">catppuccin-mocha</option></select></div></p><hr/><p>This document was generated with <a href="https://github.com/JuliaDocs/Documenter.jl">Documenter.jl</a> version 1.16.1 on <span class="colophon-date" title="Tuesday 16 December 2025 09:17">Tuesday 16 December 2025</span>. Using Julia version 1.10.10.</p></section><footer class="modal-card-foot"></footer></div></div></div></body></html>
+end</code></pre></article><nav class="docs-footer"><a class="docs-footer-prevpage" href="../context/">« Context &amp; Device Management</a><a class="docs-footer-nextpage" href="../kernels/">Kernel Programming »</a><div class="flexbox-break"></div><p class="footer-message">Powered by <a href="https://github.com/JuliaDocs/Documenter.jl">Documenter.jl</a> and the <a href="https://julialang.org/">Julia Programming Language</a>.</p></nav></div><div class="modal" id="documenter-settings"><div class="modal-background"></div><div class="modal-card"><header class="modal-card-head"><p class="modal-card-title">Settings</p><button class="delete"></button></header><section class="modal-card-body"><p><label class="label">Theme</label><div class="select"><select id="documenter-themepicker"><option value="auto">Automatic (OS)</option><option value="documenter-light">documenter-light</option><option value="documenter-dark">documenter-dark</option><option value="catppuccin-latte">catppuccin-latte</option><option value="catppuccin-frappe">catppuccin-frappe</option><option value="catppuccin-macchiato">catppuccin-macchiato</option><option value="catppuccin-mocha">catppuccin-mocha</option></select></div></p><hr/><p>This document was generated with <a href="https://github.com/JuliaDocs/Documenter.jl">Documenter.jl</a> version 1.16.1 on <span class="colophon-date" title="Tuesday 16 December 2025 09:57">Tuesday 16 December 2025</span>. Using Julia version 1.10.10.</p></section><footer class="modal-card-foot"></footer></div></div></div></body></html>

previews/PR559/api/compiler/index.html

@@ -91,4 +91,4 @@
 # Should be type-stable now!
 
 # Check the generated code
-@device_code_llvm @oneapi groups=1 items=1 sum_kernel_v2!(result, data)</code></pre><h2 id="Profiling"><a class="docs-heading-anchor" href="#Profiling">Profiling</a><a id="Profiling-1"></a><a class="docs-heading-anchor-permalink" href="#Profiling" title="Permalink"></a></h2><p>For performance profiling, see the <a href="../../usage/performance/#Performance-Guide">Performance Guide</a>.</p><h2 id="Troubleshooting"><a class="docs-heading-anchor" href="#Troubleshooting">Troubleshooting</a><a id="Troubleshooting-1"></a><a class="docs-heading-anchor-permalink" href="#Troubleshooting" title="Permalink"></a></h2><h3 id="Compilation-Errors"><a class="docs-heading-anchor" href="#Compilation-Errors">Compilation Errors</a><a id="Compilation-Errors-1"></a><a class="docs-heading-anchor-permalink" href="#Compilation-Errors" title="Permalink"></a></h3><p>If you encounter compilation errors:</p><ol><li><strong>Check type stability</strong>: Use <code>@device_code_warntype</code></li><li><strong>Inspect LLVM IR</strong>: Use <code>@device_code_llvm</code> to see if the issue is in LLVM generation</li><li><strong>Simplify the kernel</strong>: Comment out sections to isolate the problematic code</li><li><strong>Check argument types</strong>: Ensure arguments are GPU-compatible (isbits types)</li></ol><h3 id="SPIR-V-Issues"><a class="docs-heading-anchor" href="#SPIR-V-Issues">SPIR-V Issues</a><a id="SPIR-V-Issues-1"></a><a class="docs-heading-anchor-permalink" href="#SPIR-V-Issues" title="Permalink"></a></h3><p>If SPIR-V generation fails:</p><ol><li><strong>Update dependencies</strong>: Ensure SPIRV-LLVM-Translator is up to date</li><li><strong>Check device capabilities</strong>: Some operations require specific hardware features</li><li><strong>Reduce complexity</strong>: Very complex kernels might hit compiler limits</li></ol><h3 id="Performance-Issues"><a class="docs-heading-anchor" href="#Performance-Issues">Performance Issues</a><a id="Performance-Issues-1"></a><a class="docs-heading-anchor-permalink" href="#Performance-Issues" title="Permalink"></a></h3><p>If your kernel is slow:</p><ol><li><strong>Profile memory access patterns</strong>: Coalesced access is crucial</li><li><strong>Check occupancy</strong>: Are you launching enough work-items?</li><li><strong>Minimize barriers</strong>: Synchronization has overhead</li><li><strong>Use local memory wisely</strong>: It&#39;s faster than global memory but limited in size</li></ol></article><nav class="docs-footer"><a class="docs-footer-prevpage" href="../memory/">« Memory Management</a><a class="docs-footer-nextpage" href="../../level_zero/">Level Zero (oneL0) »</a><div class="flexbox-break"></div><p class="footer-message">Powered by <a href="https://github.com/JuliaDocs/Documenter.jl">Documenter.jl</a> and the <a href="https://julialang.org/">Julia Programming Language</a>.</p></nav></div><div class="modal" id="documenter-settings"><div class="modal-background"></div><div class="modal-card"><header class="modal-card-head"><p class="modal-card-title">Settings</p><button class="delete"></button></header><section class="modal-card-body"><p><label class="label">Theme</label><div class="select"><select id="documenter-themepicker"><option value="auto">Automatic (OS)</option><option value="documenter-light">documenter-light</option><option value="documenter-dark">documenter-dark</option><option value="catppuccin-latte">catppuccin-latte</option><option value="catppuccin-frappe">catppuccin-frappe</option><option value="catppuccin-macchiato">catppuccin-macchiato</option><option value="catppuccin-mocha">catppuccin-mocha</option></select></div></p><hr/><p>This document was generated with <a href="https://github.com/JuliaDocs/Documenter.jl">Documenter.jl</a> version 1.16.1 on <span class="colophon-date" title="Tuesday 16 December 2025 09:17">Tuesday 16 December 2025</span>. Using Julia version 1.10.10.</p></section><footer class="modal-card-foot"></footer></div></div></div></body></html>
+@device_code_llvm @oneapi groups=1 items=1 sum_kernel_v2!(result, data)</code></pre><h2 id="Profiling"><a class="docs-heading-anchor" href="#Profiling">Profiling</a><a id="Profiling-1"></a><a class="docs-heading-anchor-permalink" href="#Profiling" title="Permalink"></a></h2><p>For performance profiling, see the <a href="../../usage/performance/#Performance-Guide">Performance Guide</a>.</p><h2 id="Troubleshooting"><a class="docs-heading-anchor" href="#Troubleshooting">Troubleshooting</a><a id="Troubleshooting-1"></a><a class="docs-heading-anchor-permalink" href="#Troubleshooting" title="Permalink"></a></h2><h3 id="Compilation-Errors"><a class="docs-heading-anchor" href="#Compilation-Errors">Compilation Errors</a><a id="Compilation-Errors-1"></a><a class="docs-heading-anchor-permalink" href="#Compilation-Errors" title="Permalink"></a></h3><p>If you encounter compilation errors:</p><ol><li><strong>Check type stability</strong>: Use <code>@device_code_warntype</code></li><li><strong>Inspect LLVM IR</strong>: Use <code>@device_code_llvm</code> to see if the issue is in LLVM generation</li><li><strong>Simplify the kernel</strong>: Comment out sections to isolate the problematic code</li><li><strong>Check argument types</strong>: Ensure arguments are GPU-compatible (isbits types)</li></ol><h3 id="SPIR-V-Issues"><a class="docs-heading-anchor" href="#SPIR-V-Issues">SPIR-V Issues</a><a id="SPIR-V-Issues-1"></a><a class="docs-heading-anchor-permalink" href="#SPIR-V-Issues" title="Permalink"></a></h3><p>If SPIR-V generation fails:</p><ol><li><strong>Update dependencies</strong>: Ensure SPIRV-LLVM-Translator is up to date</li><li><strong>Check device capabilities</strong>: Some operations require specific hardware features</li><li><strong>Reduce complexity</strong>: Very complex kernels might hit compiler limits</li></ol><h3 id="Performance-Issues"><a class="docs-heading-anchor" href="#Performance-Issues">Performance Issues</a><a id="Performance-Issues-1"></a><a class="docs-heading-anchor-permalink" href="#Performance-Issues" title="Permalink"></a></h3><p>If your kernel is slow:</p><ol><li><strong>Profile memory access patterns</strong>: Coalesced access is crucial</li><li><strong>Check occupancy</strong>: Are you launching enough work-items?</li><li><strong>Minimize barriers</strong>: Synchronization has overhead</li><li><strong>Use local memory wisely</strong>: It&#39;s faster than global memory but limited in size</li></ol></article><nav class="docs-footer"><a class="docs-footer-prevpage" href="../memory/">« Memory Management</a><a class="docs-footer-nextpage" href="../../level_zero/">Level Zero (oneL0) »</a><div class="flexbox-break"></div><p class="footer-message">Powered by <a href="https://github.com/JuliaDocs/Documenter.jl">Documenter.jl</a> and the <a href="https://julialang.org/">Julia Programming Language</a>.</p></nav></div><div class="modal" id="documenter-settings"><div class="modal-background"></div><div class="modal-card"><header class="modal-card-head"><p class="modal-card-title">Settings</p><button class="delete"></button></header><section class="modal-card-body"><p><label class="label">Theme</label><div class="select"><select id="documenter-themepicker"><option value="auto">Automatic (OS)</option><option value="documenter-light">documenter-light</option><option value="documenter-dark">documenter-dark</option><option value="catppuccin-latte">catppuccin-latte</option><option value="catppuccin-frappe">catppuccin-frappe</option><option value="catppuccin-macchiato">catppuccin-macchiato</option><option value="catppuccin-mocha">catppuccin-mocha</option></select></div></p><hr/><p>This document was generated with <a href="https://github.com/JuliaDocs/Documenter.jl">Documenter.jl</a> version 1.16.1 on <span class="colophon-date" title="Tuesday 16 December 2025 09:57">Tuesday 16 December 2025</span>. Using Julia version 1.10.10.</p></section><footer class="modal-card-foot"></footer></div></div></div></body></html>

previews/PR559/api/context/index.html

@@ -36,4 +36,4 @@
     device!(2)
     b = oneArray(rand(Float32, 100))
     # ... operations on device 2 ...
-end</code></pre></article><nav class="docs-footer"><a class="docs-footer-prevpage" href="../">« Overview</a><a class="docs-footer-nextpage" href="../arrays/">Array Operations »</a><div class="flexbox-break"></div><p class="footer-message">Powered by <a href="https://github.com/JuliaDocs/Documenter.jl">Documenter.jl</a> and the <a href="https://julialang.org/">Julia Programming Language</a>.</p></nav></div><div class="modal" id="documenter-settings"><div class="modal-background"></div><div class="modal-card"><header class="modal-card-head"><p class="modal-card-title">Settings</p><button class="delete"></button></header><section class="modal-card-body"><p><label class="label">Theme</label><div class="select"><select id="documenter-themepicker"><option value="auto">Automatic (OS)</option><option value="documenter-light">documenter-light</option><option value="documenter-dark">documenter-dark</option><option value="catppuccin-latte">catppuccin-latte</option><option value="catppuccin-frappe">catppuccin-frappe</option><option value="catppuccin-macchiato">catppuccin-macchiato</option><option value="catppuccin-mocha">catppuccin-mocha</option></select></div></p><hr/><p>This document was generated with <a href="https://github.com/JuliaDocs/Documenter.jl">Documenter.jl</a> version 1.16.1 on <span class="colophon-date" title="Tuesday 16 December 2025 09:17">Tuesday 16 December 2025</span>. Using Julia version 1.10.10.</p></section><footer class="modal-card-foot"></footer></div></div></div></body></html>
+end</code></pre></article><nav class="docs-footer"><a class="docs-footer-prevpage" href="../">« Overview</a><a class="docs-footer-nextpage" href="../arrays/">Array Operations »</a><div class="flexbox-break"></div><p class="footer-message">Powered by <a href="https://github.com/JuliaDocs/Documenter.jl">Documenter.jl</a> and the <a href="https://julialang.org/">Julia Programming Language</a>.</p></nav></div><div class="modal" id="documenter-settings"><div class="modal-background"></div><div class="modal-card"><header class="modal-card-head"><p class="modal-card-title">Settings</p><button class="delete"></button></header><section class="modal-card-body"><p><label class="label">Theme</label><div class="select"><select id="documenter-themepicker"><option value="auto">Automatic (OS)</option><option value="documenter-light">documenter-light</option><option value="documenter-dark">documenter-dark</option><option value="catppuccin-latte">catppuccin-latte</option><option value="catppuccin-frappe">catppuccin-frappe</option><option value="catppuccin-macchiato">catppuccin-macchiato</option><option value="catppuccin-mocha">catppuccin-mocha</option></select></div></p><hr/><p>This document was generated with <a href="https://github.com/JuliaDocs/Documenter.jl">Documenter.jl</a> version 1.16.1 on <span class="colophon-date" title="Tuesday 16 December 2025 09:57">Tuesday 16 December 2025</span>. Using Julia version 1.10.10.</p></section><footer class="modal-card-foot"></footer></div></div></div></body></html>