rustfst 1.3.0

Library for constructing, combining, optimizing, and searching weighted finite-state transducers (FSTs).
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51

use crate::prelude::Fst;
use crate::{Semiring, StateId};
use anyhow::Result;
use rand::Rng;
use rand::SeedableRng;
use rand_chacha::ChaCha8Rng;
use std::fmt::Debug;

/// `TrSelector` implementors are used to select a random transition given an Fst
/// state `s`, returning a number `N` such that 0 <= `N` <= `fst.num_trs(s)`. If `N` is
/// `fst.num_trs(s)`, then the final weight is selected; otherwise the `N`-th transition is
/// selected. It is assumed these are not applied to any state which is neither
/// final nor has any arcs leaving it.
pub trait TrSelector: Debug {
    fn select_tr<W: Semiring, F: Fst<W>>(&mut self, fst: &F, state: StateId) -> Result<usize>;
}

/// Randomly selects a transition using the uniform distribution.
#[derive(Debug, Clone)]
pub struct UniformTrSelector {
    rng: ChaCha8Rng,
}

impl Default for UniformTrSelector {
    fn default() -> Self {
        Self::new()
    }
}

impl UniformTrSelector {
    pub fn new() -> Self {
        Self {
            rng: ChaCha8Rng::from_os_rng(),
        }
    }
    pub fn from_seed(seed: u64) -> Self {
        Self {
            rng: ChaCha8Rng::seed_from_u64(seed),
        }
    }
}

impl TrSelector for UniformTrSelector {
    fn select_tr<W: Semiring, F: Fst<W>>(&mut self, fst: &F, state: StateId) -> Result<usize> {
        let mut n = fst.num_trs(state)?;
        if fst.is_final(state)? {
            n += 1;
        }
        Ok(self.rng.random_range(0..=n - 1))
    }
}