tgta.hh 3.22 KB
Newer Older
1
// -*- coding: utf-8 -*-
2 3
// Copyright (C) 2010, 2011, 2012, 2013, 2014, 2015 Laboratoire de
// Recherche et Développement de l'Epita (LRDE).
4 5 6 7 8
//
// 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
9
// the Free Software Foundation; either version 3 of the License, or
10 11 12 13 14 15 16 17
// (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 MERCHANta_explicitBILITY
// or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public
// License for more deta_explicitils.
//
// You should have received a copy of the GNU General Public License
18
// along with this program.  If not, see <http://www.gnu.org/licenses/>.
19

20
#pragma once
21 22 23 24 25 26 27

#include "tgba/tgba.hh"

namespace spot
{

  /// \ingroup ta_essentials
28
  /// \brief A Transition-based Generalized Testing Automaton (TGTA).
29
  ///
30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45
  /// Transition-based Generalized Testing Automaton (TGTA) is a new
  /// kind of automaton that combines features from both TA and TGBA.
  /// From TA, we take the idea of labeling transitions with
  /// changesets, however we remove the use of livelock-acceptance
  /// (because it may require a two-pass emptiness check), and the
  /// implicit stuttering.  From TGBA, we inherit the use of
  /// transition-based generalized acceptance conditions.  The
  /// resulting Chimera, which we call "Transition-based Generalized
  /// Testing Automaton" (TGTA), accepts only stuttering-insensitive
  /// languages like TA, and inherits advantages from both TA and
  /// TGBA: it has a simple one-pass emptiness-check procedure (the
  /// same as algorithm the one for TGBA), and can benefit from
  /// reductions based on the stuttering of the properties pretty much
  /// like a TA.  Livelock acceptance states, which are no longer
  /// supported are emulated using states with a Büchi accepting
  /// self-loop labeled by empty changeset.
46 47 48 49 50 51 52 53 54 55 56 57 58
  ///
  /// Browsing such automaton can be achieved using two functions:
  /// \c get_initial_state and \c
  /// succ_iter. The former returns the initial state(s) while the latter lists
  /// the successor states of any state. A second implementation of \c succ_iter
  /// returns only the successors reached through a changeset passed as
  /// a parameter.
  ///
  /// Note that although this is a transition-based automata,
  /// we never represent transitions!  Transition informations are
  /// obtained by querying the iterator over the successors of
  /// a state.

59
  class SPOT_API tgta : public twa
60 61 62
  {

  protected:
63
    tgta(const bdd_dict_ptr& d);
64

65
  public:
66 67 68 69 70 71 72 73 74 75 76 77 78 79 80
    virtual
    ~tgta();

    /// \brief Get an iterator over the successors of \a state
    /// filtred by the value of the changeset on transitions between the
    /// \a state and his successors
    ///
    /// The iterator has been allocated with \c new.  It is the
    /// responsability of the caller to \c delete it when no
    /// longer needed.
    ///
    virtual tgba_succ_iterator*
    succ_iter_by_changeset(const spot::state* s, bdd change_set) const =0;
  };

81 82
  typedef std::shared_ptr<tgta> tgta_ptr;
  typedef std::shared_ptr<const tgta> const_tgta_ptr;
83
}