Struct RuntimeTrace 

pub struct RuntimeTrace {
    pub schema: String,
    pub run: RunMetadata,
    pub tensors: Vec<TensorObservation>,
    pub operations: Vec<OperationObservation>,
    pub gradients: Vec<GradientFact>,
    pub values: Vec<ValueObservation>,
    pub edge_timings: Vec<EdgeTimingObservation>,
}

Full runtime trace document (candle-graph/runtime/1 or /2).

Fields

schema: String

run: RunMetadata

tensors: Vec<TensorObservation>

operations: Vec<OperationObservation>

gradients: Vec<GradientFact>

values: Vec<ValueObservation>

edge_timings: Vec<EdgeTimingObservation>

Implementations

impl RuntimeTrace

pub fn normalize(&mut self)

Sort collections deterministically for stable diffs and audits.

pub fn validate(&self) -> Result<()>

Reject duplicate event ids and invalid gradient facts.

Contradictory tensor/gradient observations are not rejected here; they are reported by Self::audit as Unknown conflicts so importers never silently overwrite a winner.

pub fn finalize(self) -> Result<Self>

Normalize then validate; returns a ready-to-query trace.

pub fn check_identity( &self, expected: &ExpectedIdentity, ) -> Vec<IdentityMismatch>

Compare optional trace identity fields against an importer-supplied expectation.

Fields omitted on either side are skipped (backward compatible). When both sides supply a field and they differ, a mismatch is returned — callers must reject or report it as Unknown.

pub fn require_identity(&self, expected: &ExpectedIdentity) -> Result<()>

Reject when supplied identity disagrees with expected.

Compatible when either side omits a field.

pub fn tensors_by_static_id(&self, static_id: &str) -> Vec<&TensorObservation>

All tensor observations carrying static_id.

pub fn agreed_tensor(&self, static_id: &str) -> Option<&TensorObservation>

Agreed tensor observation for static_id, if any.

Returns None when there are no observations or when shape/dtype/device conflict — never silently picks a contradictory winner.

pub fn tensor_confidence(&self, static_id: &str) -> ObservationConfidence

Confidence for refining a static tensor from this trace.

pub fn gradients_for(&self, root: &str, key: &str) -> Vec<&GradientFact>

Gradient facts for a builder-root + parameter-key identity.

pub fn gradient(&self, root: &str, key: &str) -> Option<&GradientFact>

Agreed gradient fact for the identity, if any.

Returns None when facts are missing or contradictory (state/norm disagree). Does not silently overwrite by returning the first observation.

pub fn gradient_confidence( &self, root: &str, key: &str, ) -> ObservationConfidence

Confidence for refining a parameter gradient from this trace.

pub fn audit(&self) -> RuntimeAudit

Compact audit: gradient quality, tensor/gradient conflicts, optional identity mismatches.

pub fn audit_with_identity( &self, expected: Option<&ExpectedIdentity>, ) -> RuntimeAudit

Like Self::audit, also reporting identity mismatches when expected is supplied.

Trait Implementations

impl Clone for RuntimeTrace

fn clone(&self) -> RuntimeTrace

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RuntimeTrace

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for RuntimeTrace

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for RuntimeTrace

fn eq(&self, other: &RuntimeTrace) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for RuntimeTrace

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for RuntimeTrace