Skip to content

GeoLocation #1203

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

Draft
wants to merge 1 commit into
base: develop
Choose a base branch
from
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 17 additions & 0 deletions docs/release_notes/issue1197-geolocation
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@

### 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.

Missing: removed restrictions on GeoSegment


- Rename `gist:Place` to `gist:GeoLocation` Issue [#1197](https://github.com/semanticarts/gist/issues/1197).

- `gist:GeoRoute` is not a subclass of `gist:GeoLocation` Issue [#1197](https://github.com/semanticarts/gist/issues/1197).

- `gist:Landmark` is not a subclass of `gist:GeoLocation` Issue [#1197](https://github.com/semanticarts/gist/issues/1197).

- Remove deprecated class `gist:GeoSegmnet` Issue [#1182](https://github.com/semanticarts/gist/issues/1182).
- Remove deprecated class `gist:GeoSegmnet` Issue [#1182](https://github.com/semanticarts/gist/issues/1182).
Comment on lines +10 to +11
Copy link
Contributor

Choose a reason for hiding this comment

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

Deprecated classes are only removed for a major release - verify that this is for gist 14

Copy link
Collaborator

Choose a reason for hiding this comment

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

This is for gist 14, but since are not releasing a 13.1 we should not refer to this as deprecated.

I would like to see a top-level bullet point for geo-related changes, with the individual changes as sub-bullets. We can put them all under major changes even though some are not major.

These should be in the past tense and there should be a period between sentences. E.g.:

- Changes to geo classes:
  -  Renamed `gist:Place` to `gist:GeoLocation`. Issue [#1197](https://github.com/semanticarts/gist/issues/1197).
  -  Changed superclass of `gist:GeoRoute` to `gist:OrderedCollection`.  Issue [#1197](https://github.com/semanticarts/gist/issues/1197).
  -  Removed class `gist:GeoSegment` and redefined `gist:GeoRoute` as an ordered collection of `gist:GeoPoint`s. Issue [#1182](https://github.com/semanticarts/gist/issues/1182).
  - Updated annotations.  Issue [#1197](https://github.com/semanticarts/gist/issues/1197).



### Patch Updates

- Update annotations for `gist:GeoLocation` and `gist:GeoRoute` Issue [#1197](https://github.com/semanticarts/gist/issues/1197).

67 changes: 20 additions & 47 deletions ontologies/gistCore.ttl
Original file line number Diff line number Diff line change
Expand Up @@ -672,9 +672,16 @@ gist:GeneralMediaType
skos:prefLabel "General Media Type"^^xsd:string ;
.

gist:GeoLocation
a owl:Class ;
skos:definition "A physical location, with the earth as a frame of reference."^^xsd:string ;
skos:prefLabel "Geo Location"^^xsd:string ;
skos:scopeNote "A geo-location may be a geo-point, geo-region, or geo-volume."^^xsd:string ;
Comment on lines +678 to +679
Copy link
Collaborator

@rjyounes rjyounes Apr 1, 2025

Choose a reason for hiding this comment

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

Are these supposed to be hyphenated or separate words or single words? We should be consistent across the annotations. E.g., here the pref label should be "Geo-Location" if we decide on hyphenated versions.

.

gist:GeoPoint
a owl:Class ;
rdfs:subClassOf gist:Place ;
rdfs:subClassOf gist:GeoLocation ;
owl:disjointWith
gist:IntellectualProperty ,
gist:Intention ,
Expand Down Expand Up @@ -725,7 +732,7 @@ gist:GeoRegion
rdfs:subClassOf [
a owl:Class ;
owl:intersectionOf (
gist:Place
gist:GeoLocation
[
a owl:Restriction ;
owl:onProperty gist:hasMagnitude ;
Expand Down Expand Up @@ -757,7 +764,7 @@ gist:GeoRegion
skos:definition "A bounded region (or set of regions) on the surface of the Earth."^^xsd:string ;
skos:example "The bounded shape that defines the region occupied by Crater Lake; the bounded area known as the contiguous USA."^^xsd:string ;
skos:prefLabel "Geo Region"^^xsd:string ;
skos:scopeNote "A GeoRegion could be non-contiguous; e.g. the region governed by the USA is the region governed by the lower 48 states plus that of Alaska and Hawaii. Child classes in lower ontologies can make this distinction."^^xsd:string ;
skos:scopeNote "A geo-region could be non-contiguous; e.g. the region governed by the USA is the region governed by the lower 48 states plus that of Alaska and Hawaii. Child classes in lower ontologies can make this distinction."^^xsd:string ;
.

gist:GeoRoute
Expand All @@ -766,7 +773,6 @@ gist:GeoRoute
a owl:Class ;
owl:intersectionOf (
gist:OrderedCollection
gist:Place
[
a owl:Restriction ;
owl:onProperty [
Expand All @@ -776,40 +782,14 @@ gist:GeoRoute
]
) ;
] ;
skos:definition "An ordered set of GeoPoints that defines a path from a starting point to an ending point."^^xsd:string ;
skos:definition "An ordered set of geo-points that defines a path from a starting point to an ending point."^^xsd:string ;
skos:prefLabel "Geo Route"^^xsd:string ;
.

gist:GeoSegment
a owl:Class ;
rdfs:subClassOf gist:Place ;
owl:deprecated "true"^^xsd:boolean ;
owl:equivalentClass [
a owl:Class ;
owl:intersectionOf (
[
a owl:Restriction ;
owl:onProperty gist:comesFromPlace ;
owl:onClass gist:GeoPoint ;
owl:qualifiedCardinality "1"^^xsd:nonNegativeInteger ;
]
[
a owl:Restriction ;
owl:onProperty gist:goesToPlace ;
owl:onClass gist:GeoPoint ;
owl:qualifiedCardinality "1"^^xsd:nonNegativeInteger ;
]
) ;
] ;
skos:definition "A single portion of a GeoRoute consisting of a pair of consecutive GeoPoints which belong to it."^^xsd:string ;
skos:editorialNote "See guidance on removing this term in the next major release at #1182."^^xsd:string ;
skos:prefLabel "Geo Segment"^^xsd:string ;
skos:scopeNote "A GeoSegment is also a GeoRoute (a short one)."^^xsd:string ;
skos:scopeNote "A geo-route could describe a bus route by identifying the points where the bus stops. A geo-route could describe the boundary of a polygonal geo-region (it does not have to be a travelled route."^^xsd:string ;
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
skos:scopeNote "A geo-route could describe a bus route by identifying the points where the bus stops. A geo-route could describe the boundary of a polygonal geo-region (it does not have to be a travelled route."^^xsd:string ;
skos:scopeNote "A geo-route could describe a bus route by identifying the points where the bus stops. A geo-route could describe the boundary of a polygonal geo-region (it does not have to be a travelled route)."^^xsd:string ;

.

gist:GeoVolume
a owl:Class ;
rdfs:subClassOf gist:Place ;
rdfs:subClassOf gist:GeoLocation ;
owl:equivalentClass [
a owl:Class ;
owl:intersectionOf (
Expand Down Expand Up @@ -976,7 +956,6 @@ gist:IntergovernmentalOrganization

gist:Landmark
a owl:Class ;
rdfs:subClassOf gist:Place ;
owl:equivalentClass [
a owl:Class ;
owl:intersectionOf (
Expand Down Expand Up @@ -1444,7 +1423,7 @@ gist:PhysicalAddress
[
a owl:Restriction ;
owl:onProperty gist:refersTo ;
owl:someValuesFrom gist:Place ;
owl:someValuesFrom gist:GeoLocation ;
]
) ;
] ;
Expand All @@ -1470,7 +1449,7 @@ gist:PhysicalEvent
[
a owl:Restriction ;
owl:onProperty gist:occursIn ;
owl:someValuesFrom gist:Place ;
owl:someValuesFrom gist:GeoLocation ;
]
) ;
] ;
Expand Down Expand Up @@ -1575,12 +1554,6 @@ gist:PhysicalSubstance
;
.

gist:Place
a owl:Class ;
skos:definition "Union of all the geo classes"^^xsd:string ;
skos:prefLabel "Place"^^xsd:string ;
.

gist:ProductCategory
a owl:Class ;
rdfs:subClassOf gist:Category ;
Expand Down Expand Up @@ -2202,7 +2175,7 @@ gist:comesFromPlace
a owl:Class ;
owl:unionOf (
gist:Address
gist:Place
gist:GeoLocation
) ;
] ;
skos:definition "Origin"^^xsd:string ;
Expand Down Expand Up @@ -2639,7 +2612,7 @@ gist:goesToPlace
a owl:Class ;
owl:unionOf (
gist:Address
gist:Place
gist:GeoLocation
) ;
] ;
skos:definition "Destination"^^xsd:string ;
Expand Down Expand Up @@ -2800,7 +2773,7 @@ gist:hasPhysicalLocation
owl:ObjectProperty ,
owl:TransitiveProperty
;
rdfs:range gist:Place ;
rdfs:range gist:GeoLocation ;
skos:definition "Relates something to its physical location."^^xsd:string ;
skos:prefLabel "has physical location"^^xsd:string ;
skos:scopeNote "This property does not distinguish between things whose locations are stable and those whose locations change over time; e.g., a fire hydrant vs. a car."^^xsd:string ;
Expand Down Expand Up @@ -2968,8 +2941,8 @@ gist:isGeoContainedIn
owl:ObjectProperty ,
owl:TransitiveProperty
;
rdfs:domain gist:Place ;
rdfs:range gist:Place ;
rdfs:domain gist:GeoLocation ;
rdfs:range gist:GeoLocation ;
skos:definition "Relates one place to another that contains it."^^xsd:string ;
skos:prefLabel "is geographically contained in"^^xsd:string ;
.
Expand Down