Skip to content

[ExecuTorch][WebGPU] Add q8ta_conv2d_dw op (int8 depthwise conv)#21201

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

[ExecuTorch][WebGPU] Add q8ta_conv2d_dw op (int8 depthwise conv)#21201
JCNTH wants to merge 1 commit into
gh/JCNTH/161/basefrom
gh/JCNTH/161/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 quantized depthwise convolution. A depthwise nn.Conv2d (groups == channels) through XNNPACK static PT2E lowers to a delegated quantize_per_tensor -> q8ta_conv2d_dw -> dequantize_per_tensor subgraph; the quantize/dequantize are the landed C0 ops, so q8ta_conv2d_dw is the one missing piece to run a quantized depthwise conv end-to-end.

Solution: Port et_vk.q8ta_conv2d_dw (int8 activation x int8 per-channel weight -> int8). Depthwise means groups == C == OC: each output channel c convolves only input channel c with its own Kh x Kw filter. Per output element: acc = Σ_{kh,kw} (x_int8[n,c,ih,iw] - input_zero_point) * weight_int8[kh,kw,c] with ih = oh*stride_h - pad_h + kh*dil_h, iw = ow*stride_w - pad_w + kw*dil_w (out-of-bounds taps skipped = zero padding); dequantize acc * input_scale * weight_scales[c] + bias, requantize clamp(round(v * inv_output_scale) + output_zero_point, -128, 127), packed 4 int8 per word. Mirrors Vulkan q8ta_conv2d_dw (Q8taConv2dDW.cpp + q8ta_conv2d_dw.glsl) and the landed conv1d_dw windowing.

Implementation: Q8taConv2dDw.cpp registers q8ta_conv2d_dw.default, out = args.back(), one thread per output word = 4 consecutive W_out positions of a fixed (n, c, oh) (W_out % 4 == 0 for output word alignment), 2D dispatch fold to lift the 65535 cap. Reads full conv geometry (stride/padding/dilation int-lists, groups) and guards groups == C == OC, [N,C,H_in,W_in] / [Kh,Kw,OC] / [N,C,H_out,W_out] ranks, int8 dtypes, and activation == "none" (all fail-loud). Q8taConvDwParams is an 80-byte (16-aligned) uniform.

Constraints / divergences from the Vulkan reference (numerically equivalent, golden-verified): (1) the weight_sums arg is unused — the input zero-point correction is folded per-element (Σ(x-zp)·w == Σx·w - zp·Σw), so it matches Vulkan's weight_sums compensation exactly, including at zero-padded taps. (2) weight arrives raw [Kh,Kw,OC] int8 (the AOT pattern's depthwise reshape permute(2,3,1,0); the WebGPU prepack is a passthrough), not Vulkan's int8x4-block 4W4C texture layout. activation scoped to "none" (the XNNPACK-static default; relu-fused is fail-loud, a follow-up).

Differential Revision: D112257645

[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/21201

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:

❌ 44 New Failures, 3 Unrelated Failures

As of commit c6ed46b 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
@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.

@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
@JCNTH
JCNTH requested a review from psiddh July 23, 2026 02:03

@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