Struct Gradients 

pub struct Gradients { /* private fields */ }

Tape::backward が返す勾配の入れ物。Var 単位で get() から 引ける（docs/public-api-design.md §3.1）。

ノードごとの勾配を Option で保持し、loss から到達しないノードは None のまま残す（PoC-v2-2 の「None を zeros 埋め」はしない設計。 未到達ノードの勾配を暗黙に 0 とみなすと、呼び出し側が「そもそも loss に寄与していない」ことと「寄与はあるが偶然 0」を区別できなく なるため、get() の戻り値を Option のまま伝える）。

Implementations

impl Gradients

pub fn get(&self, var: &Var<'_>) -> Result<Option<&Tensor<f32>>, AutodiffError>

var に対応する勾配を取得する。var が別 Tape に属する場合、 または var が属する Tape が本 Gradients 計算後に reset() された場合（#1048。同一 TapeId のまま世代だけ進んだ場合を含む） は Err(TapeMismatch)（Var::matmul 等のクロステープ検査 〈var.rs〉と同じ契約を世代不一致にも拡張）。backward 実行後に 同一世代内で追加された Var（node_id() が grads.len() 以上） や、loss から到達しない Var は Ok(None)（境界外アクセスで panic しない。.claude/rules/coding-rust.md 本番経路 panic 禁止方針）。

Trait Implementations

impl Debug for Gradients

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

Formats the value using the given formatter.

impl Drop for Gradients

host arena（#2104・opt-in 既定 OFF）へ勾配バッファを返す回収点。学習ループでは Tape より先に Gradients が drop されるため、ここで回収しないと勾配バッファを 取りこぼす。無効時は何もしない。

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.