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);