Struct TransitionMatrix 

pub struct TransitionMatrix {
    pub cluster_ids: Vec<ClusterId>,
    pub probabilities: Vec<Vec<f32>>,
    pub observations: Vec<Vec<u32>>,
    /* private fields */
}

Transition matrix for Markov chain analysis.

Represents the probabilities of transitioning from one cluster to another.

Fields

cluster_ids: Vec<ClusterId>

Ordered list of cluster IDs (defines row/column indices).

probabilities: Vec<Vec<f32>>

Transition probabilities (row = source, column = target). Values are probabilities (0.0 to 1.0, rows sum to 1.0).

observations: Vec<Vec<u32>>

Raw observation counts (row = source, column = target).

Implementations

impl TransitionMatrix

pub fn new(cluster_ids: Vec<ClusterId>) -> Self

Create a new transition matrix for the given clusters.

pub fn size(&self) -> usize

Get the number of clusters (states) in the matrix.

pub fn index_of(&self, cluster_id: &ClusterId) -> Option<usize>

Get the index for a cluster ID.

pub fn record_transition(&mut self, from: &ClusterId, to: &ClusterId)

Record an observed transition.

pub fn compute_probabilities(&mut self)

Compute probabilities from observation counts.

pub fn probability(&self, from: &ClusterId, to: &ClusterId) -> Option<f32>

Get the transition probability from one cluster to another.

pub fn observation_count(&self, from: &ClusterId, to: &ClusterId) -> Option<u32>

Get the observation count for a transition.

pub fn non_zero_transitions(&self) -> Vec<(ClusterId, ClusterId, f32)>

Get all non-zero transitions as (from, to, probability) tuples.

pub fn stationary_distribution(&self) -> Option<Vec<f32>>

Get the stationary distribution (eigenvector of eigenvalue 1). Returns None if the matrix is not ergodic.

pub fn rebuild_index_map(&mut self)

Rebuild the index map (needed after deserialization).

Trait Implementations

impl Clone for TransitionMatrix

fn clone(&self) -> TransitionMatrix

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TransitionMatrix

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for TransitionMatrix

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for TransitionMatrix

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

where __S: Serializer,

Serialize this value into the given Serde serializer.