search

RDFLib / pyLODE

An OWL ontology documentation tool using Python and templating, based on LODE
BSD 3-Clause "New" or "Revised" License
162 stars 70 forks source link

Reference ontology for each profile #142

Open GordianDziwis opened 3 years ago

GordianDziwis commented 3 years ago

I am building a ontology publishing pipeline with nextflow. For documentation, reference and testing it would be nice to have a reference ontology for each profile. This ontology should make use of every feature pylode understands.

I started with an ontdoc ontology here. As a starting point I am taking:

Can you point me to other resources?

graybeal commented 3 years ago

Well, as ESIP's COR (cor.esipfed.org) include pyLode display for many of its ontologies (e.g., http://cor.esipfed.org/ont?iri=https://w3id.org/geoscienceontology/common/ontology — look under the Data section for the pyLode button, and wait about 5 seconds for it to show up), it would make fertile testing ground.

When you feel like being really aggressive, you could try the ontologies in BioPortal (https://bioportal.bioontology.org/ontologies), as some of them are very large and complex. I hope we can make PyLode an option in BioPortal someday too

GordianDziwis commented 3 years ago

Wow, there a 1GB ontologies. I tried to generate documentation for the biggest one, but after half and our it was still running. Did you do any tests and have a ballpark figure for what pylode can handle?

GordianDziwis commented 3 years ago

How do the profiles relate to each other? Where can I see, what pylode picks up with each profile?

Does pylode understand this independent of the selected profile?

nicholascar commented 2 years ago

I'm about to start work on pyLODE 3.0.0 and I'll do a much better job of explaining what's known by each profile! First I'll define each profile itself and then ensure that the code that generated HTML for each profile actually follows the profile definition. Sadly, through laziness on my behalf, the profiles that pyLODE declares it knows about are not well defined.

A profile that pyLODE doesn't yet use but that is well defined is VocPub. Its Specification Document tells you what is in the profile, in English. Its Validator describes the same in SHACL. So expect the various pyLODE profiles to look like that soon.

nicholascar commented 2 years ago

Ontology profile now formally defined: https://w3id.org/profile/ontpub. pyLODE 3's not yet aligned with it but it will be, as per Issue #164