Skip to content

[ExecuTorch][WebGPU] Add conv_with_clamp op (et_vk.conv_with_clamp)#21217

Open
JCNTH wants to merge 1 commit into
gh/JCNTH/177/basefrom
gh/JCNTH/177/head
Open

[ExecuTorch][WebGPU] Add conv_with_clamp op (et_vk.conv_with_clamp)#21217
JCNTH wants to merge 1 commit into
gh/JCNTH/177/basefrom
gh/JCNTH/177/head

Conversation

@JCNTH

@JCNTH JCNTH commented Jul 22, 2026

Copy link
Copy Markdown
Contributor

Stack from ghstack (oldest at bottom):

Problem: The WebGPU delegate has no et_vk.conv_with_clamp — a fused fp32 2D convolution + output clamp (e.g. a Conv2d followed by relu6). It delegates through VulkanPartitioner (op_registry.py tags et_vk.conv_with_clamp.default; nn.Conv2d+F.relu6 fuses to it) but had no WebGPU handler.

Solution: Port et_vk.conv_with_clamp (fp32, groups==1), mirroring the Vulkan conv handler (impl/Convolution.cpp:837) + the eager clamp(convolution(...), output_min, output_max) (custom_ops_lib.py). Direct windowed conv reusing the staged q8ta_conv2d windowing structure but fp32 (no int8 unpack/dequant/requant) + a clamp epilogue: per NCHW output cell out[n,oc,oh,ow] = clamp(bias[oc] + Σ_{ic,kh,kw} weight[oc,ic,kh,kw] * input[n,ic, oh*sh-ph+kh*dh, ow*sw-pw+kw*dw], output_min, output_max), OOB taps skipped.

Implementation: conv_with_clamp/ConvWithClamp.cpp registers et_vk.conv_with_clamp.default -> conv_with_clamp_impl. Args [in, weight, bias?, stride, padding, dilation, transposed, output_padding, groups, output_min?, output_max?, out]; stride/padding/dilation as int-pairs, output_min/output_max as Scalar? (Double/Int -> value, absent -> -/+inf so clamp is a passthrough). conv_with_clamp.wgsl: one thread per output element, RAW [OC,IC,Kh,Kw] weight (the fp32 buffer path gets the raw constant, like conv1d_dw/pw — not the q8ta im2col [OC,Kh*Kw*IC]), 2D-folded dispatch. ConvWithClampParams (80 bytes) matches the WGSL Params. Guards: in/weight/out 4D + fp32, weight.dims[1]==IC, numel<=u32, groups==1 + not-transposed, all fail-loud.

Constraints / divergences from the Vulkan reference: buffer re-derivation of Vulkan's texture conv (conv2d_prepack_weights.glsl) — the naive one-thread-per-output form is forced by the buffer-only backend. Scoped to groups==1 + not-transposed (fail-loud otherwise). Note: overlaps the general convolution op — this handles the clamped variant only.

Differential Revision: D112257644

[ghstack-poisoned]
@pytorch-bot

pytorch-bot Bot commented Jul 22, 2026

Copy link
Copy Markdown

🔗 Helpful Links

🧪 See artifacts and rendered test results at hud.pytorch.org/pr/pytorch/executorch/21217

Note: Links to docs will display an error until the docs builds have been completed.

❗ 1 Active SEVs

There are 1 currently active SEVs. If your PR is affected, please view them below:

❌ 46 New Failures, 3 Unrelated Failures

As of commit e64fee7 with merge base 266e0dc (image):

NEW FAILURES - The following jobs have failed:

FLAKY - The following jobs failed but were likely due to flakiness present on trunk:

  • pull / unittest / windows / windows-job (gh) (matched win rule in flaky-rules.json)
    Can't find 'action.yml', 'action.yaml' or 'Dockerfile' under 'C:\actions-runner\_work\executorch\executorch\test-infra\.github\actions\teardown-windows'. Did you forget to run actions/checkout before running your local action?
  • pull / unittest-editable / windows / windows-job (gh) (matched win rule in flaky-rules.json)
    Can't find 'action.yml', 'action.yaml' or 'Dockerfile' under 'C:\actions-runner\_work\executorch\executorch\test-infra\.github\actions\teardown-windows'. Did you forget to run actions/checkout before running your local action?

BROKEN TRUNK - The following job failed but were present on the merge base:

👉 Rebase onto the `viable/strict` branch to avoid these failures

This comment was automatically generated by Dr. CI and updates every 15 minutes.

This was referenced Jul 22, 2026
This was referenced Jul 22, 2026
@meta-cla meta-cla Bot added the CLA Signed This label is managed by the Facebook bot. Authors need to sign the CLA before a PR can be reviewed. label Jul 22, 2026
@github-actions

Copy link
Copy Markdown

This PR needs a release notes: label

If your change should be included in the release notes (i.e. would users of this library care about this change?), please use a label starting with release notes:. This helps us keep track and include your important work in the next release notes.

To add a label, you can comment to pytorchbot, for example
@pytorchbot label "release notes: none"

For more information, see
https://github.com/pytorch/pytorch/wiki/PyTorch-AutoLabel-Bot#why-categorize-for-release-notes-and-how-does-it-work.

@JCNTH
JCNTH requested a review from psiddh July 23, 2026 02:01

@psiddh psiddh left a comment

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.

Approving full WebGPU stack

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

CLA Signed This label is managed by the Facebook bot. Authors need to sign the CLA before a PR can be reviewed.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants