150 lines
6.1 KiB
C++
150 lines
6.1 KiB
C++
// -*- coding: utf-8 -*-
|
|
// Copyright (C) 2010, 2011, 2012, 2013, 2014, 2015 Laboratoire de
|
|
// Recherche et Développement de l'Epita (LRDE).
|
|
// Copyright (C) 2003, 2004, 2005, 2006 Laboratoire d'Informatique de
|
|
// Paris 6 (LIP6), département Systèmes Répartis Coopératifs (SRC),
|
|
// Université Pierre et Marie Curie.
|
|
//
|
|
// 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 "ltlast/formula.hh"
|
|
#include "twa/twagraph.hh"
|
|
#include "ltlvisit/apcollect.hh"
|
|
#include "ltlvisit/simplify.hh"
|
|
|
|
namespace spot
|
|
{
|
|
/// \ingroup twa_ltl
|
|
/// \brief Build a spot::twa_graph_ptr from an LTL formula.
|
|
///
|
|
/// This is based on the following paper.
|
|
/** \verbatim
|
|
@InProceedings{couvreur.99.fm,
|
|
author = {Jean-Michel Couvreur},
|
|
title = {On-the-fly Verification of Temporal Logic},
|
|
pages = {253--271},
|
|
editor = {Jeannette M. Wing and Jim Woodcock and Jim Davies},
|
|
booktitle = {Proceedings of the World Congress on Formal Methods in the
|
|
Development of Computing Systems (FM'99)},
|
|
publisher = {Springer-Verlag},
|
|
series = {Lecture Notes in Computer Science},
|
|
volume = {1708},
|
|
year = {1999},
|
|
address = {Toulouse, France},
|
|
month = {September},
|
|
isbn = {3-540-66587-0}
|
|
}
|
|
\endverbatim */
|
|
///
|
|
/// \param f The formula to translate into an automaton.
|
|
///
|
|
/// \param dict The spot::bdd_dict the constructed automata should use.
|
|
///
|
|
/// \param exprop When set, the algorithm will consider all properties
|
|
/// combinations possible on each state, in an attempt to reduce
|
|
/// the non-determinism. The automaton will have the same size as
|
|
/// without this option, but because the transition will be more
|
|
/// deterministic, the product automaton will be smaller (or, at worse,
|
|
/// equal).
|
|
///
|
|
/// \param symb_merge When false, states with the same symbolic
|
|
/// representation (these are equivalent formulae) will not be
|
|
/// merged.
|
|
///
|
|
/// \param branching_postponement When set, several transitions leaving
|
|
/// from the same state with the same label (i.e., condition + acceptance
|
|
/// conditions) will be merged. This correspond to an optimization
|
|
/// described in the following paper.
|
|
/** \verbatim
|
|
@InProceedings{ sebastiani.03.charme,
|
|
author = {Roberto Sebastiani and Stefano Tonetta},
|
|
title = {"More Deterministic" vs. "Smaller" B{\"u}chi Automata for
|
|
Efficient LTL Model Checking},
|
|
booktitle = {Proceedings for the 12th Advanced Research Working
|
|
Conference on Correct Hardware Design and Verification
|
|
Methods (CHARME'03)},
|
|
pages = {126--140},
|
|
year = {2003},
|
|
editor = {G. Goos and J. Hartmanis and J. van Leeuwen},
|
|
volume = {2860},
|
|
series = {Lectures Notes in Computer Science},
|
|
month = {October},
|
|
publisher = {Springer-Verlag}
|
|
}
|
|
\endverbatim */
|
|
///
|
|
/// \param fair_loop_approx When set, a really simple characterization of
|
|
/// unstable state is used to suppress all acceptance conditions from
|
|
/// incoming transitions.
|
|
///
|
|
/// \param unobs When non-zero, the atomic propositions in the LTL formula
|
|
/// are interpreted as events that exclude each other. The events in the
|
|
/// formula are observable events, and \c unobs can be filled with
|
|
/// additional unobservable events.
|
|
///
|
|
/// \param simplifier If this parameter is set, the LTL formulae
|
|
/// representing each state of the automaton will be simplified
|
|
/// before computing the successor. \a simpl should be configured
|
|
/// for the type of reduction you want, see
|
|
/// spot::ltl::ltl_simplifier. This idea is taken from the
|
|
/// following paper.
|
|
/** \verbatim
|
|
@InProceedings{ thirioux.02.fmics,
|
|
author = {Xavier Thirioux},
|
|
title = {Simple and Efficient Translation from {LTL} Formulas to
|
|
{B\"u}chi Automata},
|
|
booktitle = {Proceedings of the 7th International ERCIM Workshop in
|
|
Formal Methods for Industrial Critical Systems (FMICS'02)},
|
|
series = {Electronic Notes in Theoretical Computer Science},
|
|
volume = {66(2)},
|
|
publisher = {Elsevier},
|
|
editor = {Rance Cleaveland and Hubert Garavel},
|
|
year = {2002},
|
|
month = jul,
|
|
address = {M{\'a}laga, Spain}
|
|
}
|
|
\endverbatim */
|
|
///
|
|
/// \param unambiguous When true, unambigous TGBA will be produced using
|
|
/// the trick described in the following paper.
|
|
/** \verbatim
|
|
@InProceedings{ benedikt.13.tacas,
|
|
author = {Michael Benedikt and Rastislav Lenhardt and James
|
|
Worrell},
|
|
title = {{LTL} Model Checking of Interval Markov Chains},
|
|
booktitle = {19th International Conference on Tools and Algorithms for
|
|
the Construction and Analysis of Systems (TACAS'13)},
|
|
year = {2013},
|
|
pages = {32--46},
|
|
series = {Lecture Notes in Computer Science},
|
|
volume = {7795},
|
|
editor = {Nir Piterman and Scott A. Smolka},
|
|
publisher = {Springer}
|
|
}
|
|
\endverbatim */
|
|
///
|
|
/// \return A spot::twa_graph that recognizes the language of \a f.
|
|
SPOT_API twa_graph_ptr
|
|
ltl_to_tgba_fm(const ltl::formula* f, const bdd_dict_ptr& dict,
|
|
bool exprop = false, bool symb_merge = true,
|
|
bool branching_postponement = false,
|
|
bool fair_loop_approx = false,
|
|
const ltl::atomic_prop_set* unobs = 0,
|
|
ltl::ltl_simplifier* simplifier = 0,
|
|
bool unambiguous = false);
|
|
}
|