Struct PhasePortrait 

pub struct PhasePortrait { /* private fields */ }

SSM state trajectory visualizer with phase portrait, PCA projection, and attractor analysis.

Implementations

impl PhasePortrait

pub fn new(dim: usize, capacity: usize) -> Self

Create a new phase portrait buffer of the given dim, pre-allocated for capacity steps.

pub fn record(&mut self, state: &Array1<f32>) -> ModelResult<()>

Record a hidden state vector.

pub fn pca_projection(&self) -> ModelResult<Array2<f32>>

Project trajectory onto its top-2 principal components.

Uses pure-Rust power iteration with deflation. Returns (T, 2) matrix.

pub fn divergence_estimate(&self) -> ModelResult<f32>

Lyapunov-like divergence estimate: average log ratio of consecutive distances.

Returns the mean of log(d(t+1) / d(t)) where d(t) = ||state(t+1) - state(t)||.

pub fn fixed_points(&self, tolerance: f32) -> Vec<Array1<f32>>

Detect fixed points: states that recur within tolerance (L2).

Returns one representative state per cluster.

pub fn periodicity_score(&self) -> ModelResult<f32>

Estimate periodicity via the peak autocorrelation of the trajectory’s norm sequence (excluding lag-0).

Returns a value in [0, 1] where higher means more periodic.

Trait Implementations

impl Clone for PhasePortrait

fn clone(&self) -> PhasePortrait

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PhasePortrait

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

Formats the value using the given formatter.