15ea2e66e8
* doc/org/tut51.org: New file. * doc/org/tut.org, doc/Makefile.am, NEWS: Add it. * elisp/ob-dot.el: New file, to work around old org-mode versions. * elisp/README, elisp/Makefile.am: Add it.
77 lines
4.4 KiB
Org Mode
77 lines
4.4 KiB
Org Mode
# -*- coding: utf-8 -*-
|
|
#+TITLE: Code Examples
|
|
#+DESCRIPTION: Directory of code examples for using Spot in C++11, Python, and shell.
|
|
#+SETUPFILE: setup.org
|
|
#+HTML_LINK_UP: index.html
|
|
|
|
|
|
This section contains code examples for using Spot. This is a work in
|
|
progress. Feel free to [[mailto:spot@lrde.epita.fr][send]] suggestions of small tasks you would like
|
|
to see illustrated here.
|
|
|
|
If you have difficulties compiling the C++ examples, check out [[file:compile.org][these
|
|
instructions]].
|
|
|
|
Reading the [[file:concepts.org][concepts page]] might help if you are not familiar with some
|
|
of the objects manipulated here.
|
|
|
|
* Examples with Shell, Python, and C++
|
|
|
|
All the following pages show how to perform the same task using the
|
|
three interfaces supported by Spot: shell commands, Python, or C++.
|
|
|
|
- [[file:tut01.org][Parsing and Printing LTL Formulas]]
|
|
- [[file:tut02.org][Relabeling Formulas]]
|
|
- [[file:tut04.org][Testing the equivalence of two LTL formulas]]
|
|
- [[file:tut10.org][Translating an LTL formula into a never claim]]
|
|
- [[file:tut20.org][Converting a never claim into HOA]]
|
|
- [[file:tut30.org][Converting Rabin (or Other) to Büchi, and simplifying it]]
|
|
|
|
* Examples in Python and C++
|
|
|
|
- [[file:tut03.org][Constructing and transforming formulas]]
|
|
- [[file:tut21.org][Custom print of an automaton]]
|
|
- [[file:tut22.org][Creating an automaton by adding states and transitions]]
|
|
|
|
* Examples in C++ only
|
|
|
|
- [[file:tut50.org][Explicit vs. on-the-fly: two interfaces for exploring automata]]
|
|
- [[file:tut51.org][Implementing an on-the-fly Kripke structure]]
|
|
|
|
* Examples in Python only
|
|
|
|
In directory =python/tests=, the [[file:install.org][Spot tarball]] contains a small
|
|
collection of IPython notebooks. As the name of the directory implies,
|
|
these are part of the test suite for the Python bindings, however they
|
|
can be interesting to look at if you want to see more code examples.
|
|
|
|
For convenience, the following links offer static HTML renderings of
|
|
these notebooks, but we strongly suggest interactively evaluating the
|
|
real notebooks instead.
|
|
|
|
- [[https://spot.lrde.epita.fr/ipynb/formulas.html][=formulas.ipynb=]] covers the basics of LTL/PSL formula parsing and
|
|
printing, with some light operations
|
|
- [[https://spot.lrde.epita.fr/ipynb/automata.html][=automata.ipynb=]] covers translation from formulas to automata,
|
|
automata printing, and some lights transformations
|
|
- [[https://spot.lrde.epita.fr/ipynb/automata-io.html][=automata-io.ipynb=]] shows how to save and read automata from files
|
|
- [[https://spot.lrde.epita.fr/ipynb/piperead.html][=piperead.ipynb=]] shows how to save and read automata output from other
|
|
commands, using pipes
|
|
- [[https://spot.lrde.epita.fr/ipynb/randaut.html][=randaut.ipynb=]] shows a simple case where the [[file:randaut.org][=randaut=]] commands
|
|
generated random automata, which are displayed in a table before and
|
|
after acceptance simplification
|
|
- [[https://spot.lrde.epita.fr/ipynb/accparse.html][=accparse.ipynb=]] exercises the acceptance condition parser
|
|
- [[https://spot.lrde.epita.fr/ipynb/acc_cond.html][=acc_cond.ipynb=]] documents the interface for manipulating acceptance
|
|
conditions
|
|
- [[https://spot.lrde.epita.fr/ipynb/product.html][=product.ipynb=]] shows how to re-implement the product of two automata
|
|
in Python
|
|
- [[https://spot.lrde.epita.fr/ipynb/randltl.html][=randltl.ipynb=]] demonstrates a Python-version of [[file:randltl.org][=randltl=]]
|
|
- [[https://spot.lrde.epita.fr/ipynb/decompose.html][=decompose.ipynb=]] illustrates the =decompose_strength()= function
|
|
- [[https://spot.lrde.epita.fr/ipynb/testingaut.html][=testingaut.ipynb=]] shows the steps necessary to build a testing
|
|
automaton
|
|
- [[https://spot.lrde.epita.fr/ipynb/ltsmin-dve.html][=ltsmin-dve.ipynb=]] loading a DiVinE model using the LTSmin interface.
|
|
- [[https://spot.lrde.epita.fr/ipynb/ltsmin-pml.html][=ltsmin-pml.ipynb=]] loading a Promela model using the LTSmin interface.
|
|
- [[https://spot.lrde.epita.fr/ipynb/word.html][=word.ipynb=]] example for the =twa_run= and =twa_word= classes.
|
|
- [[https://spot.lrde.epita.fr/ipynb/highlighting.html][=highlighting.ipynb=]] shows how to highlight states or edges in
|
|
automata.
|
|
- [[https://spot.lrde.epita.fr/ipynb/atva16-fig2a.html][=atva16-fig2a.ipynb=]] first example from our [[https://www.lrde.epita.fr/~adl/dl/adl/duret.16.atva2.pdf][ATVA'16 tool paper]].
|
|
- [[https://spot.lrde.epita.fr/ipynb/atva16-fig2b.html][=atva16-fig2b.ipynb=]] second example from our [[https://www.lrde.epita.fr/~adl/dl/adl/duret.16.atva2.pdf][ATVA'16 tool paper]].
|