73dfcd6c1e
ci/woodpecker/push/build Pipeline was successful
Details
- The current implementation triggers a warning when rejected classes are find in the monitor, and an error if monitor_strict_checking is enable. It follows these rules: Inside the scope of a monitor, all instances of classes mentioned in its accepts_clause (the ∗‹accept-set›) have to appear in the order specified by the regular expression. Instances not covered by an accept-set may freely occur. Monitors may additionally contain a rejects_clause with a list of class-ids (the reject-list). This allows specifying ranges of admissible instances along the class hierarchy: - a superclass in the reject-list and a subclass in the accept-expression forbids instances superior to the subclass, and - a subclass S in the reject-list and a superclass T in the accept-list allows instances of superclasses of T to occur freely, instances of T to occur in the specified order and forbids instances of S. - No message is triggered for the free classes, but two theory options, free_class_in_monitor_checking and free_class_in_monitor_strict_checking, are added and can be used if we want to trigger warnings or errors, in the case we do not want free classes inside a monitor. - Fix the checking warning when defining a monitor, as the monitor was added to the monitor table and then the instance of the monitor was added to the theory. So a monitor had the bad behavior to check itself. |
||
---|---|---|
.woodpecker | ||
etc | ||
examples | ||
src | ||
.gitattributes | ||
.gitignore | ||
CHANGELOG.md | ||
CITATION | ||
LICENSE | ||
README.md | ||
ROOTS | ||
install-afp |
README.md
Isabelle/DOF: Document Preparation Setup
Isabelle/DOF is a novel Document Ontology Framework on top of Isabelle. Isabelle/DOF allows for both conventional typesetting and formal development. The manual for Isabelle/DOF 1.3.0/Isabelle2021-1 is available online.
Pre-requisites
Isabelle/DOF has three major prerequisites:
- Isabelle: Isabelle/DOF requires Isabelle 2022. Please download the Isabelle 2022 distribution for your operating system from the Isabelle website.
- AFP: Isabelle/DOF requires several entries from the Archive of Formal Proofs (AFP). Please install the AFP following the instructions given at https://www.isa-afp.org/using.html.
- LaTeX: Isabelle/DOF requires a modern LaTeX installation, i.e., at least TeX Live 2022 with all available updates applied.
Installation
Isabelle/DOF is provided as an Isabelle component. After installing the
prerequisites, change into the directory containing Isabelle/DOF (this should be
the directory containing this README.md
file) and execute (if you executed
this command already during the installation of the prerequisites, you can skip
it now):
foo@bar:~$ isabelle components -u .
The final step for the installation is:
foo@bar:~$ isabelle build -D .
This will compile Isabelle/DOF and run the example suite.
Usage
Opening an Example
If you want to work with or extend one of the examples, e.g., you can open it similar to any standard Isabelle theory:
isabelle jedit -d . -l Isabelle_DOF examples/scholarly_paper/2018_cicm/IsaDofApplications.thy
This will open an example of a scientific paper using the pre-compiled session
Isabelle_DOF
, i.e., you will not be able to edit the ontology definitions.
If you want to edit the ontology definition, just open the theory file with the
default HOL session:
isabelle jedit -d . -l HOL examples/scholarly_paper/2018_cicm/IsaDofApplications.thy
While this gives you more flexibility, it might "clutter" your editing experience, as a lot of internal theories are loaded into Isabelle's editor.
Creating a New Project
The DOF-plugin provides an alternative to Isabelle's mkroot
command.
Isabelle projects that use DOF need to be created using
foo@bar:~$ isabelle dof_mkroot
The dof_mkroot
command takes the same parameter as the standard mkroot
command of Isabelle. Thereafter, the normal Isabelle command for building
documents can be used.
Using the -o
option, different ontology setups can be selected and using the
-t
option, different LaTeX setups can be selected. For example,
foo@bar:~$ isabelle dof_mkroot -o scholarly_paper -t scrartcl
creates a setup using the scholarly_paper ontology and the article class from the KOMA-Script bundle.
The help (option -h
) show a list of all supported ontologies and document
templates:
foo@bar:~$ isabelle dof_mkroot -h
Usage: isabelle dof_mkroot [OPTIONS] [DIRECTORY]
Options are:
-I init Mercurial repository and add generated files
-h print help
-n NAME alternative session name (default: directory base name)
-o NAMES list of ontologies, separated by blanks
(default: "technical_report scholarly_paper")
-q quiet mode: less verbosity
-t NAME template (default: "scrreprt-modern")
Create session root directory for Isabelle/DOF (default: current directory).
Releases
For releases, signed archives including a PDF version of the Isabelle/DOF manual are available:
- Isabelle/DOF 1.3.0/Isabelle2021-1
Older Releases
- Isabelle/DOF 1.2.0/Isabelle2021
- Isabelle/DOF 1.1.0/Isabelle2021
- Isabelle/DOF 1.1.0/Isabelle2020
- Isabelle/DOF 1.0.0/Isabelle2019
Team
Main contacts:
Contributors
- Idir Ait-Sadoune
- Paolo Crisafulli
- Chantal Keller
- Nicolas Méric
License
This project is licensed under a 2-clause BSD license.
SPDX-License-Identifier: BSD-2-Clause
Publications
-
Achim D. Brucker, Idir Ait-Sadoune, Paolo Crisafulli, and Burkhart Wolff. Using The Isabelle Ontology Framework: Linking the Formal with the Informal. In Conference on Intelligent Computer Mathematics (CICM). Lecture Notes in Computer Science (11006), Springer-Verlag, 2018. doi:10.1007/978-3-319-96812-4_3.
-
Achim D. Brucker and Burkhart Wolff. Isabelle/DOF: Design and Implementation. In Software Engineering and Formal Methods (SEFM). Lecture Notes in Computer Science (11724), Springer-Verlag, 2019. doi:10.1007/978-3-030-30446-1_15.
-
Achim D. Brucker, Burkhart Wolff. Using Ontologies in Formal Developments Targeting Certification. In Integrated Formal Methods (IFM). Lecture Notes in Computer Science (11918). Springer-Verlag 2019. doi:10.1007/978-3-030-34968-4_4
-
Sergio Bezzecchi, Paolo Crisafulli, Charlotte Pichot, and Burkhart Wolff. Making Agile Development Processes fit for V-style Certification Procedures.. In ERTS 2018. https://hal.archives-ouvertes.fr/hal-01702815
Upstream Repository
The upstream git repository, i.e., the single source of truth, for this project is hosted at https://git.logicalhacking.com/Isabelle_DOF/Isabelle_DOF.