Struct UpsampleNearest2dForward 

pub struct UpsampleNearest2dForward<D: Num> {
    pub name: &'static str,
    pub id: String,
    pub scale_h: i32,
    pub scale_w: i32,
    pub block_ow: i32,
    pub kernel_source: String,
    pub entry_point_source: String,
    pub source: String,
    /* private fields */
}

Nearest-neighbour 2-D upsample forward pass — NCHW layout.

Grid: one flat pid per (b, c, oh, ow-tile): pid = ((b * C + c) * OH + oh) * num_ow_tiles + ow_tile

Each CTA writes a BLOCK_OW-wide strip of output columns by reading from the nearest input position via floor division: ih = oh / SCALE_H, iw = ow / SCALE_W

Output shape: [B, C, OH=H*SCALE_H, OW=W*SCALE_W].

Fields

name: &'static str

The kernel function’s name (e.g. "flash_attention2_forward").

id: String

Unique kernel identifier: fn_name + dtype(s) + const values joined by “__”.

scale_h: i32

Compile-time kernel constant, from the annotated fn’s const generics.

scale_w: i32

Compile-time kernel constant, from the annotated fn’s const generics.

block_ow: i32

Compile-time kernel constant, from the annotated fn’s const generics.

kernel_source: String

The original kernel function source.

entry_point_source: String

The Rust source of the generated C-ABI entry-point wrapper function.

source: String

Combined source (kernel_source + "\n\n" + entry_point_source); used by the Kernel trait.

Implementations

impl<D: Num> UpsampleNearest2dForward<D>

pub fn new(scale_h: i32, scale_w: i32, block_ow: i32) -> Self

Constructs a new kernel instance for these compile-time parameters.

Trait Implementations

impl<D: Num> Kernel for UpsampleNearest2dForward<D>

type Args<'__a> = (*mut D, *mut D, i32, i32, i32, i32, i32, i32)

This kernel’s launch-argument tuple type.

fn id(&self) -> String

A content hash of this kernel’s source, used as a cache key.

fn name(&self) -> &str

This kernel’s name.

fn source(&self) -> &str

This kernel’s full source (DSL + kernel body + entry point wrapper).

fn kernel_source(&self) -> &str

This kernel’s body source, without the entry-point wrapper.

fn entry_point_source(&self) -> &str

Returns the Rust source of the generated C-ABI entry-point wrapper function.

fn entry_point_name(&self) -> String

Returns the PTX symbol name for this kernel: "{name}_entry_point".

impl<D: Num + Send + Sync + 'static> RuntimeOp for UpsampleNearest2dForward<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: dy, dx, B, C, H, W, OH, OW

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

Grid over input spatial positions: pid = ((b * C + c) * H + ih) * num_iw_tiles + iw_tile

fn n_activation_inputs(&self) -> usize

Number of activation tensors taken from predecessor DAG nodes.

fn param_shapes( &self, _input_shapes: &[&[usize]], _output_shape: &[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.