spot/spot/taalgos/tgba2ta.hh

// -*- coding: utf-8 -*-
// Copyright (C) by the Spot authors, see the AUTHORS file for details.
//
// This file is part of Spot, a model checking library.
//
// Spot is free software; you can redistribute it and/or modify it
// under the terms of the GNU General Public License as published by
// the Free Software Foundation; either version 3 of the License, or
// (at your option) any later version.
//
// Spot is distributed in the hope that it will be useful, but WITHOUT
// ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
// or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public
// License for more details.
//
// You should have received a copy of the GNU General Public License
// along with this program.  If not, see <http://www.gnu.org/licenses/>.

#pragma once

#include <spot/twa/twa.hh>
#include <spot/ta/taexplicit.hh>
#include <spot/ta/tgtaexplicit.hh>

namespace spot
{
  /// \ingroup tgba_ta
  /// \brief Build a spot::ta_explicit* (TA) from an LTL formula.
  ///
  /// This is based on \cite geldenhuys.06.spin .
  ///
  /// \param tgba_to_convert The TGBA automaton to convert into a TA automaton
  ///
  /// \param atomic_propositions_set The set of atomic propositions used in the
  /// input TGBA \a tgba_to_convert
  ///
  /// \param degeneralized When false, the returned automaton is a generalized
  /// form of TA, called GTA (Generalized Testing Automaton).
  /// Like TGBA, GTA use Generalized Büchi acceptance
  /// conditions instead of Buchi-accepting states: there are several acceptance
  /// sets (of transitions), and a path is accepted if it traverses
  /// at least one transition of each set infinitely often or if it contains a
  /// livelock-accepting cycle (like a TA). The spot emptiness check algorithm
  /// for TA (spot::ta_check::check) can also be used to check GTA.
  ///
  /// \param artificial_initial_state_mode When set, the algorithm will build
  /// a TA automaton with a unique initial state.  This
  /// artificial initial state have one transition to each real initial state,
  /// and this transition is labeled by the corresponding initial condition.
  /// (see spot::ta::get_artificial_initial_state())
  ///
  /// \param single_pass_emptiness_check When set, the product between the
  /// returned automaton and a kripke structure requires only the fist pass of
  /// the emptiness check algorithm (see the parameter \c disable_second_pass
  /// of the method spot::ta_check::check)
  ///
  ///
  /// \param artificial_livelock_state_mode When set, the returned TA automaton
  ///  is a STA (Single-pass Testing Automata): a STA automaton is a TA
  /// where: for every livelock-accepting state s, if s is not also a
  /// Buchi-accepting state, then s has no successors. A STA product requires
  /// only one-pass emptiness check algorithm (see spot::ta_check::check)
  ///
  /// \param no_livelock when set, this disable the replacement of
  /// stuttering components by livelock states.  Use this flag to
  /// demonstrate an intermediate step of the construction.
  ///
  /// \return A spot::ta_explicit that recognizes the same language as the
  /// TGBA \a tgba_to_convert.
  SPOT_API ta_explicit_ptr
  tgba_to_ta(const const_twa_ptr& tgba_to_convert, bdd atomic_propositions_set,
             bool degeneralized = true,
             bool artificial_initial_state_mode = true,
             bool single_pass_emptiness_check = false,
             bool artificial_livelock_state_mode = false,
             bool no_livelock = false);

  /// \ingroup tgba_ta
  /// \brief Build a spot::tgta_explicit* (TGTA) from an LTL formula.
  ///
  /// \param tgba_to_convert The TGBA automaton to convert into a TGTA automaton
  /// \param atomic_propositions_set The set of atomic propositions used in the
  /// input TGBA \a tgba_to_convert
  ///
  /// \return A spot::tgta_explicit (spot::tgta) that recognizes the same
  ///  language as the TGBA \a tgba_to_convert.
  SPOT_API tgta_explicit_ptr
  tgba_to_tgta(const const_twa_ptr& tgba_to_convert,
               bdd atomic_propositions_set);
}