Struct HouseholderQr 

pub struct HouseholderQr<T> { /* private fields */ }

Opaque compact Householder QR state.

The packed reflector tensors remain private so callers cannot accidentally treat provider state as ordinary tensor values.

Examples

use tenferro_cpu::CpuBackend;
use tenferro_linalg::{QrOptions, TensorLinalgExt};
use tenferro_tensor::{BackendSessionHost, Tensor};

let a = Tensor::from_vec_col_major(
    vec![3, 2],
    vec![1.0_f64, 0.0, 1.0, 0.0, 1.0, 1.0],
)?;
let mut host = CpuBackend::new();
let r = host.with_backend_session(|session| {
    let qr = a.householder_qr(session)?;
    qr.r(QrOptions::default(), session)
})?;
assert_eq!(r.shape(), &[2, 2]);

Implementations

impl HouseholderQr<Tensor>

pub fn from_factors( q: &Tensor, r: &Tensor, session: &mut dyn BackendSession, ) -> Result<Self>

Construct compact state for the product of compatible factors Q * R.

Errors

Returns tenferro_tensor::Error::Validation for incompatible rank, shape, dtype, placement, or a non-trapezoidal R factor; tenferro_tensor::Error::Unsupported when the provider lacks compact QR; or tenferro_tensor::Error::BackendSource for provider failures.

pub fn append_columns( &self, block: &Tensor, session: &mut dyn BackendSession, ) -> Result<Self>

Append a column block without refactorizing existing columns.

Errors

Returns tenferro_tensor::Error::Validation for incompatible shape, dtype, placement, or malformed state; tenferro_tensor::Error::Unsupported when append is unavailable; or tenferro_tensor::Error::BackendSource for reflector or factorization failures.

pub fn r( &self, options: QrOptions, session: &mut dyn BackendSession, ) -> Result<Tensor>

Extract the thin upper-trapezoidal factor.

Errors

Returns tenferro_tensor::Error::Validation for malformed state, tenferro_tensor::Error::Unsupported for an unavailable provider path, or tenferro_tensor::Error::BackendSource for extraction failures.

pub fn q_columns( &self, columns: Range<usize>, options: QrOptions, session: &mut dyn BackendSession, ) -> Result<Tensor>

Materialize a contiguous range of thin-Q columns.

Errors

Returns tenferro_tensor::Error::Validation when the range is outside the thin-Q width or state metadata is malformed, tenferro_tensor::Error::Unsupported for an unavailable provider path, or tenferro_tensor::Error::BackendSource for execution failures.

impl HouseholderQr<EagerTensor>

pub fn from_factors(q: &EagerTensor, r: &EagerTensor) -> Result<Self>

Construct compact state from compatible eager factors.

Errors

Returns tenferro_ad::Error::Validation for known invalid metadata, tenferro_ad::Error::Extension for unsupported or provider failures, or tenferro_ad::Error::RuntimeState when eager execution is unavailable.

pub fn append_columns(&self, block: &EagerTensor) -> Result<Self>

Append an eager column block functionally.

Errors

Returns tenferro_ad::Error::Validation for known invalid metadata, tenferro_ad::Error::Extension for unsupported or provider failures, or tenferro_ad::Error::RuntimeState when eager execution is unavailable.

pub fn r(&self, options: QrOptions) -> Result<EagerTensor>

Extract eager R.

Errors

Returns tenferro_ad::Error::Validation for known invalid metadata, tenferro_ad::Error::Extension for unsupported or provider failures, or tenferro_ad::Error::RuntimeState when eager execution is unavailable.

pub fn q_columns( &self, columns: Range<usize>, options: QrOptions, ) -> Result<EagerTensor>

Materialize eager thin-Q columns.

Errors

Returns tenferro_ad::Error::Validation for known invalid metadata, tenferro_ad::Error::Extension for unsupported or provider failures, or tenferro_ad::Error::RuntimeState when eager execution is unavailable.

impl HouseholderQr<TracedTensor>

pub fn from_factors(q: &TracedTensor, r: &TracedTensor) -> Result<Self>

Construct compact state from compatible traced factors.

Errors

Returns tenferro_runtime::Error::Validation for known invalid metadata or tenferro_runtime::Error::Extension for unsupported operation state.

Deferred errors

Symbolic shape constraints and backend provider failures may be reported during compile or execution.

pub fn append_columns(&self, block: &TracedTensor) -> Result<Self>

Append a traced column block functionally.

Errors

Returns tenferro_runtime::Error::Validation for known invalid metadata or tenferro_runtime::Error::Extension for unsupported operation state.

Deferred errors

Symbolic shape constraints and backend provider failures may be reported during compile or execution.

pub fn r(&self, options: QrOptions) -> Result<TracedTensor>

Extract traced R.

Errors

Returns tenferro_runtime::Error::Validation for known invalid metadata or tenferro_runtime::Error::Extension for unsupported operation state.

Deferred errors

Symbolic shape constraints and backend provider failures may be reported during compile or execution.

pub fn q_columns( &self, columns: Range<usize>, options: QrOptions, ) -> Result<TracedTensor>

Materialize traced thin-Q columns.

Errors

Returns tenferro_runtime::Error::Validation for known invalid metadata or tenferro_runtime::Error::Extension for unsupported operation state.

Deferred errors

Symbolic shape constraints and backend provider failures may be reported during compile or execution.

Trait Implementations

impl<T: Clone> Clone for HouseholderQr<T>

fn clone(&self) -> HouseholderQr<T>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<T> Debug for HouseholderQr<T>

fn fmt(&self, formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.