Debian Codegraph @

Readme.md

raw ◀ ▶
1 Debian patch touch this file
1 # OVERVIEW
2
3 Konclude is a tableau-based reasoner for the Description Logic SROIQV(D), i.e.,SROIQ(D) + Nominal Schemas, and covers almost all features of the Web Ontology Language (OWL) 2 DL. Konclude is still under active development and the current version probably contains some bugs and other errors. If you find an unexpected/strange behaviour you are cordially invited to report it. See http://konclude.com/feedback.html for details.
4
5
6
7 # LICENSING
8
9 Konclude is released as free software, i.e., you can redistribute it and/or modify it under the terms of version 3 of the GNU Lesser General Public License (LGPLv3) as published by the Free Software Foundation.
10
11 You should have received a copy of the GNU Lesser General Public License along with Konclude. If not, see http://www.gnu.org/licenses/.
12
13 Konclude 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. For more details see GNU Lesser General Public License.
14
15 Konclude uses the following libraries:
16 - Qt 5.11 or above (https://www.qt.io/download), released under LGPLv3 (https://www.gnu.org/licenses/lgpl-3.0.en.html). Note that Konclude uses slightly modified versions of Qt containers (QMap, QHash, QList, see Source/Utilities/Container/CQtManagedRestrictedModification* files) for an integrated memory management, which were released under LGPLv2.1 and, hence, are available under the GPLv3 in oder to ensure compatiblity with LGPLv3 (cf. https://www.gnu.org/licenses/gpl-faq.html#AllCompatibility).
17
18 - Redland RDF Libraries (http://librdf.org/), released under the LGPL 2.1 (or newer), GPL 2, and Apache 2 licenses. Note that the Redland RDF Libraries are optional and only required if RDF triples have to be parsed and mapped to OWL axioms or if more complex SPARQL queries have to be answered. For the latter, it is recommended to use the forked version of the Redland Rasqal query library on Konclude's Github page (https://github.com/konclude/rasqal) since it contains a few fixes and performance improvements.
19
20
21 # USAGE
22
23 The binaries of Konclude (and possibly some shared libraries) are located in the `Binaries` directory. However, you can use the starter scripts in the main directory for directly invoking Konclude with `Konclude` (Windows) or `./Konclude` (Linux, Mac). The command line parameter '-h' shows the usage options for Konclude. Some examples are located in the `Tests` directory. See http://konclude.com/ for detailed usage instructions.
24
25 - COMMAND LINE:
26
27 Basic reasoning tasks such as classification, consistency, class satisfiability, and realisation can be directly invoked with the command line interface. For this, Konclude has to be called with the corresponding command (`classification`, `consistency`, `satisfiability`, or `realisation`) and at least the input file has to be specified with `-i FILEPATH`. The output file is optional and can be set with the `-o FILEPATH` argument. The class satisfiability checking additionally requires the IRI of the class that has to be tested, which has to be specified with `-x IRI`.
28
29 Please note that Konclude natively only supports ontologies in the OWL 2 XML [1] or in the OWL 2 Functional Style format [2]. The optional integration of the Redland RDF Libraries allow for parsing RDF serialization formats, but the mapping to OWL constructs must be considered as experimental. Hence, you may use the protege editor [3] to convert ontologies in other syntaxes into a fully supported format.
30
31 Examples (omit ./ on Windows):
32 ```
33 ./Konclude classification -i Tests/roberts-family-full-D.owl.xml -o roberts-family-full-class-hierarchy.owl.xml
34 ./Konclude satisfiability -i Tests/roberts-family-full-D.owl.xml -x http://www.co-ode.org/roberts/family-tree.owl#Aunt
35 ```
36
37
38 - OWLLINK:
39
40 Furthermore, Konclude processes OWLlink [4] requests with the XML binding [5].
41 Konclude is optimised to read/write the OWLlink requests/responses from/to files.
42 For this, Konclude has to be called with the `owllinkfile` command and at least
43 with the parameter `-i FILEPATH`, where FILEPATH specifies the OWLlink request/query
44 file. The OWLlink response file can be specified with the `-o FILEPATH` parameter.
45
46 Examples (omit ./ on Windows):
47
48 ```
49 ./Konclude owllinkfile -i Tests/galen-classify-request.xml -o response.xml
50 ./Konclude owllinkfile -i Tests/roberts-family-full-D-classify-realize-request.xml
51 ./Konclude owllinkfile -c Configs/default-config.xml -i Tests/1b-satisfiability-request.xml
52 ```
53
54
55 Currently, Konclude supports only the following subset of OWLlink commands:
56 - GetDescription, CreateKB, GetSettings, Set, ReleaseKB, Tell,
57 LoadOntologies (IRIs must be files), Classify, Realize
58 - GetAllObjectProperties, GetAllIndividuals, GetAllClasses, GetKBLanguage
59 - IsClassSatisfiable, GetSubClassHierarchy, GetSubClasses (only for atomic concepts),
60 GetSuperClasses (only for atomic concepts), GetEquivalentClasses (only for atomic concepts)
61 - GetTypes, GetFlattenedTypes, GetInstances (only for atomic concepts),
62 GetFlattenedInstances (only for atomic concepts)
63
64 Furthermore, all OWL 2 ontologies/axioms used in LoadOntologies/Tell
65 commands should be in the OWL 2 XML [1] or in the OWL 2 Functional Style [2]
66 format and Konclude does currently NOT process any annotations. The protege
67 editor [2] can be used to convert OWL 2 ontologies between different
68 formats.
69
70
71 Konclude can also be used as an OWLlink server that answers OWLlink requests
72 sent over HTTP. For this, Konclude has to be called with the 'owllinkserver'
73 command. The listening port can optionally be specified by the parameter `-p`,
74 otherwise the default port 8080 is used.
75
76 Examples (omit ./ on Windows):
77
78 ```
79 ./Konclude owllinkserver -p 8080
80 ```
81
82
83 Large ontologies should separately be loaded with the LoadOntologies
84 OWLlink command, because the request files are completely loaded
85 into the main memory of the system. In contrast, the files referenced by
86 the LoadOntologies commands are parsed in a stream-based manner.
87
88
89 - SPARQL:
90
91 A trivial SPARQL HTTP server is integrated that supports processing of some basic SPARQL Update commands and answering of some ABox related queries. Note that Konclude by itself can only process queries with simple Basic Graph Patterns, where variables are used for individuals. More complex SPARQL queries (e.g., with UNION, OPTIONAL, FILTER, MINUS, etc.) are supported via the Redland RASQAL integration, which is however not fully optimized. Note that the SPARQL requests/queries must be encoded as HTTP POST requests. Alternatively the SPARQL requests can also directly be loaded from files with the `sparqlfile` command. Note that the last loaded ontology is interpreted as the default graph, i.e., it is automatically used if no graph/knowledge base is specified in the query.
92
93 Examples (omit ./ on Windows):
94
95 ```
96 ./Konclude sparqlserver -p 8080 -c Configs/querying-config.xml
97 ./Konclude sparqlfile -s Tests/lubm-univ-bench-sparql-load-and-query-test.sparql -o Tests/query-answers.xml -c Configs/querying-config.xml
98 ./Konclude sparqlfile -s Tests/roberts-family-full-sparql-existential-variables-query-test.sparql -i Tests/roberts-family-full-D.owl.xml
99 ```
100
101 Currently, the following SPARQL commands/queries are (partially) supported:
102 - LOAD, SELECT, ASK
103
104 Note that the settings of the `Configs/querying-config.xml` file are automatically enabled if the `sparqlserver` or `sparqlfile` commands are used in order to deactivate some optimizations that are not yet compatible with the integrated query answering engine. However, the `Configs/querying-config.xml` file also contains some commented out settings that may be interesting for configuring some query answering aspects in more detail (e.g., concurrency, interpretation of anonymous variables, etc.).
105
106
107 - CONFIGURATION:
108
109 Konclude can be configured with configuration files, which are also OWLlink request files where only the 'Set' command is used. 'Set' commands without the specification of a specific knowledge base configure the default settings in Konclude, which are used to instantiate the configurations of newly created knowledge bases. It is highly recommended to NOT change the default configuration of Konclude, because many available configurations are only for debugging, testing and experimenting. However, if Konclude requires too much main memory, then you can try to deactivate the satisfiability or unsatisfiability caching (see example configuration file in `Configs` directory). The parameter `-c FILEPATH` can be used to load a configuration file.
110
111
112
113 # REQUIREMENTS, INSTALLATION, BUILD
114
115 On GitHub, there is an up-to-date Docker image of Konclude available (`docker pull konclude/konclude`, cf. https://hub.docker.com/r/konclude/konclude), which should run on most platforms with Docker installed.
116
117 In principle, Konclude requires Qt 5.11 libraries or above [6], but they are included (or statically integrated/linked into the binary) for the released versions for most platfroms. If this is not the case, then you should install them manually on your system.
118
119 On Mac, you may be required to deactivate the 'Unidentified Developer' warning dialogue for Konclude (cf. [10]).
120
121 On Windows-based platforms, it may further be necessary to install the .Net Framework [7] and the Microsoft Visual C++ Redistributable Package [8] for executing Konclude.
122
123
124 Konclude can be built by running qmake (which is part of the Qt Framework) for `Konclude.pro` or `KoncludeWithoutRedland.pro`, e.g.,
125 ```
126 qmake -o Makefile Konclude.pro
127 ```
128 and then by compiling the sources with the generated makefile, i.e., the command
129 ```
130 make
131 ```
132 has to be executed/called. Note that you may have to adapt the paths to the Redland libraries in the `Konclude.pro` file. If you have docker installed, then you may simply use the provided Dockerfiles [9] for building Konclude (which download/install all dependent libraries, compile Konclude and create a statically linked binary). For this, go into the KoncludeDocker' directory and run the following command:
133 ```
134 ./build_release.sh
135 ```
136 For more details for building with docker, see also `KoncludeDocker/README.md`.
137
138 Setting up Konclude for building/compiling with Visual Studio 2015/2017:
139 - Make sure that Qt is installed and the environment variable QTDIR is set to the QT directory
140 - Install the QT VS Tools/Package extension for Visual Studio (enables more comfortable debugging)
141 - Copy the QT DLLs (Qt5Networkd.dll, Qt5Network.dll, Qt5Xmld.dll, Qt5Xml.dll, Qt5Cored.dll, Qt5Core.dll, Qt5Concurrentd.dll, Qt5Concurrent.dll) into the root directory of Konclude
142
143
144
145
146
147 # CHANGELOG
148
149 - Konclude v0.7.0-1138:
150 - Fixed crash for parsing anonymous individuals.
151
152 - Konclude v0.7.0-1137:
153 - Fixed crashes for SPARQL FILTER expressions in combination with Redland Rasqal.
154
155 - Konclude v0.7.0-1135:
156 - (Limited) SPARQL and query answering support with Redland Rasqal.
157 - Parallelized consistency checking and query answering.
158 - Several minor reasoning improvements.
159 - Several bug fixes.
160
161 - Konclude v0.6.2-965 (pre-release):
162 - Support of more SPARQL features (e.g., OPTIONAL, UNION, FILTER, aggregates, etc.) via Redland Rasqal.
163 - Several bug fixes.
164
165 - Konclude v0.6.2-842 (pre-release):
166 - Experimental conjunctive query answering engine based on absorption.
167 - Simple SPARQL HTTP server.
168 - Experimental support of RDF serializations of ontologies via the Redland RDF libraries.
169 - Representative completion graph caching for efficient indexing, parallel consistency checking, and improved handling of larger ontologies.
170 - Docker images for building and running Konclude.
171 - Very basic and experimental JNI bridge.
172 - Role classification and realization.
173 - Several bug fixes.
174
175 - Konclude v0.6.2:
176 - Several minor bug fixes.
177
178 - Konclude v0.6.1:
179 - Several bug fixes.
180 - Minor performance improvements.
181
182 - Konclude v0.6.0:
183 - Several fixed bugs and memory leaks.
184 - Many performance improvements (especially for realisation).
185 - Improved error reporting.
186 - Almost complete datatype support.
187 - OWL 2 Functional Style support.
188 - Loading of ontologies via HTTP and FTP.
189
190 - Konclude v0.5.0:
191 - First release of Konclude.
192
193
194
195 # REFERENCES
196
197 [1] http://www.w3.org/TR/owl2-xml-serialization/
198
199 [2] http://www.w3.org/TR/owl2-syntax/
200
201 [3] http://protege.stanford.edu/
202
203 [4] http://www.w3.org/Submission/owllink-structural-specification/
204
205 [5] http://www.w3.org/Submission/2010/SUBM-owllink-httpxml-binding-20100701/
206
207 [6] http://qt-project.org/downloads
208
209 [7] http://www.microsoft.com/en-us/download/details.aspx?id=17718
210
211 [8] https://www.microsoft.com/en-us/download/details.aspx?id=48145
212
213 [9] https://github.com/konclude/KoncludeDocker
214
215 [10] https://support.apple.com/en-gb/guide/mac-help/mh40616/mac