Struct EagerTraceCaptureGuard 

pub struct EagerTraceCaptureGuard { /* private fields */ }

Scope guard that keeps semantic-trace recording active for untracked intermediates.

Under active-edge semantics (issue #1665 Def 1), an operation whose inputs are all untracked produces no autograd nodes and drops its semantic trace. Inside this guard, such operations still record their semantic trace, so a later functional JVP/VJP can differentiate with respect to an untracked or detached leaf. This replaces the pre-Def-1 implicit recording.

Examples

use tenferro_ad::{EagerRuntime, EagerTensor, Tensor};
use tenferro_cpu::CpuBackend;

let ctx = EagerRuntime::with_cpu_backend(CpuBackend::new())?;
let x = EagerTensor::from_tensor_in(
    Tensor::from_vec_col_major(vec![2], vec![1.0_f64, 2.0]).unwrap(),
    ctx.clone(),
)?;
let (y, x) = {
    let _capture = ctx.capture_trace();
    let y = x.mul(&x)?;
    (y, x)
};
let seed = EagerTensor::from_tensor_in(
    Tensor::from_vec_col_major(vec![2], vec![1.0_f64, 1.0]).unwrap(),
    ctx.clone(),
)?;
let dx = ctx.vjp(&y, &x, &seed)?;
assert_eq!(dx.value()?.as_slice::<f64>().unwrap(), &[2.0, 4.0]);

Trait Implementations

impl Debug for EagerTraceCaptureGuard

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

Formats the value using the given formatter.

impl Drop for EagerTraceCaptureGuard

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.