make richer diagrams

[VladimirAlexiev]

We got some diagrams in https://github.com/Accord-Project/aec3po/tree/main/resources, but we should strive to make richer diagrams as in DiCon, see #32 for an example.

The diagrams should make it clear:

• How to use classes and properties (i.e. illustrate the RDF shape of the data)
• To which external terms we have coreferences

We use the same graphical notation, so it should be easier to accommodate graphical constructs as in DiCon. @maximelefrancois86 , I see you use Draw.io, but which stencil is this?

[EdliraK]

I agree and yes is in our todo list. We also like how DiCON is documented. BRICK is also a good example @AmnaKRDB as we have discussed before. @tanhe-git we need to coordinate with Tan as well as their task is pure in documentation.

[VladimirAlexiev]

@AmnaKRDB @maximelefrancois86 @EdliraK What notation did you use, is it Chowlk?

• Here's a Chowlk example from the BIMERR project, so I think you used Chowlk:
• Do you use the Chowlk-OWL generator? See "Chowlk- from UML-based ontology conceptualizations to OWL (ESWC 2022, by UPM)

---

Another great notation is Grafoo, it can also generate OWL from the diagram (DITTO). I have a bunch of Grafoo examples (in g:\Shared drives\KGS\data-tools\ontology\editors, visualization\Grafoo):

• legend
• legend2
• examples about the SPAR ontologies (see #36): bido.png BiRO.png BIRO2.png CitationCounting module.png dapo.png datacite.png doco architecture.png FaBiO skos relations.png frbr-properties.png InTextReferencePointer example.png InTextReferencePointer module.png lapo.png pro.png pso.png pwo.png scoro.png SCoRO basic model.png SPAR core architecture.png workflow1.png workflow2.png workflow3.png

[EdliraK]

Yes we used Chowlk.

[maximelefrancois86]

As a complement, we use Chowlk only for preparing the diagrams. Not for generating the OWL. Actually I'd like Chowlk to do the other way around: help generate nice figures from an ontology

Now each the documentation of each module may have its own diagram, like

https://w3id.org/lbd/aec3po/document

and

https://w3id.org/lbd/aec3po/feature_of_interest