PaddleSpeech/speechx/tools/fstbin/fstdeterminizestar.cc

// fstbin/fstdeterminizestar.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 "fst/fstlib.h"
#include "fstext/determinize-star.h"
#include "fstext/fstext-utils.h"
#include "fstext/kaldi-fst-io.h"
#include "util/parse-options.h"
#if !defined(_MSC_VER) && !defined(__APPLE__)
#include <signal.h>  // Comment this line and the call to signal below if
// it causes compilation problems.  It is only to enable a debugging procedure
// when determinization does not terminate.  We are disabling this code if
// compiling on Windows because signal.h is not available there, and on
// MacOS due to a problem with <signal.h> in the initial release of Sierra.
#endif

/* some test  examples:
 ( echo "0 0 0 0"; echo "0 0" ) | fstcompile | fstdeterminizestar | fstprint
 ( echo "0 0 1 0"; echo "0 0" ) | fstcompile | fstdeterminizestar | fstprint
 ( echo "0 0 1 0"; echo "0 1 1 0"; echo "0 0" ) | fstcompile |
 fstdeterminizestar | fstprint # this last one fails [correctly]: ( echo "0 0 0
 1"; echo "0 0" ) | fstcompile | fstdeterminizestar | fstprint

  cd ~/tmpdir
  while true; do
    fstrand > 1.fst
    fstpredeterminize out.lst 1.fst | fstdeterminizestar | fstrmsymbols out.lst
 > 2.fst fstequivalent --random=true 1.fst 2.fst || echo "Test failed" echo -n
 "." done

 Test of debugging [with non-determinizable input]:
 ( echo " 0 0 1 0 1.0"; echo "0 1 1 0"; echo "1 1 1 0 0"; echo "0 2 2 0"; echo
 "2"; echo "1" ) | fstcompile | fstdeterminizestar kill -SIGUSR1 [the process-id
 of fstdeterminizestar] # prints out a bunch of debugging output showing the
 mess it got itself into.
*/

bool debug_location = false;
void signal_handler(int) { debug_location = true; }

int main(int argc, char *argv[]) {
  try {
    using namespace kaldi;  // NOLINT
    using namespace fst;  // NOLINT
    using kaldi::int32;

    const char *usage =
        "Removes epsilons and determinizes in one step\n"
        "\n"
        "Usage:  fstdeterminizestar [in.fst [out.fst] ]\n"
        "\n"
        "See also: fstdeterminizelog, lattice-determinize\n";

    float delta = kDelta;
    int max_states = -1;
    bool use_log = false;
    ParseOptions po(usage);
    po.Register("use-log", &use_log, "Determinize in log semiring.");
    po.Register("delta", &delta,
                "Delta value used to determine equivalence of weights.");
    po.Register(
        "max-states", &max_states,
        "Maximum number of states in determinized FST before it will abort.");
    po.Read(argc, argv);

    if (po.NumArgs() > 2) {
      po.PrintUsage();
      exit(1);
    }

    std::string fst_in_str = po.GetOptArg(1), fst_out_str = po.GetOptArg(2);

    // This enables us to get traceback info from determinization that is
    // not seeming to terminate.
#if !defined(_MSC_VER) && !defined(__APPLE__)
    signal(SIGUSR1, signal_handler);
#endif
    // Normal case: just files.
    VectorFst<StdArc> *fst = ReadFstKaldi(fst_in_str);

    ArcSort(fst, ILabelCompare<StdArc>());  // improves speed.
    if (use_log) {
      DeterminizeStarInLog(fst, delta, &debug_location, max_states);
    } else {
      VectorFst<StdArc> det_fst;
      DeterminizeStar(*fst, &det_fst, delta, &debug_location, max_states);
      *fst = det_fst;  // will do shallow copy and then det_fst goes
      // out of scope anyway.
    }
    WriteFstKaldi(*fst, fst_out_str);
    delete fst;
    return 0;
  } catch (const std::exception &e) {
    std::cerr << e.what();
    return -1;
  }
}