Skip to content

gistCore changes to support Units of Measure and Magnitudes #1064

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 64 commits into from
Jun 24, 2024

Conversation

philblackwood
Copy link
Contributor

@philblackwood philblackwood commented Mar 5, 2024

Adding two classes and one property. Fixes #1033.
Closes #1065.

@philblackwood philblackwood marked this pull request as draft March 5, 2024 15:20
@philblackwood philblackwood self-assigned this Mar 5, 2024
@philblackwood philblackwood changed the title changes to support UoM reference data gistCore changes to support UoM reference data Mar 5, 2024
philblackwood added 2 commits March 5, 2024 15:42
…nitude that represented Aspects. temporary changes to restrictions for consistency (will add back in)
Copy link
Contributor

@uscholdm uscholdm left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A few suggestions.

philblackwood added 3 commits March 6, 2024 12:19
…s such as the one for GeoRegion, added hasAspect to class equivalence for Magnitude, and also added the xsd data types that are in the range of numericValue
@philblackwood philblackwood changed the title gistCore changes to support UoM reference data gistCore changes to support Units of Measure and Magnitudes Mar 11, 2024
@philblackwood
Copy link
Contributor Author

Working on release notes. A brief guide to review the new ontology is attached:
Review Guide for Units of Measure.docx

@rjyounes rjyounes marked this pull request as ready for review March 14, 2024 15:06
@rjyounes rjyounes requested a review from mkumba March 14, 2024 15:06
Copy link
Collaborator

@rjyounes rjyounes left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is amazing work! I've made some comments related to improving annotations.

Copy link
Collaborator

@rjyounes rjyounes left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Additional comments and questions.

Copy link
Contributor

@uscholdm uscholdm left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nearly there.

- `gist:hasPrecision`
- `gist:conversionFactor`
- `gist:conversionOffset`
- Added scripts for the migration of existing client ontologies and instance data. [TODO - add pointer]
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Still to add

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

pointer to what?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pointer to the "Added scripts for the migration of existing client ontologies and instance data" in the bullet point. I suspect Rebecca added this.

- `gist:conversionFactor`
- `gist:conversionOffset`
- Added scripts for the migration of existing client ontologies and instance data. [TODO - add pointer]
- Added complete documentation on understanding and implementing the new model. [TODO - add pointer]
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

still to add


This is a major release that includes several changes which break compatibility with previous versions of gist, most notably an entirely revised model of units and magnitudes. See the [migration guide](./MajorVersionMigration.html) for documentation on updating existing gist-based ontologies and instance data. Migration scripts are included to facilitate the upgrade process.

### Major Updates
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This release notes file belongs in the release notes folder.

- Added scripts for the migration of existing client ontologies and instance data. [TODO - add pointer]
- Added complete documentation on understanding and implementing the new model. [TODO - add pointer]

Import URL: <https://w3id.org/semanticarts/ontology/gistCore13.0.0>.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't think this is relevant to units revision.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I believe these are the scripts that @philblackwood wrote in order to identify and amend UoM triples in gist users' stores using the new patterns.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I believe these are the scripts that @philblackwood wrote in order to identify and amend UoM triples in gist users' stores using the new patterns.

Yes, I agree. There is a separate PR for the data conversion scripts,it would be appropriate to have these comments in the other PR

Comment on lines 689 to 700
owl:onProperty gist:hasAltitude ;
owl:someValuesFrom gist:Extent ;
owl:someValuesFrom [
a owl:Class ;
owl:intersectionOf (
gist:Magnitude
[
a owl:Restriction ;
owl:onProperty gist:hasAspect ;
owl:hasValue gistd:_Aspect_distance ;
]
) ;
] ;
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Isn't the recommended pattern to use hasMagnitude and have altitude as the aspect? Here might be a good place to illustrate the pattern where altitude hasBroader distance.

ALso, latitude and longitude could be modeled as aspects that have broader aspect_radian, or some such.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Currently follows the same usage as gist12.

Would be better to use gistd:_Aspect_altitude in the definition. Changed.

Copy link
Collaborator

@rjyounes rjyounes left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@philblackwood I think the hasAltitude property should be removed, don't you?

@philblackwood
Copy link
Contributor Author

OK, let's remove hasAltitude. Will do.

Copy link
Contributor

@uscholdm uscholdm left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@philblackwood - Im not sure which changes have been made, so this may be ready to approve. Apparently I had a few comments stacked up waiting for me to submit review.

- `gist:hasPrecision`
- `gist:conversionFactor`
- `gist:conversionOffset`
- Added scripts for the migration of existing client ontologies and instance data. [TODO - add pointer]
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pointer to the "Added scripts for the migration of existing client ontologies and instance data" in the bullet point. I suspect Rebecca added this.

Copy link
Contributor

@kchastain703 kchastain703 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This looks good to me.

Co-authored-by: Michael Uschold <uscholdm@users.noreply.github.com>
@rjyounes rjyounes requested review from rjyounes and Jamie-SA June 24, 2024 13:31
# Conflicts:
#	ontologies/gistCore.ttl
@rjyounes rjyounes dismissed uscholdm’s stale review June 24, 2024 13:40

All requested changes have been addressed.

@rjyounes rjyounes merged commit 063d8b8 into develop Jun 24, 2024
1 check passed
@rjyounes rjyounes deleted the modelForReferenceData branch June 24, 2024 13:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
No open projects
Development

Successfully merging this pull request may close these issues.

Options for expressing the broader relationship among aspects Turtle implementation of new units and measures model
6 participants