Merge v9.7.0 from develop.

README.md

@@ -1,22 +1,11 @@
+![gist logo](gist.png)
 
-# gist upper enterprise ontology
+# gist
 
-This repository has the raw files that we use to build the release files. If you just want the release files then you can download them from our [website](https://www.semanticarts.com/gist).
+gist is Semantic Arts' minimalist upper ontology for the enterprise. It is designed to have the maximum coverage of typical business ontology concepts with the fewest number of primitives and the least amount of ambiguity. 
 
-## Prerequisites to build the output files
+We have an active governance and best practices community around gist called the gist Council, with a teleconference on the first Thursday of every month, where practitioners and users of gist come together to discuss how to use gist and make suggestions on its evolution.  Please send email to [email protected] if you would like to become involved.
 
-1. You must have `java` installed for the serializer to work.  See JRE Installation instructions [here](https://jdk.java.net/).
-1. You must also install the [ontology toolkit](https://github.com/semanticarts/ontology-toolkit), which also requires [Python](https://www.python.org/downloads/) 3.6 or greater.
+You can also contribute to gist by adding your comments to [issue discussion threads](https://github.com/semanticarts/gist/issues) and submitting new issues and pull requests. You can view [minutes](https://github.com/semanticarts/gist/wiki/gist-Issue-Review-Meetings) from our biweekly issue review sessions to find out what we've been reviewing and get a preview of upcoming changes to gist.
 
-## To release
-
-1. To generate a folder suitable for ZIP-ing up and releasing Gist, run 
-
-    `onto_tool bundle -v version <release-version> bundle.yaml`
-
-   where `<release-version>` is a [semantic version](https://semver.org/), e.g. `9.2.0`.  It will
-serialize the OWL, and create a ZIP-able folder containing everything needed for a web 
-download.  The folder will have a name like `gist<release-version>_webDownload`. You can override
-this by adding `-v output <path-to-output-folder>` to the command.
-
-1. ZIP up the resulting folder and put it where we host our downloads. 
+gist is free and open to the public under the [Creative Commons 3.0](http://creativecommons.org/licenses/by-sa/3.0/) attribution share-alike license. For more information on gist or to download previously released versions of gist, see our [website](https://www.semanticarts.com/gist).

bundle.yaml

@@ -5,7 +5,6 @@ variables:
   input: "."
   rdf-toolkit: "{input}/tools/rdf-toolkit.jar"
   output: "{name}{version}_webDownload"
-  validation: "validation"
 tools:
 - name: "serializer"
   type: "Java"
@@ -56,15 +55,11 @@ tools:
     - "-t"
     - "{outputFile}"
 actions:
-# Create validation directory
-- action: "mkdir"
-  directory: "{validation}"
 # Validate ontology
 - action: "verify"
   message: "Validating ontology via SHACL."
   type: "shacl"
   inference: "none"
-  target: "{validation}/ontologyValidationReport.ttl"
   source: "{input}"
   includes:
     - gistCore.ttl
@@ -84,40 +79,14 @@ actions:
     from: "(.*)\\.ttl"
     to: "\\g<1>{version}.ttl"
   includes:
-    - "*.ttl"
+    - gistCore.ttl
+    - gistDeprecated.ttl
 - action: "definedBy"
   message: "Adding rdfs:definedBy."
   source: "{output}"
   target: "{output}"
   includes:
     - "*.ttl"
-- action: "transform"
-  message: "Turtle serialization."
-  tool: "serializer"
-  source: "{output}"
-  target: "{output}"
-  includes:
-    - "*.ttl"
-- action: "transform"
-  message: "RDF/XML serialization."
-  tool: "xml-serializer"
-  source: "{output}"
-  target: "{output}"
-  rename:
-    from: "(.*)\\.ttl"
-    to: "\\g<1>.rdf"
-  includes:
-    - "*.ttl"
-- action: "transform"
-  message: "JSON/LD serialization."
-  tool: "json-serializer"
-  source: "{output}"
-  target: "{output}"
-  rename:
-    from: "(.*)\\.ttl"
-    to: "\\g<1>.jsonld"
-  includes:
-    - "*.ttl"
 - action: "sparql"
   message: "Generating rdfs:label for backward compatibility."
   source: "{output}"
@@ -148,9 +117,32 @@ actions:
       }}
     }}
 - action: "transform"
+  message: "Turtle serialization."
   tool: "serializer"
-  source: "{output}/rdfsAnnotations.ttl"
-  target: "{output}/rdfsAnnotations.ttl"
+  source: "{output}"
+  target: "{output}"
+  includes:
+    - "*.ttl"
+- action: "transform"
+  message: "RDF/XML serialization."
+  tool: "xml-serializer"
+  source: "{output}"
+  target: "{output}"
+  rename:
+    from: "(.*)\\.ttl"
+    to: "\\g<1>.rdf"
+  includes:
+    - "*.ttl"
+- action: "transform"
+  message: "JSON/LD serialization."
+  tool: "json-serializer"
+  source: "{output}"
+  target: "{output}"
+  rename:
+    from: "(.*)\\.ttl"
+    to: "\\g<1>.jsonld"
+  includes:
+    - "*.ttl"
 - action: "copy"
   message: "Copying license text."
   source: "{input}/LICENSE.txt"

docs/.markdownlint.json

@@ -3,5 +3,6 @@
     "MD003": { "style": "setext_with_atx" },
     "MD013": false,
     "MD024": { "siblings_only": true },
-    "MD036": false
+    "MD036": false, 
+    "MD007": false
 }

docs/ChangeAndReleaseManagement.md

@@ -33,7 +33,7 @@ Version numbers are of the form X.x.x (major.minor.patch). We follow [Semantic V
 - **Major:** Non-backward-compatible (i.e., reasoning produces different results).
   - Examples: adding a restriction, domain, range.
 
-- **Minor:** New, backward-compatible functionality. May constitute a large change to the ontology, such as addition to new module.
+- **Minor:** New, backward-compatible functionality. May constitute a large change to the ontology, such as addition of a new module.
   - Examples: adding a class or property; removing a restriction.
 
 - **Patch:** No new functionality except for bug fixes.
@@ -43,7 +43,7 @@ Additional notes:
 
 - Correction of an error, even if not backward-compatible, does not require a major release. The expectation is that users will not have implemented against an obvious error. This would be a patch.
 - When a local name is altered, the original term is deprecated to make it a minor rather than major change. The deprecated term receives an `owl:equivalentClass` or `owl:equivalentProperty` assertion to the new term. Deprecated terms may be removed in a future major release. Deprecated terms reside in the `gistDeprecated.ttl` file. If a user wants to use a deprecated term, he/she should import this file into his/her ontology, which in turn imports `gistCore.ttl` and thus all of gist.
-- Major changes should have a significant impact aside from technically modifying inferencing if this is low-impact. E.g.,changing an equivalent class axiom to a union class to a subclass axiom in order to allow new subclasses to be defined. 
+- Major changes should have a significant impact aside from technically modifying inferencing if this is low-impact. E.g., when an equivalent class axiom to a union class is changed to a subclass axiom in order to allow new subclasses to be defined.
 
 Releases
 -----

docs/ReleaseNotes.md

@@ -1,6 +1,23 @@
 gist Release Notes
 =====
 
+Release 9.7.0
+-----
+
+### Minor Updates
+
+- Deprecated `gist:Room`. Issue [#102](<https://github.com/semanticarts/gist/issues/102>).
+
+### Patch Updates
+
+- Updated annotations for the following properties regarding the hasDirectX/hasX pattern. Issue [#115](https://github.com/semanticarts/gist/issues/115)
+    - `geoContains`, `geoContainedIn` 
+    - `directPartOf`,`hasDirectPart`
+    - `directlyPrecededBy`, `directlyPrecedes`
+- Declare `gist:identifies` as `owl:FunctionalProperty` rather than `owl:InverseFunctionalProperty` (bug fix). Issue [#180](https://github.com/semanticarts/gist/issues/180).
+
+Import URL: <https://ontologies.semanticarts.com/o/gistCore9.7.0>.
+
 Release 9.6.0
 -----
 
@@ -43,8 +60,8 @@ Release 9.5.0
 
 - Modified build to create JSON-LD ontology files with `.jsonld` extension. Issue [#365](https://github.com/semanticarts/gist/issues/365).
 - Documentation:
-  - Documented policy change on submission of PRs by external contributors (PRs from external contributors are now accepted for review if submitted with an issue). Issue [#382](https://github.com/semanticarts/gist/issues/382).
-  - Documented new, condensed release notes format (reverted release note format introduced in 9.4.0). Issue [#401](https://github.com/semanticarts/gist/issues/401).
+    - Documented policy change on submission of PRs by external contributors (PRs from external contributors are now accepted for review if submitted with an issue). Issue [#382](https://github.com/semanticarts/gist/issues/382).
+    - Documented new, condensed release notes format (reverted release note format introduced in 9.4.0). Issue [#401](https://github.com/semanticarts/gist/issues/401).
 - Added a standard `pre-commit` hook which applies uniform formatting to RDF files using `tools/rdf-toolkit.jar`. Issue [#228](https://github.com/semanticarts/gist/issues/228).
 - Conformed definition of `gist:_second` to other `gist:BaseUnit` individuals. Issue [#92](https://github.com/semanticarts/gist/issues/92).
 - Fixed label of TaskTemplate. Issue [#407](https://github.com/semanticarts/gist/issues/407).
@@ -198,17 +215,17 @@ Entirely new ontology for modeling Internet of Things concepts.
 Added to the list of deprecated things:
 
 1. Renamed
-a. `gist:TemplateTask` (renamed to `TaskTemplate`)
-b. `gist:party` (use `hasParty` instead)
+    - `gist:TemplateTask` (renamed to `TaskTemplate`)
+    - `gist:party` (use `hasParty` instead)
 2. Removed
-a. `gist:SocialBeing`  - use `(Person or Organization)` instead
-b.  `gist:of` (a vestige of the past)
-c.  `gist:sameOrderAs` (was adding unnecessary mathematical precision)
-d.  `gist:TimeInterval` (the idea of a time interval is captured by assigning it a start and end time, e.g. an event)
-e.  `gist:dateTime`
+    - `gist:SocialBeing`  - use `(Person or Organization)` instead
+    - `gist:of` (a vestige of the past)
+    - `gist:sameOrderAs` (was adding unnecessary mathematical precision)
+    - `gist:TimeInterval` (the idea of a time interval is captured by assigning it a start and end time, e.g. an event)
+    - `gist:dateTime`
 3. Replaced by a variation
-a.  `gist:strictlyPrecededBy` (using `directlyPrecededBy` instead)
-b.  `gist:strictlyPrecedes` (using `directlyPrecedes` instead)
+    - `gist:strictlyPrecededBy` (using `directlyPrecededBy` instead)
+    - `gist:strictlyPrecedes` (using `directlyPrecedes` instead)
 
 Release 8.0
 -----

gistCore.ttl

@@ -2158,28 +2158,6 @@ gist:Restriction
 	skos:prefLabel "Restriction"^^xsd:string ;
 	.
 
-gist:Room
-	a owl:Class ;
-	rdfs:subClassOf gist:Place ;
-	owl:equivalentClass [
-		a owl:Class ;
-		owl:intersectionOf (
-			[
-				a owl:Restriction ;
-				owl:onProperty gist:directPartOf ;
-				owl:someValuesFrom gist:Building ;
-			]
-			[
-				a owl:Restriction ;
-				owl:onProperty gist:identifiedBy ;
-				owl:someValuesFrom gist:ID ;
-			]
-		) ;
-	] ;
-	skos:definition "An enclosed area within a building."^^xsd:string ;
-	skos:prefLabel "Room"^^xsd:string ;
-	.
-
 gist:ScheduledTask
 	a owl:Class ;
 	owl:equivalentClass [
@@ -2942,8 +2920,7 @@ gist:convertToBase
 	a owl:DatatypeProperty ;
 	rdfs:domain gist:UnitOfMeasure ;
 	rdfs:range xsd:double ;
-	skos:definition """The conversion factor used to get to the base unit.  E.g., multiplying by 0.0254 gets you from inches to meters. Divide by this number to go the other way. Used in conjunction with conversionOffset to convert from one unit to another.
-Degrees K =  (Degrees F - conversionOffset) * convertToBase. Or K = (F-(-469.67)) * (5/9).  To go the other way: F = (K * 9/5) -469.67.  Try it on Google."""^^xsd:string ;
+	skos:definition "The conversion factor used to get to the base unit.  E.g., multiplying by 0.0254 gets you from inches to meters. Divide by this number to go the other way. Used in conjunction with conversionOffset to convert from one unit to another. Degrees K =  (Degrees F - conversionOffset) * convertToBase. Or K = (F-(-469.67)) * (5/9.  To go the other way: F = (K * 9/5) -469.67.  Try it on Google."^^xsd:string ;
 	skos:prefLabel "convert to base"^^xsd:string ;
 	.
 
@@ -2989,29 +2966,35 @@ gist:description
 gist:directPartOf
 	a owl:ObjectProperty ;
 	owl:inverseOf gist:hasDirectPart ;
-	skos:definition "The relationship between a  part and a whole where the part has independent existence."^^xsd:string ;
+	skos:definition "The relationship between a part and a whole where the part has independent existence."^^xsd:string ;
 	skos:prefLabel "direct part of"^^xsd:string ;
+	skos:scopeNote
+		"It is safest to use this property when there is semantic directness inherent in the relationship, rather than choosing appropriate granularity. For example, a spark plug is a direct part of an engine block; there cannot be any intermediate parts.  Beware of making a directPartOf assertion and then inserting an intermediate part; this will result in making an asserted triple false even though there was no change in the world."^^xsd:string ,
+		"Use this property to directly associate a part with the whole. partOf is the transitive version."^^xsd:string
+		;
 	.
 
 gist:directSubTaskOf
 	a owl:ObjectProperty ;
 	owl:inverseOf gist:hasDirectSubTask ;
 	skos:definition "Immediate parent task"^^xsd:string ;
-	skos:prefLabel "direct sub task of"^^xsd:string ;
+	skos:prefLabel "direct subtask of"^^xsd:string ;
 	.
 
 gist:directlyPrecededBy
 	a owl:ObjectProperty ;
 	owl:inverseOf gist:directlyPrecedes ;
 	skos:definition "Inverse of directly precedes"^^xsd:string ;
 	skos:prefLabel "directly preceded by"^^xsd:string ;
+	skos:scopeNote "It is safest to use this property only when the directness has a semantic correspondence with the world. Only break a direct link by inserting an intermediate item when that change corresponds to a change in the world."^^xsd:string ;
 	.
 
 gist:directlyPrecedes
 	a owl:ObjectProperty ;
 	rdfs:subPropertyOf gist:precedes ;
-	skos:definition "A generic ordering relation indicating that the Subject comes immediately  before the Object."^^xsd:string ;
+	skos:definition "A generic ordering relation indicating that the Subject comes immediately before the Object."^^xsd:string ;
 	skos:prefLabel "directly precedes"^^xsd:string ;
+	skos:scopeNote "It is safest to use this property only when the directness has a semantic correspondence with the world. Only break a direct link by inserting an intermediate item when that change corresponds to a change in the world."^^xsd:string ;
 	.
 
 gist:directlyRecognizedBy
@@ -3081,7 +3064,7 @@ gist:fromPlace
 gist:geoContainedIn
 	a owl:ObjectProperty ;
 	owl:inverseOf gist:geoContains ;
-	skos:definition "All the transitive places something is located in"^^xsd:string ;
+	skos:definition "Relates one place to another place that contains the first."^^xsd:string ;
 	skos:prefLabel "geo contained in"^^xsd:string ;
 	.
 
@@ -3092,7 +3075,7 @@ gist:geoContains
 		;
 	rdfs:domain gist:Place ;
 	rdfs:range gist:Place ;
-	skos:definition "Transitive version of geoDirectlyContains"^^xsd:string ;
+	skos:definition "Relate one place to another place that is contained within the first."^^xsd:string ;
 	skos:prefLabel "geo contains"^^xsd:string ;
 	.
 
@@ -3176,7 +3159,8 @@ gist:hasBirthDate
 	rdfs:subPropertyOf gist:actualStart ;
 	rdfs:domain gist:LivingThing ;
 	rdfs:range gist:TimeInstant ;
-	skos:definition 'Date a living thing was "born" (or germinated, for plants).'^^xsd:string ;
+	skos:definition "Date a living thing is or will be born."^^xsd:string ;
+	skos:editorialNote "For 10.0.0 release: This property will be a subproperty of gist:start, rather than gist:actualStart (as currently), to acknowledge the fact that the birth may not yet have occurred. In this case, the birthdate is expected although not known. [Change this note to a skos:scopeNote.]"^^xsd:string ;
 	skos:prefLabel "has birthdate"^^xsd:string ;
 	.
 
@@ -3202,8 +3186,9 @@ gist:hasDirectPart
 	skos:definition "The relationship between a whole and a part where the part has independent existence."^^xsd:string ;
 	skos:prefLabel "has direct part"^^xsd:string ;
 	skos:scopeNote
+		"It is safest to use this property when there is semantic directness inherent in the relationship, rather than choosing appropriate granularity. For example, a spark plug is a direct part of an engine block; there cannot be any intermediate parts.  Beware of making a hasDirectPart assertion and then inserting an intermediate part; this will result in making an asserted triple false even though there was no change in the world."^^xsd:string ,
 		"No cascading delete."^^xsd:string ,
-		"Use this property to directly associate parts. hasPart is the transitive version."^^xsd:string
+		"Use this property to directly associate a part with the whole. hasPart is the transitive version."^^xsd:string
 		;
 	.
 
@@ -3464,7 +3449,7 @@ gist:identifiedBy
 
 gist:identifies
 	a
-		owl:InverseFunctionalProperty ,
+		owl:FunctionalProperty ,
 		owl:ObjectProperty
 		;
 	skos:definition "The thing the identifier refers to."^^xsd:string ;

gistDeprecated.ttl

@@ -32,6 +32,29 @@ gist:PhysicalThing
 	] ;
 	.
 
+gist:Room
+	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:directPartOf ;
+				owl:someValuesFrom gist:Building ;
+			]
+			[
+				a owl:Restriction ;
+				owl:onProperty gist:identifiedBy ;
+				owl:someValuesFrom gist:ID ;
+			]
+		) ;
+	] ;
+	skos:definition "An enclosed area within a building."^^xsd:string ;
+	skos:prefLabel "Room"^^xsd:string ;
+	.
+
 gist:SocialBeing
 	a owl:Class ;
 	rdfs:label "Social Being"^^xsd:string ;