Struct Chain 

pub struct Chain { /* private fields */ }

A Markov chain representing processes that have both beginnings and ends.

The chain is represented as a HashMap where keys are states (tuples of words) and values are HashMaps of possible next words with their frequencies.

Implementations

impl Chain

pub fn new(corpus: &[Vec<String>], state_size: usize) -> Self

Create a new Markov chain from a corpus

Arguments

• corpus - A list of runs, where each run is a sequence of items (e.g., words in a sentence)
• state_size - The number of items used to represent the chain’s state

pub fn compile(&self) -> Self

Compile the chain for faster generation

This converts the frequency dictionaries into cumulative frequency lists for more efficient random selection.

pub fn gen(&self, init_state: Option<&[String]>) -> ChainGenerator<'_>

Generate items from the chain

Returns an iterator that yields successive items until the END state is reached.

pub fn walk(&self, init_state: Option<&[String]>) -> Vec<String>

Walk the chain and return a complete sequence

Returns a vector representing a single run of the Markov model.

pub fn state_size(&self) -> usize

Get the state size

pub fn model(&self) -> &FxHashMap<Vec<String>, FxHashMap<String, usize>>

Get the model (for inspection or combination)

pub fn is_compiled(&self) -> bool

Check if the chain is compiled

pub fn to_json(&self) -> Result<String>

Serialize the chain to JSON

pub fn from_json(json_str: &str) -> Result<Self>

Deserialize a chain from JSON

pub fn from_combined_model( model: FxHashMap<Vec<String>, FxHashMap<String, usize>>, state_size: usize, ) -> Self

Create a chain from a pre-built model (used for combining models)

Trait Implementations

impl Clone for Chain

fn clone(&self) -> Chain

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Chain

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Chain

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Chain

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

where __S: Serializer,

Serialize this value into the given Serde serializer.