Skip to content

Commit

Permalink
Improved Documentation
Browse files Browse the repository at this point in the history
  • Loading branch information
janothan committed Aug 24, 2020
1 parent 7eff386 commit 2b249bc
Show file tree
Hide file tree
Showing 6 changed files with 57 additions and 10 deletions.
20 changes: 11 additions & 9 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,16 +16,19 @@ Found a bug? Don't hesitate to <a href="https://github.com/dwslab/melt/issues">o
```
Hertling, Sven; Portisch, Jan; Paulheim, Heiko. MELT - Matching EvaLuation Toolkit. SEMANTICS. Karlsruhe, Germany. 2019.
```
An open-access version of the paper is available <a href="https://link.springer.com/content/pdf/10.1007%2F978-3-030-33220-4_17.pdf">here</a>.
The accompanying presentation can be found in the <a href="https://github.com/dwslab/melt/blob/master/documentation/MELT_presentation_semantics.pdf">documentation directory</a>.
An open-access version of the paper is available <a href="https://link.springer.com/content/pdf/10.1007%2F978-3-030-33220-4_17.pdf">here</a>.<br/>
The accompanying presentation can be found in the <a href="https://github.com/dwslab/melt/blob/master/documentation/MELT_presentation_semantics.pdf">documentation directory</a>.<br/>
You can find the LaTex bib entry of the paper [here](/documentation/melt_semantics_19.bib).

*Demo Paper (MELT Dashboard)*
```
Portisch, Jan; Hertling, Sven; Paulheim, Heiko. Visual Analysis of Ontology Matching Results with the MELT Dashboard. ESWC 2020 - Posters and Demos. Heraklion, Greece. 2020.
```
An open-access version of the paper is available <a href="https://arxiv.org/pdf/2004.12628.pdf">here</a>.<br/>
The poster can be found in the <a href="https://github.com/dwslab/melt/blob/master/documentation/eswc_2020_melt_dashboard_poster.pdf">documentation directory</a>.<br/>
A simple demo for the <a href="http://oaei.ontologymatching.org/2019/anatomy/index.html">OAEI 2019 Anatomy</a> and <a href="http://oaei.ontologymatching.org/2019/conference/index.html">OAEI 2019 Conference</a> tracks can be found <a href="https://dwslab.github.io/melt/anatomy_conference_dashboard.html">here</a>.
A simple demo for the <a href="http://oaei.ontologymatching.org/2019/anatomy/index.html">OAEI 2019 Anatomy</a> and <a href="http://oaei.ontologymatching.org/2019/conference/index.html">OAEI 2019 Conference</a> tracks can be found <a href="https://dwslab.github.io/melt/anatomy_conference_dashboard.html">here</a>.<br/>
You can find the LaTex bib entry of the paper [here](/documentation/melt_dashboard_20.bib).


## Code Examples
The [examples folder](/examples/) contains reference examples that you can use to better understand how MELT can be used for different tasks and that can be used as barebone project for specific applications.
Expand Down Expand Up @@ -141,8 +144,7 @@ analyzed using a spreadsheet program such as <a href="https://www.libreoffice.or
memory issues with `EvaluatorCSV` on very large evaluation problems. Note that this evaluator offers less
functionality than the default evaluator.
- `EvaluatorMcNemarSignificance`: An evaluator for statistical significance tests.
This evaluator allows to check whether multiple alignments
are significantly different.
This evaluator allows checking whether multiple alignments are significantly different.
- `DashboardBuilder`: This evaluator generates an interactive Web UI (*MELT Dashboard*) to analyze alignments
in a self-service BI fashion. You can find an exemplary dashboard for the OAEI 2019
<a href="http://oaei.ontologymatching.org/2019/anatomy/index.html">anatomy</a> and <a href="http://oaei.ontologymatching.org/2019/conference/index.html">conference</a> track <a href="https://dwslab.github.io/melt/anatomy_conference_dashboard.html">here</a>.
Expand Down Expand Up @@ -207,7 +209,7 @@ in a self-service BI fashion. You can find an exemplary dashboard for the OAEI 2

### OAEI Track Repository
The [`TrackRepository`](/matching-eval/src/main/java/de/uni_mannheim/informatik/dws/melt/matching_eval/tracks/TrackRepository.java)
checks whether the required ontologies and alignments are available in the cache folder (`~/oaei_track_cache); if data is missing, it is automatically downloading and
checks whether the required ontologies and alignments are available in the cache folder (`~/oaei_track_cache`); if data is missing, it is automatically downloading and
caching it for the next access.

Exemplary call using the `TrackRepository`:
Expand Down Expand Up @@ -268,9 +270,9 @@ by adapting the [`TestLocalFile`](/matching-validation/src/test/java/de/uni_mann
and running `runAll.cmd` in the Windows shell. The release versions to be tested can be edited in the corresponding
[`pom.xml`](/matching-validation/pom.xml).

### Gensim Integration
The MELT-ML module exposes some machine learning functionality that is implemented in python. This is achieved
through the start of a python process within java. The communication is performed through local HTTP calls. This
### Python Integration
The MELT-ML module exposes some machine learning functionality that is implemented in Python. This is achieved
through the start of a python process within Java. The communication is performed through local HTTP calls. This
is also shown in the following figure.

![image](documentation/melt_ml_architecture.png)
Expand Down
6 changes: 6 additions & 0 deletions documentation/melt_dashboard_20.bib
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
@inproceedings{melt_dashboard,
title={Visual Analysis of Ontology Matching Results with the MELT Dashboard},
author={Portisch, Jan and Hertling, Sven and Paulheim, Heiko and Visual, A and Matrix, Confusion},
year={2020},
booktitle = {The Semantic Web: ESWC 2020 Satellite Events}
}
Binary file modified documentation/melt_ml_architecture.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified documentation/melt_ml_architecture_image.odp
Binary file not shown.
39 changes: 39 additions & 0 deletions documentation/melt_semantics_19.bib
Original file line number Diff line number Diff line change
@@ -0,0 +1,39 @@
@inproceedings{melt,
author = {Sven Hertling and
Jan Portisch and
Heiko Paulheim},
title = {{MELT} - Matching EvaLuation Toolkit},
booktitle = {Semantic Systems. The Power of {AI} and Knowledge Graphs - 15th International
Conference, SEMANTiCS 2019, Karlsruhe, Germany, September 9-12, 2019,
Proceedings},
pages = {231--245},
year = {2019},
crossref = {DBLP:conf/i-semantics/2019},
url = {https://doi.org/10.1007/978-3-030-33220-4\_17},
doi = {10.1007/978-3-030-33220-4\_17},
timestamp = {Fri, 31 Jan 2020 21:32:22 +0100},
biburl = {https://dblp.org/rec/conf/i-semantics/HertlingPP19.bib},
bibsource = {dblp computer science bibliography, https://dblp.org}
}

@proceedings{DBLP:conf/i-semantics/2019,
editor = {Maribel Acosta and
Philippe Cudr{\'{e}}{-}Mauroux and
Maria Maleshkova and
Tassilo Pellegrini and
Harald Sack and
York Sure{-}Vetter},
title = {Semantic Systems. The Power of {AI} and Knowledge Graphs - 15th International
Conference, SEMANTiCS 2019, Karlsruhe, Germany, September 9-12, 2019,
Proceedings},
series = {Lecture Notes in Computer Science},
volume = {11702},
publisher = {Springer},
year = {2019},
url = {https://doi.org/10.1007/978-3-030-33220-4},
doi = {10.1007/978-3-030-33220-4},
isbn = {978-3-030-33219-8},
timestamp = {Fri, 31 Jan 2020 21:32:22 +0100},
biburl = {https://dblp.org/rec/conf/i-semantics/2019.bib},
bibsource = {dblp computer science bibliography, https://dblp.org}
}
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ public class AdditionalConfidenceByFunction extends MatcherYAAAJena{
/**
* This adds a confidence by a given function.
* The key for the confidence is AdditionalConfidenceByResourceFunction (so only use it once in a pipeline).
* @param function the function to compute the confidence. Class {@link AdditionalConfidenceByResourceFunction } has also some default functions.
* @param function the function to compute the confidence. Class {@code AdditionalConfidenceByFunction} has also some default functions.
*/
public AdditionalConfidenceByFunction(Function<OntResource,Double> function){
this(new AbstractMap.SimpleEntry<>("AdditionalConfidenceByFunction", function));
Expand Down

0 comments on commit 2b249bc

Please sign in to comment.