Join GitHub today
GitHub is home to over 31 million developers working together to host and review code, manage projects, and build software together.Sign up
What is the purpose of OnAGUI ?
OnAGUI is a software to help align vocabularies, thesauri, ontologies. "Aligning" means creating a mapping between the items of the 2 vocabularies.
How does OnAGUI work ?
OnAGUI can :
- read both vocabularies and display them in trees (one on the left, one the right)
- run automated algorithms to match vocabulary items based on their label proximity
- display the proposed alignment in a table in the center, so that we can review, adjust, delete or create more correspondances
How do I install OnAGUI ?
To install OnAGUI :
- you first need to install Java
- download the latest OnAGUI release
- unzip it
- run either "run.bat" on Windows or "run.sh" on Linux
How do I get started ?
To get started :
- You need a vocabulary in SKOS. Many tools can generate this format; if you start from plain CSV or Excel files, you can use the SKOS-Play Excel converter to generate SKOS files;
- You need another vocabulary in SKOS, obviously the one with which you need to get aligned; you could start by looking at the UNESCO Thesaurus or the Eurovoc thesaurus, both available in SKOS, if you want to play with something;
- Download, install and run OnAGUI;
- Load your vocabulary from the menu "File > Load vocabulary 1 > Load in SKOS"; you can browse it in the left tree;
- Load the vocabulary you need to align to with the menu "File > Load vocabulary 2 > Load in SKOS"; you can browse it in the right tree;
- Now run a linguistic alignment from the menu "Alignement > I-Sub distance", and here select :
- the part of the vocabularies you want to align (whole vocabulary or only a sub-branch);
- the language you want to use for automatic alignment;
- a threshold score for the alignement; 0.9 is proposed by default, you can lower this a bit to 0.8; the lower the value, the more mappings you will get, but also the more noise !
- Mappings are shown in the table in the center of the screen; you can edit the table by :
- editing the types of mappings (exactMatch are produced by default);
- deleting a mapping line in the table;
- adding a new mapping line in the table (select concept on both trees, select mapping type, and click on "Add" button)
- Export your mapping from the menu "File > Export Alignement > Export in SKOS" to generate SKOS mapping properties, or "Export in RDF" to generate an RDF EDOAL file, more expressive;
What are the included alignment algorithms ?
- I-Sub distance works best. The algorithm is in this java class, from this paper
- Levensthein distance is a classic
- Exact match on the labels
The algorithms do not take into account upper/lower case or accented characters ("Sémantique" will be matched exactly to "SEMANTIQUE").
In which languages is OnAGUI available ?
OnAGUI is available in French and English. You can contribute new translations by translating these message files.
Which vocabularies/ontologies can OnAGUI align ?
- SKOS thesauri/vocabularies
- OWL ontologies
- arbitrary RDF with common labelling properties; the supported label properties are :
- and as alternative label properties :
- for more details see the class RDFModelContainer
In which formats can the alignment be exported ?
- EDOAL is the most comprehensive model
- SKOS alignment
Who created OnAGUI ?
Laurent Mazuel and Jean Charlet at INSERM, in France.
I need help !
File an issue here !