Struct FormulaRecognizer 

pub struct FormulaRecognizer {
    pub decoder_enabled: bool,
    /* private fields */
}

Riconosce formule matematiche in immagini crop → stringa LaTeX.

Fields

decoder_enabled: bool

Abilita il decoder autoregressive. Default false: quando disabilitato [recognize] restituisce latex = "" senza eseguire alcuna inferenza. Impostare a true solo quando si vuole produrre output LaTeX effettivo (il decoder è costoso: fino a 2560 step).

Implementations

impl FormulaRecognizer

pub fn from_paths( model_path: impl AsRef<Path>, tokenizer_path: Option<&Path>, ) -> Result<Self, OcrError>

Carica il modello ONNX e il tokenizer da path espliciti.

tokenizer_path: path a tokenizer.json. Se None usa un tokenizer fallback che emette token IDs anziché LaTeX — scarica il modello completo via ModelHub::ensure_single(PpStructureModel::FormulaRec).

pub fn recognize(&self, image: &RgbImage) -> Result<FormulaResult, OcrError>

Riconosce la formula nell’immagine crop → stringa LaTeX.

Se self.decoder_enabled == false (default) restituisce FormulaResult { latex: String::new(), score: 0.0 } senza alcuna inferenza. Il decoder autoregressive può impiegare fino a 2560 step (≈1.5 s/GPU, ≈3 s/CPU per formula complessa).

image deve essere il crop della regione formula (da LayoutAnalyzer con LayoutClass::DisplayFormula o InlineFormula).