Changelog for package knowledge_core

3.8.0 (2025-03-11)

fix launch_pal dependency for PAL internal and external users
add last facts to diagnostics
Contributors: Luka Juricic

3.7.0 (2025-02-27)

api.KB: expose load() + add support for clear(keep_defaults=True) clear(keep_defaults=True) removes all statements in the knowledge base, but keep the ones coming for the 'default ontologies' loaded at startup
Contributors: Séverin Lemaignan

3.6.2 (2025-02-25)

increase the queue size for /kb/add_fact and /kb/remove_fact
Contributors: Séverin Lemaignan

3.6.1 (2025-02-21)

add missing knowledge_viewer script
Contributors: Séverin Lemaignan

3.6.0 (2025-02-21)

add launch file to start kb_explorer
Contributors: Séverin Lemaignan

3.5.0 (2025-02-19)

escape turtle/n3 reserved characters This implementation ignores terms that are quoted (ie, string literal) and does not escape the '?' and '@' as they can legitimately occur in a term/sparql statement. '' is escaped (ie, if a character was already escaped, it will be double escaped. fix escape
[kb explorer] update classes to reflect dbpedia use in ORO
Contributors: Séverin Lemaignan

3.4.0 (2025-02-18)

[doc] update doc to match simpler async ROS2 pythonic API
fix async calls
[doc] add mention of kb_msgs and oro
Contributors: Luka Juricic, Séverin Lemaignan

3.3.1 (2024-12-03)

teaching knowledge_core about foaf, prov and dbp prefixes
Contributors: Séverin Lemaignan

3.3.0 (2024-10-16)

simplify launch file by using new 'get_pal_configuration(cmdline_args)' parameter
fix typo in config file path
Contributors: Séverin Lemaignan

3.2.8 (2024-10-11)

teach knowledge core about DBPedia prefixes
Contributors: Séverin Lemaignan

3.2.7 (2024-08-19)

rename diagnostics msg to match documentation (and diagnostic_aggregator) categories
Contributors: Séverin Lemaignan

3.2.6 (2024-08-06)

typo in module
Contributors: Séverin Lemaignan

3.2.5 (2024-08-06)

fix installation of module and configuration
Contributors: Séverin Lemaignan

3.2.4 (2024-07-31)

install kb_explorer files
[doc] various documentation improvements
Contributors: Séverin Lemaignan

3.2.3 (2024-05-16)

bump version
Contributors: Séverin Lemaignan

3.2.2 (2024-05-16)

correctly report topic namespace when subscribing to events
Contributors: Séverin Lemaignan

3.2.1 (2024-05-16)

bump version
[minor] doc typo
Contributors: Séverin Lemaignan

3.2.0 (2024-05-16)

replace KB webgui by the explorer
kb_explorer: add support for active_concepts
kb_explorer: port to ROS2 using roslib It requires rosbridge_server running on the ROS2 side. You can start the rosbridge server using: ros2 launch rosbridge_server rosbridge_websocket_launch.xml
import kb_explorer from ROS1's kb_rest
please pep 257 linter
[doc] mention details, about, label APIs in README
add support for querying for concepts' labels via /kb/label Also support multiple languages
add /kb/details to the ROS API + improve returned details Including removing 'internal' facts, BNode, providing the list of relations involving the term, etc
add kb.on_active_concepts method to register custom callbacks when a new active concept is detected
publish active concepts on /kb/active_concepts
implemented ActiveConcept Any concept marked as 'rdf:type ActiveConcept' is a currently 'active' concept. The 'rdf:type ActiveConcept' is automatically removed after a period of time (currently set to 5 seconds). It can be used to eg display what concepts are currently important in the knowledge base because they have been eg recently added or refered to in a discussion
Contributors: Séverin Lemaignan

3.1.0 (2024-05-14)

launch knowledge_core in the kb/ namespace ...and ensure all the topics/services are right under that namespace
Port launchfile to py, handle the default_kb parameter Add logic to parse ontology path in the form of ontology://pkg/file, so that the ontology to be loaded can be found across packages Make the node PAPS-007 conformant, by fetching configuration files invarious ament-index'ed locations
install PAL module + bump version
[doc] statement lifespans are supported
Contributors: Séverin Lemaignan

3.0.1 (2024-02-07)

[test] disable flaky test
[test] please linter
Contributors: Séverin Lemaignan

3.0.0 (2024-02-07)

port to ROS 2 humble
srv files have moved to kb-msgs
Contributors: Séverin Lemaignan

2.9.0 (2024-02-07)

fix events being sometimes triggered multiple times or never
doc/line wrapping
fix test_ros.py that was incorrect when running without a reasoner
fix sparql() that was broken since eb0c97a1bef3e74
reimplemented lookup(); fixes unittest While here, strenghten the literals unittest and fix some issues that arose.
make it possible to update the lifespan of statements (either to extend or shorten it)
workaround for rdflib 6.2.x bug See RDFLib/rdflib#2077
automatically remove statements reaching the end of their lifespan
do not crash when starting with --no-ros
add metadata graph to each model + store insertion date of every stmts
do not return blank nodes (BNodes) when querying the kb
Contributors: Séverin Lemaignan

2.8.10 (2023-07-05)

bump version
Contributors: Séverin Lemaignan

2.8.9 (2023-07-05)

fixed representation of string + fix logic of lookup() for RDFS.label
fix exception when using wildcard statement retractation While here, removed from the unittest the unsupported case of multiple statements with wildcards
Contributors: Séverin Lemaignan

2.8.8 (2023-05-16)

more robustely parse RDF terms
Contributors: Séverin Lemaignan

2.8.7 (2023-05-11)

bump version
Contributors: Séverin Lemaignan

2.8.6 (2023-05-10)

fix bug in wildcard retract when objects are literals
Contributors: Séverin Lemaignan

2.8.5 (2023-05-08)

add diagnostics publishing
Contributors: Séverin Lemaignan

2.8.4 (2023-05-08)

added test for wildcard retracting
wildcard retracting allowing wildcards when retracting entries from the knowledge base. E.g., retracting 'some_subj ?p ?o' will now delete any triplet from the specified model in the knowledge base where the subject is 'some_subj'.
Contributors: Séverin Lemaignan, lorenzoferrini

2.8.3 (2023-04-25)

add launch file
Contributors: Séverin Lemaignan

2.8.1 (2022-09-27)

add dependency on reasonable
update pypi doc
Contributors: Séverin Lemaignan

2.8.0 (2022-08-17)

fix KB.find to properly handle ROS queries with no variable specified It now returns all present variables instead of an error
output literal as python/JSON literal instead of XSD ones
minor debug msg changes
Contributors: Séverin Lemaignan

2.7.0 (2022-07-20)

add missing space in SPAQRL prefixes
[api] expose 'stats' to the ROS py wrapper
[minor] improve debug message experience
Update README.md with example of how to use the ROS API
increase logging level of several msgs
fix corner case where trying to publish to unregistered evt topic
Contributors: Séverin Lemaignan

2.6.1 (2022-06-13)

[api] add (back) ability to save the knowledge base
Contributors: Séverin Lemaignan

2.6.0 (2022-06-13)

Major changes:

[api] pythonic API over ROS To use: ` from knowledge_core.api import KB kb = KB() ` then: ` kb += "ari rdf:type Human" kb -= "ari rdf:type Human" if "ari rdf:type Human": print("come one, ARI is not a human!") def on_robot(evt): print("new robots! %s" % evt) kb.subscribe("* rdf:type Robot", on_robot) kb += ["tiago rdf:type Robot", "ari rdf:type Robot"] ` ...and more
support events via ROS service + topics One subscribe to an event via the /kb/events [Event.srv] service. The service returns an event id corresponding to a topic (eg /kb/events/evt_1234) that the client can subscribe to to be notified when the event triggers. /examples/kb_events_ros.py provides an example.
[api] add support for the 'lookup' API
[api] add support for the 'about' API

Other changes:

[api] fix inconsistency in return type of 'find'
[doc] briefly document ROS support
set the asyncore loop timeout to 20ms for much more responsive events
Contributors: Séverin Lemaignan

2.5.4 (2022-05-30)

add missing dep on message_runtime
move ROS back to own file + add support for adding/removing facts via topics
[api] add now an alias for update
Contributors: Séverin Lemaignan

2.5.3 (2022-05-30)

remove ontologies from this repo Ontologies are stored in an independent repo (oro)
minor maintainance (doc, copyright...)
Contributors: Séverin Lemaignan

2.5.2 (2022-05-04)

add back missing files following project renaming
Contributors: Séverin Lemaignan

2.5.1 (2022-05-04)

provide better feedback when running outside of ROS
more minimalkb->KnowledgeCore
Contributors: Séverin Lemaignan

2.5.0 (2022-05-04)

rename project to KnowledgeCore
setup.py: install bin so that the project remains usable via pip
Contributors: Séverin Lemaignan

2.4.0 (2022-04-29)

increase coverage of ROS Query test + only test reasoning if reasoner available
kb.version + export whether reasoner available through ROS Manage service
Contributors: Séverin Lemaignan

2.3.0

Released on 12 Apr 2022

Add ROS support via Revise, Query, Sparql, Manage services

2.2.1

Released on 30 Mar 2022

better error handling/reporting
slightly stricter statement parsing
updated LICENSE to 2022
remove requirement for rdflib >= 6.0.0 (works with RDFlib 4.x.x)

2.2.0

Released on 30 Mar 2022

change find() API to make it more consistent
- whatever the number of variables, always returns a list of dict with the variables as key
- the param ‘vars’ is now optional.
- if no variable is passed, search for all variables by default
- anonymous variables (starting by __) are now named var1, var2,… in the results
removed unused minimalkb/services sub-package

2.1.0

Released on 29 Mar 2022

add kb.label to retrieve (multi-lingual) labels associated to a term
add support for querying direct classes, instances, subclasses, superclasses (via eg kb.details)
significantly simplify the event subscription mechanism. Now, you simply pass a list of patterns with an optional one_shot parameter (false by default)
better API documentation
remove kb.check as it was strictly equivalent to kb.exist
fix bug where loaded ontologies would not be processed by the reasoner
fix internal methods being mistakenly exposed in the API
a few other minor bug fixes

2.0.0

Attention: minimalkb-2.0 is a major rewrite of minimalkb, and only partially backward-compatible with minimalkb-1.x.x

complete rewrite of the core, around rdflib-6.x.x
as a consequence, much more standard-compilant parsing of statements
integration with `reasonable <https://github.com/gtfierro/reasonable>`__ for fast OWL2 RL reasoning.
a new sparql API method has been add, to perform raw SPARQL queries.

Porting notes from 1.x.x:

old compatibility (compat) API methods have been removed
the find API method does not take a constraints parameter any more
retract has been renamed to remove

1.2.1

fix a corner case where conversion of literals to Python object was actually incorrect

1.2.0

literal are now converted to their respective Python type (not yet done for XSD literal like “10^^xsd:integer”)

1.1.2

Main changes since 1.1.2:

create custom readme to please pypi

1.1.1

Main changes since 1.1.0:

fix issue preventing the loading of external ontologies

1.1.0

Main changes since 1.0.0:

fix issue with SQLite triple store where statements were uniquely identified by an unstable hash algorithm.

1.0.0

Main changes since 0.9:

port to python3
added (some) documentation
api: load() can take option ‘models’ parameter
provide more exhaustive API documentation with starting with –debug
added support for OWL2 RL rules cls-thing and cls-nothing1

0.9.0

Main changes since 0.8.1:

fixes + doc in the reasoning engine
clean-up of unit-tests (cf current results below)
a few other minor bugfixes

Unit-tests results:

testing/test.py: 17 tests, 1 expected error (unsupported feature: multiple var in multi-pattern queries) , 0 failure
testing/test_reasoner.py: 5 tests, 0 errors, 0 failures
testing/test_embedded.py: 17 tests, 4 errors, 3 failures

0.8.1

Main changes since 0.8:

version correctly bumped ;-)

0.8.0

Main changes since 0.7:

improved a bit behaviour of memoization: ‘undecided’ reasoning results are not memoized anymore; ‘clear’ also clear memoized results
use only the default model (previously all) when no model is specified
‘lookup’ request has been significantly improved, in particular by taking into account labels.
‘check’ has a first partial implementation (by just checking if checked statement are already asserted)
fix a bad bug leading to models being ignored in an ‘about’ request
fix a race with the reasoner when clearing the database

0.7.0

Main changes since 0.6:

fix a serious issue with events (that were not triggered more than once)
support the NEW_CLASS_EVENT properly
slightly improved the reasoning capabilities: every models are now correctly classified, owl:equivalentClass and a few common owl symmetric predicates (owl:sameAs, owl:differentFrom) are handled to some extend.

Also, compatibility with the C++ liboro bindings (hence, oro-view) has been extended to events.

0.6.0

Main changes:

many improvements to the way minimalKB deals with ending/closing
support for ‘embedding’ minimalKB in a Python application (via ‘pykb.KB’ constructor option)
support for RPC call with keyword arguments
a couple of other bugs smashed out.

0.5.0

Main changes: - support for functional properties (new statements replace existing values instead of adding new facts) - fixed a bug in event id generation that broke the event system - a handful of other minor fixes

0.4.0

Main new features:

fixed incorrect event dispatching when more than one client
support statements with limited lifespan
much extended taxonomy walking (oro-view now works with minimalKB)

0.3.0