search

w3c / sdw-sosa-ssn

Repository of the Spatial Data on the Web Working Group for the SOSA/SSN vocabulary
7 stars 5 forks source link

Re-package SOSA into separate modules for Actuation, Observation, Sampling #191

Closed dr-shorthair closed 4 months ago

dr-shorthair commented 5 months ago

Following on from discussion in #183 in particular https://github.com/w3c/sdw-sosa-ssn/issues/183#issuecomment-1913860023 the 2024-02-01 telecon agreed to try re-packaging SOSA.

dr-shorthair commented 5 months ago

I have completed a refactoring of the RDF files following the modularization discussed in the last telecon. See here: https://github.com/w3c/sdw-sosa-ssn/tree/191-repackage-sosa-into-separate-modules/ssn/integrated

Take a look in the following files:

The files sosa.ttl and ssn.ttl should provide the same as the old files with the same names, except that now it is necessary to follow more owl:imports paths.

I think these are clean, but would be grateful of some more eyes looking over them.

Now moving onto the HTML document.

kjano commented 5 months ago

Dear all,

if sosa is modularized into multiple files, would it make sense to also have a sosa-features.ttl that would not only handle the FOI, ultimate FOI, etc but also establish better bridges to GeoSPARQL and others?

Cheers, Jano

dr-shorthair commented 5 months ago

I've refactored the HTML spec /ssn/index.html. Several of the document sections are in separate HTML fragments here: https://github.com/w3c/sdw-sosa-ssn/tree/191-repackage-sosa-into-separate-modules/ssn/frag There is a HTML fragment (i) for each module, (ii) for each alignment.

These get merged into the main document at run time. The main part of the document is now just a sequence of data-include directives - see https://github.com/w3c/sdw-sosa-ssn/blob/191-repackage-sosa-into-separate-modules/ssn/index.html#L562-L601

You can preview the full thing here: https://raw.githack.com/w3c/sdw-sosa-ssn/191-repackage-sosa-into-separate-modules/ssn/index.html#Base

I haven't done much re-writing yet, just re-arranging and a lot of consistency checking - there were a lot of missing domainIncludes and rangeIncludes statements in the document, for example. I've rewritten some of the definitions in the HTML but have not yet transferred this back into the RDF.

I'll now work outwards from this core, and plan to mostly re-write the introduction and various overviews ... unless you all think I'm barking up the wrong tree here.

dr-shorthair commented 5 months ago

Dear all, if sosa is modularized into multiple files, would it make sense to also have a sosa-features.ttl that would not only handle the FOI, ultimate FOI, etc but also establish better bridges to GeoSPARQL and others? Cheers, Jano

The mechanics of that are much easier now I've done this work.
Take a look at I've got to, and see if you can identify which terms can be safely/elegantly moved into another module.

In the Core module I have tried to follow each class description with the properties that have than class in its domainIncludes. But I have not yet tidied up the other modules this way.

dr-shorthair commented 4 months ago

I have renamed sosa-core to sosa-base. This is because in the Rec. we refer to SOSA (as a whole) as the 'Core' of the SSN Ontology and I don't want to break that language.

Note that I have not done anything with the figures yet, but here is an updated version of the package diagram with dependencies - SSN modules

dr-shorthair commented 4 months ago

And here's what it could look like with the FoI and Properties factored out into yetanother module SSN modules with FoI