https://github.com/solidlabresearch/ldes-semantic-web-thing
https://github.com/solidlabresearch/ldes-semantic-web-thing
Last synced: 11 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/solidlabresearch/ldes-semantic-web-thing
- Owner: SolidLabResearch
- Created: 2023-04-03T13:54:18.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2023-08-30T12:40:35.000Z (over 2 years ago)
- Last Synced: 2025-01-17T07:09:43.984Z (about 1 year ago)
- Language: Java
- Size: 68.5 MB
- Stars: 0
- Watchers: 4
- Forks: 0
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# LDES-Semantic-Web-Thing
## Name
LDES-Semantic-Web-Thing
## Description
Aggregations and data summaries allow to provide succinct view on larger dataset. However, to be useful for non-technical users, visualisation is needed the easily interpret the summarised data. Aggregations and summaries from the DAHCC dataset are used for purpose, which contains data streams describing the behaviour of various patients. Specifically, a visualisation of the patients activity is used. This visualisation directly connects to the streaming aggregator defined in Challenge #84 while the Semantic Dashboard will be used for the visualisation itself.
## Solution
The generic visualisation components connects to the aggregator service and allows to visualise the results in the semantic dashboard. The latter allows to specify in a generic manner how to present the visualisation itself. To enable this, a mapping of the internal data of the aggregator to the data format used by the semantic dashboard is necessary (which is build around webThing).
Below a screenshot of the sample deployment.
## Screencast
Below a screencast of the sample deployment.
https://user-images.githubusercontent.com/19285142/230082536-e87f4466-2053-4f13-9fe3-9ed781d9360f.mp4
## Functionality
The visualisation is able to:
1. Connect with the aggregation service (as defined in Challenge #84)
2. Map the internal results of the aggregator to the format used by the semantic dashboard (which uses webThing)
3. Allow specifying how to visualise the results in the semantic dashboard
## Installation
### Pre-requisites
1. A running Aggregator service, defined by Challenge #84: https://github.com/argahsuknesib/solid-stream-aggregator
2. The Comunica SPARQL Link Traveral Engine: https://github.com/comunica/comunica-feature-link-traversal/tree/master/engines/query-sparql-link-traversal-solid#usage-as-a-sparql-endpoint.
* Example usage: `comunica-sparql-link-traversal-solid-http -p 8081 --idp void http://localhost:3000/aggregation_pod/data/ --lenient`
* The example runs the Comunica engine locally on port 8081, connects without user credentials to the Solid Pod containing the Aggregator data in a
SolidEventSourcing (https://github.com/woutslabbinck/SolidEventSourcing/) compatible manner.
3. Java version: (currently running on) >= openjdk 16.0.1 2021-04-20 (it has been compiled against: Oracle JDK 16.0.2).
### Binary utilisation
Clone the GIT repository: https://github.com/SolidLabResearch/LDES-Semantic-Web-Thing.git
The binary can be found in the bin-folder, immediately below root.
Running this binary can be accomplished using the command: `java -jar ldeswebthing-v0.0.1.jar`
### Compiling from source
Apache Maven is used as software management tool for this project, more specifically, in our situation Apache Maven 3.6.3 was used.
1. Executing `mvn clean install` in the root folder of the project should start the compilation process.
### Configuration Properties
In the folder `src/main/resources`, a number of properties files can be found to finetune your own configuration.
1. `app.properties`: This file contains some general properties.
* `DATASET_ID`: A unique dataset identifier
* `LDES_ENDPOINT`: The location of the LDES Solid Pod to be used.
* `ROOT_URL`: Specification of the Root URL for the semantic observations.
2. `semantic-data.ttl`: This file specifies (a.o. to the Dynamic Dashboard) what data is exposed, and which semantics are used. More information can be found in the documentation of that platform. (http://dx.doi.org/10.3390/s20041152).
3. `metrics.ttl`: Enlists all possible semantic annotations that can be used to inform the Dynamic Dashboard about the characteristics of the data provided by the SWT.
## Support
Stijn.Verstichel@UGent.be