Struct PsaPackQkvRuntimeOp 

pub struct PsaPackQkvRuntimeOp<D: Float + Send + Sync + 'static> { /* private fields */ }

Runtime dispatch for the PSA QKV-packing kernel (forward + backward).

Implementations

impl<D: Float + Send + Sync + 'static> PsaPackQkvRuntimeOp<D>

pub fn new(key_dim: i32, num_heads: usize) -> Self

Builds forward/backward kernels for the given key dimension and head count.

pub fn kernel_name(&self) -> &str

The forward kernel’s function name.

pub fn forward_source(&self) -> &str

The forward kernel’s generated source.

pub fn backward_source(&self) -> &str

The backward kernel’s generated source.

Trait Implementations

impl<D: Float + Send + Sync + 'static> RuntimeOp for PsaPackQkvRuntimeOp<D>

fn pack_backward_args( &self, inputs: &[(RawPtr, &[usize])], _params: &[RawPtr], _output: RawPtr, output_shape: &[usize], grad_output: RawPtr, _grad_output_row_stride: i32, grad_inputs: &[RawPtr], _grad_params: &[RawPtr], visitor: &mut dyn ArgVisitor, )

kernel args: d_packed, d_qkv, qkv_h, H, W, B, num_heads

fn backward_grid( &self, _input_shapes: &[&[usize]], output_shape: &[usize], ) -> [u32; 3]

Grid = [B * 4 * num_heads * N, 1, 1] — same layout as the forward pass.

fn n_activation_inputs(&self) -> usize

Number of activation tensors taken from predecessor DAG nodes.

fn param_shapes(&self, _: &[&[usize]], _: &[usize]) -> Vec<Vec<usize>>

Shapes of additional parameter buffers (weights, biases) needed by this op. Called at LoadedModel::load() time to pre-allocate device buffers. input_shapes / output_shape are concrete (batch dim resolved).

fn pack_args( &self, inputs: &[(RawPtr, &[usize])], _params: &[RawPtr], output: RawPtr, _output_shape: &[usize], _output_row_stride: i32, visitor: &mut dyn ArgVisitor, )

Pack all kernel arguments into visitor in the correct order.

fn block(&self) -> [u32; 3]

Threads-per-CTA for this kernel (x, y, z).

fn grid(&self, output_shape: &[usize]) -> [u32; 3]

Number of CTAs to launch (x, y, z), given the concrete output shape.

fn has_backward(&self) -> bool

Returns true if this op has a backward (gradient) kernel.

fn backward_block(&self) -> [u32; 3]

Threads-per-CTA for the backward kernel.

fn param_names(&self) -> &'static [&'static str]

Names of parameter slots returned by [param_shapes], in the same order. Used as the suffix in the dotted key {node_name}.{slot_name}. Return an empty slice for ops that have no named parameters.

fn forward_output_row_stride(&self, output_shape: &[usize]) -> usize

Returns the required row stride (in elements) for the output buffer of this op’s forward kernel. The default is the natural row-major stride (output_shape[-1]). Kernels using TMA must round up to satisfy the 16-byte alignment constraint (e.g. 4 elements for f32).

fn param_init_data(&self, _param_idx: usize) -> Option<Vec<u8>>

Returns raw (little-endian) bytes to pre-populate parameter slot param_idx immediately after device buffer allocation. Return None to leave the slot zero-initialised (the default for trained parameters). Byte count must equal param_shapes()[param_idx].iter().product() * dtype_bytes.

fn compute_concrete_output_shape( &self, _input_shapes: &[&[usize]], resolved: &[usize], ) -> Vec<usize>

Override to compute the true concrete output shape from concrete input shapes.

fn n_launches(&self) -> usize

Number of sequential kernel launches this op requires.

fn pack_args_for_launch( &self, launch_idx: usize, inputs: &[(*mut c_void, &[usize])], params: &[*mut c_void], output: *mut c_void, output_shape: &[usize], output_row_stride: i32, visitor: &mut dyn ArgVisitor, )

Pack kernel arguments for launch i (0-indexed).

fn grid_for_launch( &self, launch_idx: usize, input_shapes: &[&[usize]], output_shape: &[usize], ) -> [u32; 3]

Grid for launch i. Receives concrete input shapes so that per-chunk grids can be computed without storing them in the op.

fn backward_grad_output_row_stride(&self, output_shape: &[usize]) -> usize

Returns the required row stride (in elements) for the grad_output buffer passed to pack_backward_args. The default is the natural row-major stride (output_shape[-1]). Kernels using TMA must round up to satisfy the 16-byte alignment constraint (e.g. 4 elements for f32).

fn n_backward_launches(&self) -> usize

Number of sequential kernel launches for the backward pass.

fn pack_backward_args_for_launch( &self, launch_idx: usize, inputs: &[(*mut c_void, &[usize])], params: &[*mut c_void], output: *mut c_void, output_shape: &[usize], grad_output: *mut c_void, grad_output_row_stride: i32, grad_inputs: &[*mut c_void], grad_params: &[*mut c_void], visitor: &mut dyn ArgVisitor, )

Pack backward kernel arguments for launch i (0-indexed).

fn backward_grid_for_launch( &self, launch_idx: usize, input_shapes: &[&[usize]], output_shape: &[usize], ) -> [u32; 3]

Grid for backward launch i.