spot/spot/tl/relabel.hh
Alexandre Duret-Lutz 7149521f48 relabel_bse: rework to simplify more patterns
Rework the way we compute and use cut-points to catch more patterns we
can rewrite.  Also Use BDDs to check if a Boolean sub-expression is
false or true.   Fixes issue #540.

* spot/tl/relabel.hh: Update documentation
* spot/tl/relabel.cc (relabel_bse): Rework.
* tests/core/ltlfilt.test: Add more test cases.
* tests/python/_mealy.ipynb: Update.
* NEWS: Mention the change.
2023-09-13 11:31:49 +02:00

81 lines
2.8 KiB
C++

// -*- coding: utf-8 -*-
// Copyright (C) 2012, 2013, 2015, 2019, 2023 Laboratoire de Recherche et
// Développement de l'Epita (LRDE).
//
// 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/tl/formula.hh>
#include <spot/misc/hash.hh>
#include <map>
namespace spot
{
enum relabeling_style { Abc, Pnn };
typedef std::map<formula, formula> relabeling_map;
/// \ingroup tl_rewriting
/// \brief Relabel the atomic propositions in a formula.
///
/// If \a m is non-null, it is filled with correspondence
/// between the new names (keys) and the old names (values).
///
/// \see relabel_bse
/// \see relabel_overlaping_bse
SPOT_API
formula relabel(formula f, relabeling_style style,
relabeling_map* m = nullptr);
/// \ingroup tl_rewriting
/// \brief Relabel Boolean subexpressions in a formula using
/// atomic propositions.
///
/// If \a m is non-null, it is filled with correspondence
/// between the new names (keys) and the old names (values).
///
/// The relabel_overlapping_bse() will introduce a new atomic
/// proposition for each maximal Boolean subexpression encountered,
/// even if they overlap (i.e., share common atomic
/// propositions). For instance `(a & b & c) U (c & d & e)` will be
/// simply be relabeled as `p0 U p1`. This kind of renaming does not
/// preserve the satisfiability of the input formula.
///
/// The relabel_bse() version will make sure that the replaced
/// subexpressions do not share atomic propositions. For instance
/// `(a & b & c) U (!c & d & e)` will be simply be relabeled as
/// `(p0 & p1) U (!p1 & p2)`, were `p1` replaces `c` and the rest
/// is obvious.
///
/// @{
SPOT_API
formula relabel_bse(formula f, relabeling_style style,
relabeling_map* m = nullptr);
SPOT_API formula
relabel_overlapping_bse(formula f, relabeling_style style, relabeling_map* m);
// @}
/// \ingroup tl_rewriting
/// \brief Replace atomic propositions of \a f by subformulas
/// specified in \a m.
///
/// Atomic proposition that do not appear in \a m are not
/// replaced.
SPOT_API
formula relabel_apply(formula f, relabeling_map* m);
}