WIDOCO: A Wizard for Documenting Ontologies

WIDOCO: A WIzard for DOCumenting Ontologies

Daniel Garijo

Information Sciences Institute, University of Southern California,

@dgarijov

[email protected]

Information

Sciences

Institute

International Semantic Web Conference: Resources Track

Congratulations! You created a stable release of your ontology. However:

WIDOCO: A Wizard for documenting Ontologies. ISWC Resources Track, 2017

Does it have any common pitfalls I am not aware of?

How do I create a human readable version?(possiby in multiple languages)

How do I create proper visualizations?

How can I publish it in a machine readable and human readable manner?

How can I describe my ontology so others can use it?

(OWLDoc)

OBO

PROV

For each ontology version!!!

Challenges

• Lack of guidelines/best practices on ontology documentation and annotation• What metadata is missing in current ontology descriptions?

• Lack of an ecosystem for ontology documentation

• Difficult for non programmers to customize and edit the outcome of existing tools


WIDOCO: Helping users documenting ontologies

Ontology file/URI(TTL, RDF/XML, N3)

- Metadata (e.g., creator,license, date, contributor,

previous version)

- Class definition

- Object property definition

- Data property definition

- Individual definition

Term documentation section

Content negotiation file

(.htaccess)

Ontology file (N3)

Input OutputDocumentation nexus HTML file

- Ontology metadata- Visualization- Term documentation- Change explanation- Provenance- Semantic annotations(JSON-LD Snippets)

Ontology file (TTL)

Ontology file (RDF/XML)

Visualization overview section

Change explanation section

Provenance page

WIZARD

https://w3id.org/widoco/bestPractices



WIDOCO: Documenting ontologies in 4 steps(DEMO)

OntologyMetadata

Term documentation

Visualization

Change explanation

ProvenancePitfall reports

Content Negotiation

JSON-LD annotations

Integrated, expanded or adapted tools:

Expanded Adapted Integrated IntegratedExpanded



Wizard snapshot

Ontology metadata (recognized

automatically )

Missing metadata

Language selection

License enrichment




Community adoption: known usages• Vocabularies

• Spanish Geographical Institute ontologies (BTN 100) (11)

• Vocab.linkeddata.es: vocabularies developed or contributed to by the Ontology Engineering Group (30+)

• Domains: eScience (Smart Protocols, provenance in workflows, etc.), Licensing, Libraries, Videogames, Environment modeling, Quality modeling

• Automated Discovery of Scientific Knowledge (2)

• Paleo Climate data and Observations (6)

• Software descriptions (2)

• Tools for facilitating ontology engineering• OnToology (100+)

• VoCol (10)

http://ontoology.linkeddata.es/

http://ontoology.linkeddata.es/


Testing WIDOCO

35+ ontologies have been used to test WIDOCO:• Big sized ontologies (1000+ classes)

• Ontologies in multiple languages

• Ontology versions

• Ontologies with wrong or missing metadata

• Ontologies with missing imports

• Ontologies mixing local and external imports

• Ontologies in different serializations

• Ontologies with individuals

• Regular ontologies

https://w3id.org/widoco/benchmark

http://w3id.org/widoco/benchmark


Conclusions and future work

• Documentation of ontologies may become a tedious task• Lack of guidelines for documentation/annotation

• Heterogeneous tooling

• Time investment when integrating and editing outcome from existing solutions

• WIDOCO (https://github.com/dgarijo/Widoco/)• Guides users in the process of documenting their ontologies

• Integrates tools for presenting, versioning, publishing, evaluating and visualizing an ontology

• Flexible structure for editing an ontology documentation

• Metadata guidelines: https://w3id.org/widoco/bestPractices

• Testbed: https://w3id.org/widoco/benchmark

• Examples: https://w3id.org/widoco/gallery

• Have you found any problem? Report it: https://github.com/dgarijo/Widoco/issues

• Future work: Address pending issues, support additional metadata properties

https://github.com/dgarijo/Widoco/


https://w3id.org/widoco/benchmark

http://w3id.org/widoco/gallery

https://github.com/dgarijo/Widoco/issues

Contributors:


Tester and OnToology integration: Ahmad Alobaid

Logo designer: Idafen Santana

Feedback Olga Ximena GiraldoMaría Poveda

Code contributors:Miguel Angel GarcíaAlmudena RuizOscar CorchoMartin Scharm

Feedback on publication: Yolanda Gil

GitHub users who opened issues and gave feedback


References

• Tools integrated/expanded by WIDOCO

• LODE: http://www.essepuntato.it/lode/

• WebVOWL: http://vowl.visualdataweb.org/webvowl/

• Bubcastis: https://www.ebi.ac.uk/efo/bubastis/

• Licensius: http://licensius.com/

• OOPS!: http://oops.linkeddata.es/

http://www.essepuntato.it/lode/

http://vowl.visualdataweb.org/webvowl/

https://www.ebi.ac.uk/efo/bubastis/

http://licensius.com/

http://oops.linkeddata.es/

WIDOCO: A WIzard for DOCumenting Ontologies

Daniel Garijo

Information Sciences Institute, University of Southern California,

@dgarijov

[email protected]

Information

Sciences

Institute

International Semantic Web Conference: Resources Track