Skip to main content

randomized_range_on_session

Function randomized_range_on_session 

Source
pub fn randomized_range_on_session<R: Rng + ?Sized>(
    session: &mut Session<'_>,
    t: &IdxTensor,
    left_inds: &[DynIndex],
    rank: usize,
    options: &RangeOptions,
    rng: &mut R,
) -> Result<IdxTensor, FactorizeError>
Expand description

Find a Gaussian range basis on a caller-held plain session.

Same rank, sketch and index contract as randomized_range. Numeric work stays on session; the returned Q is untracked host storage. Global QR defaults are ignored, and no eager runtime or nested session is entered.

§Errors

Returns FactorizeError for tracked/resident or unsupported operands, invalid rank/indices, size overflow, or a backend failure.

§Examples

use rand::SeedableRng;
use rand_chacha::ChaCha8Rng;
use tensor4all_core::{randomized_range_on_session, DynIndex, IdxTensor, RangeOptions};
use tensor4all_tensorbackend::{explicit::Session, CpuBackend};
let i = DynIndex::new_dyn(2);
let j = DynIndex::new_dyn(2);
let a = IdxTensor::from_dense(vec![i.clone(), j], vec![3., 0., 0., 0.])?;
let mut rng = ChaCha8Rng::seed_from_u64(11);
let mut backend = CpuBackend::with_threads(1)?;
let q = {
    let mut session = Session::new(backend.engine_mut());
    randomized_range_on_session(&mut session, &a, &[i], 1,
        &RangeOptions { oversampling: 0, power_iterations: 0 }, &mut rng)?
};
let values = q.to_vec::<f64>()?;
assert!((values[0].abs() - 1.).abs() < 1e-12 && values[1].abs() < 1e-12);