ai.onnx.Where

ai.onnx · standard ONNX operator · ONNX opset ≥ 16

Description

Selects elements from X or Y according to a boolean condition, following NumPy-style multidirectional broadcasting. Where condition is true, the output takes the value from X; otherwise it takes the value from Y.

See the ONNX Where spec for the reference semantics.

Inputs

Outputs

Type constraints

Files

• metadata.json — kernel metadata (id, digests, per-variant templates, provenance)
• manifest.json — the op contract (source of truth)
• test.json — correctness cases
• bench.json — benchmark + tuning cases
• where-broadcast.wgsl.jinja
• where-vec4.wgsl.jinja

Use with @huggingface/kernels

npm install --save-exact @huggingface/kernels@0.0.1-preview.2

Required output shapes and logical data types are inferred from the supplied inputs and attributes; result tensors are allocated automatically.

The version: 1 option selects the published kernel contract; it is independent of any operator opset, contrib since_version, or model version. It follows the v1 branch as fixes land. To pin exact artifact bytes, pass a 40-character commit revision instead of version.

Replace each *Data placeholder with a typed array containing the corresponding input data.

import { getKernel } from "@huggingface/kernels";

const kernel = await getKernel("webgpu-kernels/ai.onnx.Where", { version: 1 });
const { output } = await kernel({
  condition: { data: conditionData, shape: [] },
  x: { data: xData, shape: [] },
  y: { data: yData, shape: [] },
});