馃悰 Describe the bug
aten.embedding returns wrong values on Vulkan when the vocabulary exceeds 16384 rows and the output is a texture. There is no error; the model produces well-formed but semantically wrong embeddings.
This breaks sentence-transformers/all-MiniLM-L6-v2 (vocab 30522) under force_fp16.
Threshold
nn.Embedding(V, 384), 64 random indices, cosine of the Vulkan output against the CPU reference on an Adreno 840:
| vocab |
fp32 |
fp16 |
| 2048 |
1.000000 |
1.000000 |
| 4096 |
1.000000 |
1.000000 |
| 8192 |
1.000000 |
1.000000 |
| 16384 |
1.000000 |
1.000000 |
| 16385 |
0.255916 |
0.255916 |
| 20000 |
0.256048 |
0.256048 |
| 30522 |
0.259350 |
0.259349 |
The break is exactly at 16384, which is this device's maxImageDimension2D, and it is precision-independent. All of these dispatch embedding_texture3d_{float,half}.
Why force_fp16 turns this into a real-model failure
all-MiniLM-L6-v2 at the published 254-token shape, 8 sentences, embeddings compared against the CPU reference:
|
mean cosine |
pairwise similarity max abs diff |
top-1 nearest neighbour preserved |
| fp32 |
0.999999 |
0.00031 |
8 / 8 |
| fp16 |
0.219010 |
0.68950 |
1 / 8 |
One embedding comes back at cosine -0.016 against its reference. The semantic structure is destroyed, so this silently breaks retrieval rather than merely degrading it.
The two differ only in which embedding kernel they reach:
fp32: embedding_buffer_float
fp16: embedding_texture3d_half
force_fp16 biases the graph toward texture storage (TagMemoryMetaPass.constrain_op_arg_repset calls try_constrain_with_arg_repset(arg_i, utils.ANY_TEXTURE) unconditionally when force_fp16 is set), which moves the embedding output from buffer to texture and onto the broken path. fp32 escapes only by landing on the buffer kernel.
What I ruled out
For the MiniLM failure specifically: dynamic shapes (a static export is bit-identical), the padding and attention mask (a fully unmasked 254-token input fails the same, cosine 0.169), and the mean-pool/normalise tail (the pre-pool token output is already wrong). Exporting only model.embeddings reproduces it at cosine 0.33, before any encoder layer.
For the isolated case: it is not the legacy texture-weight path. embedding() in Embedding.cpp prepacks the weight as kBuffer for these models, and the dispatched kernel is the non-legacy embedding_texture3d_*. I tried guarding the legacy branch on max_texture2d_dim() and it changed nothing, confirming that branch is not involved.
I did not find the exact mechanism inside embedding_texture.glsl. load_weight_texel() computes embedding_idx * width(weight) + dim_idx, which does not overflow int32 at these sizes, so the 16384 boundary most likely comes from how the indices or the weight are addressed rather than from that multiply.
Suggested direction
Two things seem worth separating:
force_fp16 should not push a tensor toward texture storage without consulting texture limits, so oversized cases keep the working buffer kernel.
- Exceeding texture extents should fail loudly rather than silently returning garbage.
Repro
Scripts are straightforward to reconstruct from the table above: export nn.Embedding(V, 384) with VulkanPartitioner() for V on either side of 16384 and compare against the CPU reference.
Versions
ExecuTorch 1.4.1 for the export, runtime at c27baa8. Device: Samsung Galaxy S26 Ultra, Snapdragon SM8850, Adreno 840, Android 16.
馃悰 Describe the bug
aten.embeddingreturns wrong values on Vulkan when the vocabulary exceeds 16384 rows and the output is a texture. There is no error; the model produces well-formed but semantically wrong embeddings.This breaks
sentence-transformers/all-MiniLM-L6-v2(vocab 30522) underforce_fp16.Threshold
nn.Embedding(V, 384), 64 random indices, cosine of the Vulkan output against the CPU reference on an Adreno 840:The break is exactly at 16384, which is this device's
maxImageDimension2D, and it is precision-independent. All of these dispatchembedding_texture3d_{float,half}.Why force_fp16 turns this into a real-model failure
all-MiniLM-L6-v2at the published 254-token shape, 8 sentences, embeddings compared against the CPU reference:One embedding comes back at cosine -0.016 against its reference. The semantic structure is destroyed, so this silently breaks retrieval rather than merely degrading it.
The two differ only in which embedding kernel they reach:
force_fp16biases the graph toward texture storage (TagMemoryMetaPass.constrain_op_arg_repsetcallstry_constrain_with_arg_repset(arg_i, utils.ANY_TEXTURE)unconditionally whenforce_fp16is set), which moves the embedding output from buffer to texture and onto the broken path. fp32 escapes only by landing on the buffer kernel.What I ruled out
For the MiniLM failure specifically: dynamic shapes (a static export is bit-identical), the padding and attention mask (a fully unmasked 254-token input fails the same, cosine 0.169), and the mean-pool/normalise tail (the pre-pool token output is already wrong). Exporting only
model.embeddingsreproduces it at cosine 0.33, before any encoder layer.For the isolated case: it is not the legacy texture-weight path.
embedding()inEmbedding.cppprepacks the weight askBufferfor these models, and the dispatched kernel is the non-legacyembedding_texture3d_*. I tried guarding the legacy branch onmax_texture2d_dim()and it changed nothing, confirming that branch is not involved.I did not find the exact mechanism inside
embedding_texture.glsl.load_weight_texel()computesembedding_idx * width(weight) + dim_idx, which does not overflow int32 at these sizes, so the 16384 boundary most likely comes from how the indices or the weight are addressed rather than from that multiply.Suggested direction
Two things seem worth separating:
force_fp16should not push a tensor toward texture storage without consulting texture limits, so oversized cases keep the working buffer kernel.Repro
Scripts are straightforward to reconstruct from the table above: export
nn.Embedding(V, 384)withVulkanPartitioner()for V on either side of 16384 and compare against the CPU reference.Versions
ExecuTorch 1.4.1 for the export, runtime at c27baa8. Device: Samsung Galaxy S26 Ultra, Snapdragon SM8850, Adreno 840, Android 16.