Struct PhoneticStateSource 

pub struct PhoneticStateSource<D>
where
    D: Dictionary + Clone + Send + Sync,
    D::Node: Send + Sync,
    <D::Node as DictionaryNode>::Unit: Into<char> + TryFrom<char> + Copy + Send + Sync,
{ /* private fields */ }

State source for phonetic WFST composition.

This implements lling-llang’s StateSource trait using the phonetic product automaton (NFA × Levenshtein). States are computed on-demand as the composed transducer is traversed.

Product State Representation

Each WFST state represents a tuple:

• dictionary_node_id: Position in the dictionary trie
• product_state_id: ID of the phonetic product state (NFA × Levenshtein)

Example

use liblevenshtein::wfst::PhoneticStateSource;
use liblevenshtein::dictionary::dynamic_dawg_char::DynamicDawgChar;
use liblevenshtein::phonetic::nfa::compile;
use liblevenshtein::phonetic::regex::parse;
use lling_llang::prelude::*;

let dict = DynamicDawgChar::from_terms(vec!["phone", "fone", "phon"]);
let nfa = compile(&parse("(ph|f)one").unwrap()).unwrap();
let source = PhoneticStateSource::new(&dict, nfa, 2);

// Use with LazyWfstWrapper for composition
let lazy_wfst = LazyWfstWrapper::new(source);

Implementations

impl<D> PhoneticStateSource<D>

where D: Dictionary + Clone + Send + Sync, D::Node: Send + Sync, <D::Node as DictionaryNode>::Unit: Into<char> + TryFrom<char> + Copy + Send + Sync,

pub fn new(dictionary: &D, nfa: NFAChar, max_distance: u8) -> Self

Create a new phonetic state source.

Arguments

• dictionary: The dictionary to search
• nfa: The phonetic NFA pattern
• max_distance: Maximum edit distance for matches

pub fn with_phonetic_weight( dictionary: &D, nfa: NFAChar, max_distance: u8, phonetic_weight: f64, ) -> Self

Create a new phonetic state source with custom phonetic weight.

Arguments

• dictionary: The dictionary to search
• nfa: The phonetic NFA pattern
• max_distance: Maximum edit distance for matches
• phonetic_weight: Cost for phonetic transformations

pub fn max_distance(&self) -> u8

Get the maximum edit distance.

pub fn phonetic_weight(&self) -> f64

Get the phonetic weight.

Trait Implementations

impl<D> Clone for PhoneticStateSource<D>

where D: Dictionary + Clone + Send + Sync + Clone, D::Node: Send + Sync + Clone, <D::Node as DictionaryNode>::Unit: Into<char> + TryFrom<char> + Copy + Send + Sync,

fn clone(&self) -> PhoneticStateSource<D>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<D> StateSource<char, TropicalWeight> for PhoneticStateSource<D>

where D: Dictionary + Clone + Send + Sync, D::Node: Send + Sync, <D::Node as DictionaryNode>::Unit: Into<char> + TryFrom<char> + Copy + Send + Sync,

Available on crate feature phonetic-rules only.

fn compute_state(&self, state: StateId) -> LazyState<char, TropicalWeight>

Compute the state information for a given state ID.

fn start(&self) -> StateId

Get the start state ID.

fn num_states_hint(&self) -> Option<usize>

Get an upper bound on the number of states.