Struct GpuBackend 

pub struct GpuBackend { /* private fields */ }

GPU backend holding a device, queue, and the pre-built compute pipelines.

Implementations

impl GpuBackend

pub fn try_init() -> Result<Self, GpuError>

Probe for a GPU and build the pipelines. Blocks on async init.

pub fn adapter_name(&self) -> &str

Human-readable adapter name (e.g. “NVIDIA GeForce RTX 4080”).

Examples found in repository

examples/benchmark_backends.rs (line 31)

fn main() {
    let exec = executor();
    let ch = Channels::standard(32);
    let has_gpu = exec.gpu().is_some();

    println!("== adele-ring :: backend benchmark (32 channels) ==");
    println!(
        "GPU available: {}\n",
        if has_gpu {
            exec.gpu().map(|g| g.adapter_name().to_string()).unwrap_or_default()
        } else {
            "no (CPU-only)".to_string()
        }
    );

    println!("{:>10} | {:>14} | {:>12} | winner", "batch_size", "cpu_rayon_us", "gpu_us");
    println!("{}", "-".repeat(56));

    for &size in &[1usize, 16, 128, 1024, 16_384, 65_536] {
        let a = RnsBatch::from_rns_ints(&vec![RnsInt::from_i64(123, ch.clone()); size]);
        let b = RnsBatch::from_rns_ints(&vec![RnsInt::from_i64(456, ch.clone()); size]);

        let iters = if size <= 128 { 2000 } else { 100 };
        let cpu_us = time_backend(|| exec.cpu().batch_rns_add(&a, &b), iters);

        let (gpu_str, winner) = if let Some(gpu) = exec.gpu() {
            let gpu_us = time_backend(|| gpu.batch_rns_add(&a, &b), iters);
            let w = if cpu_us <= gpu_us { "CPU" } else { "GPU" };
            (format!("{gpu_us:>12.2}"), w)
        } else {
            ("         n/a".to_string(), "CPU")
        };

        println!("{size:>10} | {cpu_us:>14.2} | {gpu_str} | {winner}");
    }

    println!(
        "\nNote: CPU wins for small batches (GPU upload/dispatch overhead ~100us);\n\
         GPU pulls ahead once the batch is large enough to amortize that fixed cost."
    );
}

Trait Implementations

impl ArithmeticBackend for GpuBackend

fn batch_rns_add(&self, a: &RnsBatch, b: &RnsBatch) -> RnsBatch

Elementwise add: result[b][c] = (a[b][c] + b[b][c]) % m[c].

fn batch_rns_mul(&self, a: &RnsBatch, b: &RnsBatch) -> RnsBatch

Elementwise multiply: result[b][c] = (a[b][c] * b[b][c]) % m[c].

fn batch_crt(&self, batch: &RnsBatch) -> Vec<BigUint>

CRT-reconstruct every item in the batch.

fn name(&self) -> &'static str

Backend name for diagnostics.