// See www.openfst.org for extensive documentation on this weighted // finite-state transducer library. #ifndef FST_SYMBOL_TABLE_OPS_H_ #define FST_SYMBOL_TABLE_OPS_H_ #include #include #include #include #include namespace fst { // Returns a minimal symbol table containing only symbols referenced by the // passed fst. Symbols preserve their original numbering, so fst does not // require relabeling. template SymbolTable *PruneSymbolTable(const Fst &fst, const SymbolTable &syms, bool input) { std::unordered_set seen; seen.insert(0); // Always keep epsilon. for (StateIterator> siter(fst); !siter.Done(); siter.Next()) { for (ArcIterator> aiter(fst, siter.Value()); !aiter.Done(); aiter.Next()) { const auto sym = (input) ? aiter.Value().ilabel : aiter.Value().olabel; seen.insert(sym); } } auto *pruned = new SymbolTable(syms.Name() + "_pruned"); for (SymbolTableIterator stiter(syms); !stiter.Done(); stiter.Next()) { const auto label = stiter.Value(); if (seen.count(label)) pruned->AddSymbol(stiter.Symbol(), label); } return pruned; } // Relabels a symbol table to make it a contiguous mapping. SymbolTable *CompactSymbolTable(const SymbolTable &syms); // Merges two SymbolTables, all symbols from left will be merged into right // with the same ids. Symbols in right that have conflicting ids with those // in left will be assigned to value assigned from the left SymbolTable. // The returned symbol table will never modify symbol assignments from the left // side, but may do so on the right. If right_relabel_output is non-NULL, it // will be assigned true if the symbols from the right table needed to be // reassigned. // A potential use case is to Compose two Fst's that have different symbol // tables. You can reconcile them in the following way: // Fst a, b; // bool relabel; // std::unique_ptr bnew(MergeSymbolTable(a.OutputSymbols(), // b.InputSymbols(), &relabel); // if (relabel) { // Relabel(b, bnew.get(), nullptr); // } // b.SetInputSymbols(bnew); SymbolTable *MergeSymbolTable(const SymbolTable &left, const SymbolTable &right, bool *right_relabel_output = nullptr); // Read the symbol table from any Fst::Read()able file, without loading the // corresponding Fst. Returns nullptr if the Fst does not contain a symbol // table or the symbol table cannot be read. SymbolTable *FstReadSymbols(const string &filename, bool input); // Adds a contiguous range of symbols to a symbol table using a simple prefix // for the string, returning false if the inserted symbol string clashes with // any currently present. bool AddAuxiliarySymbols(const string &prefix, int64 start_label, int64 nlabels, SymbolTable *syms); } // namespace fst #endif // FST_SYMBOL_TABLE_OPS_H_