Skip to main content Link Search Menu Expand Document (external link)
OntoPortal Documentation

Semantic Artefact details

Once the selected semantic artefact has been opened, the summary page shows the different sections. On the left are displayed:

  • A menu with different tabs
  • Metadata (divided in Details and Additional Metadata)
  • Submissions
  • Views of the semantic artefact

details

On the right are displayed:

  • Download button of the semantic artefact, link to the homepage, and associated publications
  • Links to the platform’s social media
  • Link to the REST API JSON entry: to access the the JSON entry users must be logged in
  • Export buttons for metadata in different formats (JSON DATACITE, N-Triple, JSON-LD and RDF/XML)
  • O’FAIRe tool with the score for the selected semantic artefact
  • Metrics table
  • Visits graph showing the monthly number of visualisations of the semantic artefact
  • Projects using the semantic artefact

Metadata Summary

Summary

In the detail area of the summary page, on the left it is displayed the EarthPortal metadata schema for the selected semantic artefact.

Metadata attributes are taken from MOD 2.0. For more information about the metadata schema, click here.

Metadata export

Once the selected semantic artefact has been opened, the summary page shows the different sections. On the left are displayed:

  • A menu with different tabs
  • Metadata (divided in Details and Additional Metadata)
  • Submissions
  • Views of the semantic artefact

FAIR Scores

The FAIR score displayed as “Total score” is specific for the semantic artefact. By selecting the details button, as illustrated below, you can explore sets of questions associated with each FAIR Sub-principle, along with their corresponding credits and utilised metadata properties. The system then automatically computes the score. Detailed view of the o'FAIRe tool Credits and metadata used properties of a question

Metrics

This section describes the metrics that EarthPortal computes for each semantic artefact (Figure 7). Metrics start to be computed when a semantic artefact is uploaded and they are part of EarthPortal Metadata Schema.

There are two groups of metrics:

  • statistical metrics;
  • quality-control and quality-assurance metrics.

Metrics area of the summary page of a semantic artefact

Note: some metrics are meaningful only for semantic artefact in a specific representation language (e.g., there are no individuals to count in the ontologies in OBO format).

The Statistical Metrics include:

  • Number Of Classes: the number of named (not anonymous) classes in the semantic artefact
  • Number Of Individuals: the number of individuals in the semantic artefact
  • Number Of Properties: the number of properties or slots in the semantic artefact
  • Maximum Depth: the maximum depth of the hierarchy tree:
    • for OWL, RDFS, Protege, and UMLS RFF ontologies, only the “is-a” relationship is considered a hierarchical relationship
    • for OBO ontologies, the following relationships are considered as hierarchical relationships: “is-a”, “has-part”, “inverse” and “develops-from”
  • Maximum Number Of Children: the maximum number of children in the semantic artefact
  • Average Number Of Children: the average number of children at one level in the tree

Quality-Control and Quality-Assurance Metrics provide some indication of the quality of the semantic artefact and help semantic artefact authors to improve their quality. The maximum value allowed for all metrics is currently set to 200. Ontologies with more than 200 classes in a category will still have the total number of classes in that category counted, but no list will be available. Please notice that:

  • Classes With A Single Child: a list of classes with only one subclass in the hierarchy. While technically there is no problem in having only one subclass, this situation often indicates that either the hierarchy is under-specified, or that the distinction between the class and the subclass is not appropriate;
  • Classes With More Than 25 Children: a list of classes that have more than 25 direct subclasses. A class that has more than 25 subclasses could benefit of additional distinctions and categorization;
  • Classes With No Definition: a list of classes that have no value for the definition property. For ontologies in OBO and RDRF formats, the property for definition is part of the language. For OWL ontologies, the authors specify this property as part of the ontology metadata (the default is “skos:definition”).

For more details about the metrics generation, please read this. EarthPortal users will be able to access semantic artefact metrics in two ways:

  • through the EarthPortal user interface, in the metrics area of the summary page (see example here);
  • through a dedicated REST service that returns a JSON (see example below).

The following REST service can be used: https:///ontologies/OntologyAcronym/metrics?apikey=YourAPIKey The service returns a JSON that contains the version id for the semantic artefact and the values for the metrics.

If a given semantic artefact has more than 200 classes identified for a metric, then that metric will provide an error message within the class list. Two messages can appear:

  • limitpassed: it means that the 200-class limit was reached. When this error appears, it is followed by the total number of classes in the semantic artefact that matches this metric;
  • alltriggered: it means that every class in the semantic artefact matched this metric.

Submissions

Submissions table

In the submission area, all submissions made for that semantic artefact are available. The table includes four columns:

  • Version: shows the different versions loaded into EarthPortal with the status next to it. The labels assigned automatically by the portal are: Parsed (the resource has been parsed), Indexed (the resource has been indexed), Metrics (the metrics for that resource have been calculated) and Annotator (the resource is ready to annotate some text via API or the Annotator tools). EarthPortal indexes the latest submission. The previous submissions will appear with the “Archived” label, which means that submission will no longer be published;
  • Released: shows the original release date (mm/dd/yy) of the resource (manually set by the user);
  • Modified: shows the latest modification date (mm/dd/yyyy) of the semantic artefact.
  • Uploaded: shows the initial publication date (mm/dd/yy) of the resource in EarthPortal (automatically assigned by the system);
  • Downloads: allows the download of the resource in different formats SKOS, OBO, UMLS, OWL, CSV, RDF/XML, depending on the representation language of the resource. Furthermore, when more submissions occur for the same resource, the system performs an automatic download report (Diff) of the differences between the submitted versions.

Views

This area displays the semantic artefact views and allows the creation of new ones. A view is a manageable portion of a larger semantic artefact that is tailored for specific applications and users. When creating a view, the system:

  • allows the precise extraction of subsets from a larger resource;
  • allows to personalise and use portion of a resource;
  • facilitates interoperability between subsets of large semantic artefacts and specific applications. Each displayed view is linked for an easy consultation.

Projects

In this section, you’ll find showcased projects utilising the chosen semantic artefact, with convenient links for easy reference. Logged in users can create new projects. These projects serve as a guide for users to explore semantic artefacts associated with specific projects, offering insights into the contextual usage of these semantic artefacts. Each project page includes a concise project description and a link to the project’s homepage.

The menu area enables you to explore classes, properties, notes, mappings, and available widgets through tabs. When the chosen resource is a thesaurus, three distinct tabs emerge: the “Classes” tab is substituted with “Concepts,” “Schemes,” and “Collections”.

Classes

On the summary page of the semantic artefact, by clicking on tab “Classes”, it is shown:

  • on the left side, different views of the resource. If it is an ontology, you will see the “Hierarchical view”, in which classes are organised in a tree-like structure, and the “Date view”, which displays classes based on their creation and modification dates (if these were defined). In the case of a thesaurus the “Collection view” will also be available. In addition, close to the search bar, there is a filter to select different schemes eventually available within a thesaurus;
  • on the right side, an area containing Details, Visualization, Notes and Mappings related to the selected class or concept:
  • Details: tab showing properties and relationships associated with the selected class/concept. Properties like ID, Preferred Name, Definition, and Type are always shown, whereas the remaining properties displayed will vary depending on the resource’s representation model (SKOS; OWL; UMLS; OBO). View classes of a specific ontology - details View classes of a specific thesaurus - details
  • Visualization: EarthPortal presents semantic artefacts in a graph format, with resource concepts represented as nodes and the relationships between them as edges. By default, the most basic directional relationships (parent/child relationships) are identified by a solid navy-blue line with an arrow pointing to the child concept/class. Mappings are represented by solid light-grey lines. View classes of a specific semantic artefact - visualization
  • Notes: it displays all notes issued by EarthPortal users in relation to the selected class/concept. To issue generic comments or proposals regarding new classes, new relationships, or change properties, users must be logged in.
  • Class/Concept Mappings: tab showing all the mappings associated with the selected class/concept. For each mapping you can see:
    • MAPPING TO: the name of the selected class/concept mapped to the class/concept of another resource;
    • ONTOLOGY: the semantic artefact of the mapped class/concept;
    • RELATIONS: the type of relation that the algorithms have used;
    • SOURCE: the mapping algorithm;
    • TYPE: the mappings can be internal to the portal or external to the portal;
    • ACTIONS: the mappings can be edited or deleted by the administrator of the resource. Logged in users can click on the “Create new Mapping” button to manually insert mappings by filling in the following fields: target semantic artefact or view; target class; details; comment; mapping relation type. View classes of a specific semantic artefact - mappings

Properties

In the summary page of the chosen semantic artefact, by clicking on the Properties tab all the properties used within the selected semantic artefact are displayed. Similar to the Classes tab, the interactive property tree is shown on the left, while the property details are shown on the right. View properties of a specific semantic artefact

Notes

In the Notes tab users can see all the comments or proposals issued by other registered EarthPortal users. View notes of a specific semantic artefact

  • Add a comment: logged in users can send a comment to the owner of the resource by specifying the subject and writing a free text comment.
  • Add a proposal: logged in users can send a proposal to the owner of the resource to modify or create new relationships or classes/concepts.
  • Subscribe/Unsubscribe to notes emails: users can subscribe to receive emails whenever comments or proposals from other users are provided. Users can manage their subscriptions on the “Account Settings” page and click on the “Unsubscribe” link to stop receiving emails.

Mappings

In the Mappings tab all the mappings of the selected semantic artefact are displayed. The table includes two columns: semantic artefact and Mappings. The first column identifies the semantic artefact to which the selected resource is mapped, and the second column shows the number of mappings. By clicking on a semantic artefact all the mappings are shown. View mappings of a specific semantic artefact

Schemes

In the Schemes tab, which is specific to thesauri, all the skos:conceptSchemes available in the selected resource are displayed. By clicking on a scheme more detailed information is found. View schemes of a specific semantic artefact

Collections

In the Collections tab, which is specific to thesauri, all the skos:collections available in the selected resource can be browsed. By clicking on them detailed information is shown. View collection of a specific semantic artefact

Widgets

Widgets tab contains the different types of widgets that can be incorporated in a web page (Figure 19). The page is divided in two sides, “Widget type” with the “Get code” buttons which lead to short instructions and to the download link of the code to be incorporated, on the right, their relative demos. The types of widgets available in EarthPortal are:

  • Jump To: type a class in the selected semantic artefact and jump to it in EarthPortal;
  • Form Autocomplete: fill in a field in your form with a class from the selected semantic artefact;
  • Visualization: display a visualisation for a given class/concept in the selected semantic artefact;
  • Tree Widget: display a tree for classes in the selected semantic artefact with a search field.

View widgets of a specific semantic artefact