(I) Comments on the FIBO Viewer


SubjectCommentsFIBO Viewer
SearchNo search commandDONE
Diagram panel

Comments on the diagram panel

  • Bubbles overlap in the diagram – hard to see everything
  • Why is the panel called “Data model ..."?
    • the ‘data’ shown are really semantic metadata, are they not?
    • also, ‘model’ suggests a more complete set of information, and what is shown are only immediate semantic properties.
    • Perhaps “Semantic graph view for …” might be more appropriate than “Data model for …” ?
    • After double-clicking on a class or property in the graph view, the entire web page is redisplayed and left positioned at the top, with the home page banner, etc. One has to scroll down in order to re-engage with the graph.
    • Admittedly this action causes new data to be loaded and a refresh is required, but perhaps the graphical viewer should be displayed in a panel that is independent of the main page so that navigating the graph can be more continuous and without being visually reset out of view?

TO DO

  • ...



DONE

  • ...
UX

Too much clutter at the top. Causes too much scrolling.

The user-interface still looks a bit old-school, like the whole EDMC site. If there's budget now I would suggest to ask a designer to give it an upgrade.

It is not a really modern site.


Instances

Instances should be treated separately.

In many cases, I agree, but not all instances are alike!

We need to separate:

  • Enumerated values (since we’re using things not strings) which are part of the ontology and should not be “treated separately”
  • Examples, for illustrative purposes
  • Test data, which will often be artificial to stretch one or more (ideally more) ontologies with minimal volume
  • Reference data (an example of which is the MarketsIndividuals) Jacobus referenced where we’re transforming external data and publishing it in a FIBO-compatible RDF form with our own URIs

IRIsI don't like the IRI scheme for the site. It uses old-school "?query=" rather than a REST model. For every "thing" you look at, whether it's an Ontology, a Class, a Property or an Individual you should be able to see an updated IRI in the browser that corresponds to the IRI of that thing one to one. It would also make it easier to use these IRIs in real world banking applications, if people drill down deep enough on the metadata in an internal bank web app (or document or excel sheet) they would eventually end up on the EDMC site.
Links

Also, without obvious links to the other products, especially the OWL, it looks like another glossary.

What's missing:

  • Link to the OWL file (in multiple formats)
  • Link to the corresponding git versions
  • List of all the versions including their version IRIs (https://spec.edmcouncil.org/fibo/ontology/<branch>/<tag>/....)
  • List of all the git commits including their associated JIRA tickets
  • List of all the pull requests including test results and logs
  • All shown file names like "Corporations.rdf" should be links
  • All shown URLs / IRIs should be clickable and resolvable

Graphs

Especially missing is an overall graph.


NL questions

Missing: Cory's idea was to ask NL questions of intent and then navigate from there.


Lego Blocks

Missing: Dennis's Lego Blocks idea - caned models for individual purposes.


Ignorance

And it ignores the requirements we spent many weeks gathering and documenting in our own Wiki with, and for, a variety of stakeholders.

There were 5 years of requirements collected and seemingly all ignored.



(II) Specification for User-Friendly Web Pages for Ontology Elements

1. Generic Content (applies to any type of Element)

Type of contentViewAlways shown / on requestView contentFIBO Viewer

Generic Content

(applies to any type of Element)


Note: any URLs (and ontology URIs) should be recognized and made clickable, including references from annotations.

Glossary/Business User View

Always shown

  • Primary label
  • Synonyms
  • Definition
  • Explanatory Note
  • Logical Description (generated)
  • Type (i.e. Class/Noun - open issue what terminology)
  • Ontology/Module/Domain hierarchy
  • Maturity

TO DO

  • ...



DONE

  • ...

On request

  • Term origin
  • Adapted from
  • Definition origin
  • (not Editorial Note which is for maintainers)
  • IRI
  • Version


Taxonomy and Structure Views


All of the above

  • Access path (different groupings, probably hierarchic, and navigations reflecting different usage context)


Ontologist View

Always shown

All of the above, using the actual predicates, except:

  • Logical Description (generated)


On request

  • All annotations


2. Domain/Module content

Type of contentViewAlways shown / on requestView contentFIBO Viewer

Domain/Module content


This is what will be shown for a Business Domain/Module (not part of OWL but used in FIBO), in addition to the  Generic Content (applies to any type of Element)

They are used for packaging and navigation.

Glossary/Business User View

Always shown

  • Children (either other modules or ontologies)


On request

  • Full child hierarchy 


Taxonomy and Structure Views


  • As per glossary/taxonomy view


Ontologist View


  • As per glossary/taxonomy view


3. Ontology content

Type of contentViewAlways shown / on requestView contentFIBO Viewer

Ontology content


This is what will be shown for an Ontology, in addition to the  Generic Content (applies to any type of Element)

Glossary/Business User View

Always shown

  • List of resources within the ontology, together with their name, synonym(s) within configured scope/reach, type, definitionProvide an option for different arrangement e.g. alphabetically, by type


On request

  • Full glossary detail for each item (will vary by type) 


Taxonomy View

Always shown
  • Class hierarchies scoped to each class in ontology (a number of trees, showing subclass relationships among the classes)


On request
  • Inferred hierarchy (e.g. due to equivalentClass relationships)
  • Expand class  hierarchy upwards either one level or complete (may reduce the number of roots)

Structure ViewAlways shown
  • Property hierarchies scoped to each property in ontology (a number of trees, showing subproperty relationships among the properties)

On request
  • Inferred hierarchy (e.g. due to equivalentProperty relationships)
  • Expand property hierarchy upwards either one level or complete (may reduce the number of roots)

Ontologist View

(As per glossary/taxonomy view)

Always shown

  • Imported ontologies
  • Resources defined (includes individuals)


On request

  • Ontologies importing this one

  • Transitive closure of imports

  • Assertions not covered in other ways e.g. involving individuals


4. Class content

Type of contentViewAlways shown / on requestView contentFIBO Viewer

Class content


This is what will be shown for a Class in an ontology, in addition to the  1. Generic Content (applies to any type of Element)

Glossary/Business User View


  • No additional content


Taxonomy View

Always shown
  • Immediate superclasses (excluding restrictions and other blank node class expressions which are covered by the generate business logic)


On request
  • Complete superclass hierarchy

    Immediate subclasses

    Complete subclass hierarchy


Structure ViewAlways shown
  • As for taxonomy

    Properties for which this is the domain, including the following - taking into account any restrictions applying to the current class

    • whether a candidate key (e.g. inverse functional, key)
    • range
    • inverse
    • multiplicity (e.g. based on restrictions, functional properties)

On request
  • As for taxonomy


    Properties for which this is the range, including the domain

    Properties for which superclasses are the domain (inherited properties) including superclass name; also properties which have a minCardinality restriction

    (Additional request) Properties which (implicitly) have owl:Thing as domain


Ontologist View

Always shown

  • As for structure

    Properties commonly used for this class (for which superclasses are the domain with min cardinality of 0 (inherited properties))

    Necessary restrictions, including full detail e.g. property and class (hyperlinked)

    Necessary and sufficient restrictions

    Disjoint classes

    Equivalent classes/expressions


On request

  • As for structure

    Individuals

      Primary label

    Restrictions using this class (e.g. All Values from X)

    Expressions using this class (e.g. Unions used as range of a property)

    Ontologies dependent on this class (that reference it in some way e.g. through domains, ranges, expressions)


Idea

Find shortest/all paths from this class to another specified class


5. Property content

Type of contentViewAlways shown / on requestView contentFIBO Viewer

Property content


This is what will be shown for a Property in an ontology, in addition to the  Generic Content (applies to any type of Element)

Glossary/Business User View


  • No additional content


Taxonomy View

Always shown
  • Immediate superproperties


On request
  • Complete superproperty hierarchy

    Immediate subproperties

    Complete property hierarchy


Structure ViewAlways shown
  • As for taxonomy

    Domain and range and multiplicity/key constraints

    Derivations (property chain)

    Inverse property


On request
  • As for taxonomy

    Superclasses of the domain and range (classes this property may be used with)

    Classes required/restricted to use this property


Ontologist View

Always shown

  • As for structure

    Classes commonly using this property (for which superclasses are the domain with min cardinality of 0 (inherited properties))

    Equivalent class restrictions on this property

    Subclass restrictions on this property

    Disjoint properties

    Equivalent properties


On request

  • As for structure

    Expressions using this property

    Ontologies dependent on this property (that reference it in some way e.g. through restrictions)


6. Individual content

Type of contentViewAlways shown / on requestView contentFIBO Viewer

Individual content


This is what will be shown for an Individual, in addition to the  Generic Content (applies to any type of Element)

Note that Individuals will generally be used for examples.

Glossary/Business User View

Always shown

  • Type(s) of which this is a asserted instance.

    Properties and their values for triples for which is the subject


On request
  • Type(s) of which this is a inferred instance.

Properties and their values for triples for which is the object 


Taxonomy and Structure Views


  • As per glossary view


Ontologist View


  • As per glossary view, possibly using different terminology e.g. NamedIndividual


7. Datatype content

Type of contentViewAlways shown / on requestView contentFIBO Viewer

Datatype content

Glossary/Business User View

Always shown

  • Type(s) of which this is a asserted instance.

    Properties and their values for triples for which is the subject


Taxonomy and Structure Views

On request
  • (As per glossary view)

  • Properties which have this type as their range


Ontologist View

On request

  • Full technical details including enumerations and facets


  • No labels

1 Comment

  1. I want to second the request for a search mechanism; the one in the FIBO Glossary (e.g., https://spec.edmcouncil.org/fibo/glossary_development.html) is very slick, and has got compliments from users regularly ever since we released it.  The search mechanism in the viewer should be at least as good.  A complaint I have got from that search widget is that it shows a limited number of hits; sometimes, there are more hits in FIBO than the widget can hold.