lattice-to-phone-lattice.cc

Go to the documentation of this file.

// latbin/lattice-to-phone-lattice.cc

// Copyright 2009-2011  Microsoft Corporation

// See ../../COPYING for clarification regarding multiple authors
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//  http://www.apache.org/licenses/LICENSE-2.0
//
// THIS CODE IS PROVIDED *AS IS* BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
// KIND, EITHER EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION ANY IMPLIED
// WARRANTIES OR CONDITIONS OF TITLE, FITNESS FOR A PARTICULAR PURPOSE,
// MERCHANTABLITY OR NON-INFRINGEMENT.
// See the Apache 2 License for the specific language governing permissions and
// limitations under the License.


#include "base/kaldi-common.h"
#include "util/common-utils.h"
#include "fstext/fstext-lib.h"
#include "lat/kaldi-lattice.h"
#include "lat/lattice-functions.h"
#include "hmm/transition-model.h"

int main(int argc, char *argv[]) {
  try {
    using namespace kaldi;
    typedef kaldi::int32 int32;
    typedef kaldi::int64 int64;
    using fst::SymbolTable;
    using fst::VectorFst;
    using fst::StdArc;

    const char *usage =
        "Convert the words or transition-ids into phones, which are worked out\n"
        "from the transition-ids.  If --replace-words=true (true by default),\n"
        "replaces the words with phones, otherwise replaces the transition-ids.\n"
        "If --replace-words=false, it will preserve the alignment of transition-ids/phones\n"
        "to words, so that if you do \n"
        "lattice-align-words | lattice-to-phone-lattice --replace-words=false,\n"
        "you can get the phones corresponding to each word in the lattice.\n"
        "\n"
        "Usage: lattice-to-phone-lattice [options] model lattice-rspecifier lattice-wspecifier\n"
        " e.g.: lattice-to-phone-lattice 1.mdl ark:1.lats ark:phones.lats\n"
        "See also: lattice-align-words, lattice-align-phones\n";
      
    ParseOptions po(usage);
    bool replace_words = true;
    po.Register("replace-words", &replace_words,
                "If true, replace words with phones; otherwise replace "
                "transition-ids with phones.");
    
    po.Read(argc, argv);

    if (po.NumArgs() != 3) {
      po.PrintUsage();
      exit(1);
    }

    std::string model_rxfilename = po.GetArg(1),
        lats_rspecifier = po.GetArg(2),
        lats_wspecifier = po.GetArg(3);
    
    int32 n_done = 0;

    TransitionModel trans_model;
    
    ReadKaldiObject(model_rxfilename, &trans_model);
    
    SequentialCompactLatticeReader clat_reader(lats_rspecifier);
    CompactLatticeWriter clat_writer(lats_wspecifier); // write as compact.
    for (; !clat_reader.Done(); clat_reader.Next()) {
      if (replace_words) {
        Lattice lat;
        ConvertLattice(clat_reader.Value(), &lat);
        ConvertLatticeToPhones(trans_model, &lat); // this function replaces words -> phones
        CompactLattice clat;
        ConvertLattice(lat, &clat);
        clat_writer.Write(clat_reader.Key(), clat);
      } else { // replace transition-ids with phones.
        CompactLattice clat(clat_reader.Value());
        ConvertCompactLatticeToPhones(trans_model, &clat);
        // this function replaces transition-ids with phones.  We do it in the
        // CompactLattice form, in order to preserve the alignment of
        // transition-id sequences/phones-sequences to words [e.g. if you just
        // did lattice-align-words].
        clat_writer.Write(clat_reader.Key(), clat);
      }
      n_done++;
    }
    KALDI_LOG << "Done converting " << n_done << " lattices.";
    return (n_done != 0 ? 0 : 1);
  } catch(const std::exception &e) {
    std::cerr << e.what();
    return -1;
  }
}