This is an equivalence checker for contextual formulas in propositional logic, LTL, and CTL. Contextual formulas extend ordinary formulas with expressions c[φ], where c is a context variable and φ is a contextual formula. Contexts are ordinary formulas with a special variable [], the hole, and a contextual formula is instantiated with a context for each context variable c by replacing c[φ] expressions with the context where the hole is in turn replaced by φ. Two contextual formulas are equivalent if all their instantiations are equivalent as ordinary formulas.
The tool's output indicates whether the equivalence holds, one formula implies the other, or they are unrelated. When there is no equivalence, a counterexample is obtained and consists of a context (simplified from the canonical context in the reference) and a valuation or counterexample trace for the propositional variables. Satisfiability and validity can be checked using the constant formulas true and false.
The command python -m ctxform in the root directory will start a REPL prompt for the two formulas of the identity. By default, LTL formulas are expected, but a different logic can be chosen with the command-line argument --logic name (or -l name) where name is either bool, ltl, or ctl. The option --any-formula (or -a) drops the assumption that the contexts are monotonic, i.e., it check whether the contextual formula holds for any replacement without restrictions. Negation normal form is not required even without the --any-formula flag. Other options are listed with --help.
The syntax of formulas is that of Spot, as described in the document Spot's Temporal Logic Formulas by Alexandre Duret-Lutz, extended with the A and E operators for CTL only.
The tool can also be used as a web interface with the command python -m ctxform.service -s 8080. This will start a web service on http://localhost:8080/ that can be stopped with Ctrl+C.
The tool requires Python 3.10 or a more recent version to run. Morever, it depends on the following packages:
lark(for parsing, can be installed withpip install lark).pysat(for propositional logic, can be install withpip install python-sat).spot(for LTL, instructions to install are available in https://spot.lre.epita.fr/install.html).clt-sat(for CTL, a single binary that can be built from source). Our tool will look for the binary in thebinsubdirectory of the current working directory. Some binaries are available in the release section of this repository.
The last three packages are only required if the corresponding logic is used. For the web interface, tornado (which can be installed with pip install tornado) is also required.
The script test.py and the lists of formulas formulas.toml and mutated_formulas.toml have been used to test and benchmark the tool. Since some executions timeout and run out of memory, each equivalence is checked in a confined environment for which a Linux system with systemd is required. Moreover, systemd 255 or above is needed to obtain the memory usage peak, although the script can be run with an older version. The official Python bindings for D-Bus are used to communicate with systemd (usually a package named python3-dbus or dbus-python in the Linux distribution repositories).
Time and memory bounds can be adjusted with --timeout and --memlimit.
- Javier Esparza, Rubén Rubio. Validity of contextual formulas. CONCUR 2024. LIPIcs 311 (article 24). Extended version on arXiv.