Struct DivergenceSummary 

pub struct DivergenceSummary {
    pub pattern_entropy_delta: Option<f64>,
    pub convention_drift_delta: Option<f64>,
    pub coupling_delta: Option<f64>,
    pub community_count_delta: Option<i64>,
    pub boundary_violation_delta: Option<i64>,
    pub pattern_entropy_per_category_delta: Option<BTreeMap<String, f64>>,
    pub convention_drift_per_category_delta: Option<BTreeMap<String, f64>>,
}

Per-dimension divergence between two consecutive Snapshots.

All fields are Option<_>. None means the dimension could not be compared (e.g. one snapshot lacked the prerequisite data). Some(0) or Some(0.0) means the dimension was compared and no change was observed. These two states are intentionally distinct (Rule 14 / KDD-9).

Null fields are serialised as explicit JSON null — skip_serializing_if is intentionally absent — so that CI consumers can distinguish “not computed” from “zero change.”

Examples

use sdivi_snapshot::delta::null_summary;

let s = null_summary();
assert!(s.pattern_entropy_delta.is_none());
assert!(s.convention_drift_delta.is_none());
assert!(s.pattern_entropy_per_category_delta.is_none());
assert!(s.convention_drift_per_category_delta.is_none());

Fields

pattern_entropy_delta: Option<f64>

Change in total normalized pattern entropy (curr − prev).

convention_drift_delta: Option<f64>

Change in convention_drift (curr − prev).

None when either snapshot has no catalog entries.

coupling_delta: Option<f64>

Change in graph density (curr − prev).

community_count_delta: Option<i64>

Change in community count (curr − prev), as a signed integer.

boundary_violation_delta: Option<i64>

Change in boundary violation count (curr − prev).

None when either snapshot is missing intent_divergence.

pattern_entropy_per_category_delta: Option<BTreeMap<String, f64>>

Per-category Shannon entropy delta (curr − prev), keyed by category name.

None on the first-snapshot path (KDD-9). Map keys are the union of categories in prev and curr; missing-side values are treated as 0.0.

convention_drift_per_category_delta: Option<BTreeMap<String, f64>>

Per-category convention-drift delta (curr − prev), keyed by category name.

None on the first-snapshot path (KDD-9). Same union-of-keys semantics as pattern_entropy_per_category_delta.

Trait Implementations

impl Clone for DivergenceSummary

fn clone(&self) -> DivergenceSummary

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DivergenceSummary

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for DivergenceSummary

fn deserialize<__D>( __deserializer: __D, ) -> Result<DivergenceSummary, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for DivergenceSummary

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for DivergenceSummary

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for DivergenceSummary