Update CROM & Maintain Compatibility for Production – DEV-6985

Updated CROM, pulling in latest updates from the Linked.art CROM
repository, and reinstated several previously removed model attributes
including the `Relationship` entity and its associated properties, the
`current_keeper` property and its inverse, as well as the `Geometry`
and `CoordinateSystem` entities.

These reinstated attributes are all required for ongoing compatibility
with data modeling that is in production use and will take some time to
migrate away from so as not to break several production or
near-production applications that are consuming the modeled data in its
existing form.

CHANGELOG.md

@@ -0,0 +1,19 @@
+# Cromulent (CROM) Change Log
+
+Any notable changes to CROM that affect either functionality or output will be documented in this file (the format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)).
+
+## [Unreleased] 2020-11-03
+
+## Added
+
+* Added this change log [[DEV-6985](https://jira.getty.edu/browse/DEV-6985)].
+
+* Reinstated the `Relationship` entity and its associated properties `relates_to`, `relates_from`, `related_to_by`, and `related_from_by` as these are in production data modelling use, as their sudden removal led to runtime exceptions and prevented code reliant on CROM from operating [[DEV-6985](https://jira.getty.edu/browse/DEV-6985)].
+
+* Reinstated the `Geometry` and `CoordinateSystem` entities as these are in production data modelling use, as their sudden removal led to runtime exceptions and prevented code reliant on CROM from operating [[DEV-6985](https://jira.getty.edu/browse/DEV-6985)].
+
+* Reinstated the `current_keeper` and `current_keeper_of` properties as these are in production data modelling use, as their sudden removal led to runtime exceptions and prevented code reliant on CROM from operating [[DEV-6985](https://jira.getty.edu/browse/DEV-6985)].
+
+## Changed
+
+* Imported the updated Getty-local `linked-art.json` context document from the `getty-contexts` repository to ensure consistency [[DEV-6984](https://jira.getty.edu/browse/DEV-6984)].

cromulent/data/crm-profile.json

@@ -86,7 +86,7 @@
   "la:Phase": 0, 
   "la:RightAcquisition": 1,
   "la:Payment": 1, 
-  "la:Relationship": 0,
+  "la:Relationship": 1,
   "la:Set": 1,
   "la:Addition": 1,
   "la:Removal": 1,
@@ -422,6 +422,10 @@
   "la:established_by": [1,0],
   "la:invalidates": [1,1],
   "la:invalidated_by": [1,0],
+  "la:relates_to": [1,0],
+  "la:relates_from": [1,0],
+  "la:related_to_by": [1,1],
+  "la:related_from_by": [1,1],
   "la:initiated": [0,1],
   "la:initiated_by": [0,1],
   "la:terminated": [0,1],

cromulent/data/crm_vocab.tsv

@@ -166,6 +166,8 @@ P49_has_former_or_current_keeper	property	former_or_current_keeper	has former or
 P49i_is_former_or_current_keeper_of	property	former_or_current_keeper_of	is former or current keeper of			E39_Actor	E18_Physical_Thing	P49_has_former_or_current_keeper	10000	0	1
 P50_has_current_keeper	property	current_custodian	has current keeper	This property identifies the E39 Actor or Actors who had custody of an instance of E18 Physical Thing at the time of validity of the record or database containing the statement that uses this property.\n P50 has current keeper (is current keeper of) is a shortcut for the more detailed path from E18 Physical Thing through P30 transferred custody of (custody transferred through), E10 Transfer of Custody, P29 custody received by (received custody through) to E39 Actor.	P49_has_former_or_current_keeper	E18_Physical_Thing	E39_Actor	P50i_is_current_keeper_of	10000	1	1
 P50i_is_current_keeper_of	property	current_custodian_of	is current keeper of		P49i_is_former_or_current_keeper_of	E39_Actor	E18_Physical_Thing	P50_has_current_keeper	10000	1	1
+P50_has_current_keeper	property	current_keeper	has current keeper	This property identifies the E39 Actor or Actors who had custody of an instance of E18 Physical Thing at the time of validity of the record or database containing the statement that uses this property.\n P50 has current keeper (is current keeper of) is a shortcut for the more detailed path from E18 Physical Thing through P30 transferred custody of (custody transferred through), E10 Transfer of Custody, P29 custody received by (received custody through) to E39 Actor.	P49_has_former_or_current_keeper	E18_Physical_Thing	E39_Actor	P50i_is_current_keeper_of	10000	1	1
+P50i_is_current_keeper_of	property	current_keeper_of	is current keeper of		P49i_is_former_or_current_keeper_of	E39_Actor	E18_Physical_Thing	P50_has_current_keeper	10000	1	1
 P51_has_former_or_current_owner	property	former_or_current_owner	has former or current owner	This property identifies the E39 Actor that is or has been the legal owner (i.e. title holder) of an instance of E18 Physical Thing at some time.\nThe distinction with P52 has current owner (is current owner of) is that P51 has former or current owner (is former or current owner of) does not indicate whether the specified owners are current. P51 has former or current owner (is former or current owner of) is a shortcut for the more detailed path from E18 Physical Thing through P24 transferred title of (changed ownership through), E8 Acquisition, P23 transferred title from (surrendered title through), or P22 transferred title to (acquired title through) to E39 Actor.		E18_Physical_Thing	E39_Actor	P51i_is_former_or_current_owner_of	10000	0	1
 P51i_is_former_or_current_owner_of	property	former_or_current_owner_of	is former or current owner of			E39_Actor	E18_Physical_Thing	P51_has_former_or_current_owner	10000	0	1
 P52_has_current_owner	property	current_owner	has current owner	This property identifies the E21 Person, E74 Group or E40 Legal Body that was the owner of an instance of E18 Physical Thing at the time of validity of the record or database containing the statement that uses this property.\nP52 has current owner (is current owner of) is a shortcut for the more detailed path from E18 Physical Thing through P24 transferred title of (changed ownership through), E8 Acquisition, P22 transferred title to (acquired title through) to E39 Actor, if and only if this acquisition event is the most recent.	P51_has_former_or_current_owner	E18_Physical_Thing	E39_Actor	P52i_is_current_owner_of	10000	1	1
@@ -410,6 +412,7 @@ la:Phase	class	Phase	Phase	The period of time during which an entity is in a cer
 la:Set	class	Set	Set		E89_Propositional_Object|E72_Legal_Object	1
 la:Addition	class	Addition	Addition	The addition of some entity to a Set	E7_Activity	1
 la:Removal	class	Removal	Removal	The removal of some entity from a Set	E7_Activity	1
+la:Relationship	class	Relationship	Relationship		E28_Conceptual_Object	1
 la:DigitalService	class	DigitalService	Digital Service		dig:D1_Digital_Object	1
 la:property_classified_as	property	property_classified_as	Property Classified As	Record dot one properties via Attribute Assignments		E13_Attribute_Assignment	E55_Type		10000	1	1
 la:represents_instance_of_type	property	represents_instance_of_type	Represents Instance of Type	This property establishes the relationship between an E36 Visual Item and an E55 Type that represents the class of entity which it visually represents.  This property is used when the specific entity being represented is either unknown, or not of documentary interest.		E36_Visual_Item	E55_Type	la:instance_represented_by	10000	1	1
@@ -443,10 +446,16 @@ la:removed_from	property	removed_from	removed from			la:Removal	la:Set	la:remove
 la:removed_from_by	property	removed_from_by	removed from by			la:Set	la:Removal	la:removed_from	10000	1	1
 la:removed_member	property	removed_member	removed			la:Removal	E1_CRM_Entity	la:removed_member_by	10000	1	0
 la:removed_member_by	property	removed_member_by	removed by			E1_CRM_Entity	la:Removal	la:removed_member	10000	1	1
+la:relates_to	property	relates_to	related to			la:Relationship	E1_CRM_Entity	la:related_to_by	10000	1	0
+la:related_to_by	property	related_to_by	related to by			E1_CRM_Entity	la:Relationship	la:relates_to	10000	1	1
+la:relates_from	property	relates_from	related from			la:Relationship	E1_CRM_Entity	la:related_from_by	10000	1	0
+la:related_from_by	property	related_from_by	related from by			E1_CRM_Entity	la:Relationship	la:relates_from	10000	1	1
 la:digitally_carries	property	digitally_carries	digitally carries			dig:D1_Digital_Object	E90_Symbolic_Object	la:digitally_carried_by	10000	1	1
 la:digitally_carried_by	property	digitally_carried_by	digitally carried by			E90_Symbolic_Object	dig:D1_Digital_Object	la:digitally_carries	10000	1	1
 la:digitally_shows	property	digitally_shows	digitally shows			dig:D1_Digital_Object	E36_Visual_Item	la:digitally_shown_by	10000	1	1
 la:digitally_shown_by	property	digitally_shown_by	digitally shown by			E36_Visual_Item	dig:D1_Digital_Object	la:digitally_shows	10000	1	1
 la:access_point	property	access_point	access point	From an ur- digital object to a single concrete representation.\n        A locator as opposed to an identifier, similar to the approximated_by for Place.		dig:D1_Digital_Object	dig:D1_Digital_Object		10000	1	1
 la:digitally_available_via	property	digitally_available_via	digitally available via			dig:D1_Digital_Object	la:DigitalService	la:digitally_makes_available	10000	1	1
 la:digitally_makes_available	property	digitally_makes_available	digitally makes available			dig:D1_Digital_Object	la:DigitalService	la:digitally_available_via	10000	1	1
+geo:SP5_Geometric_Place_Expression	class	Geometry	Geometry	Scope note: This class comprises definitions of places by quantitative expressions. An instance of SP5 Geometric Place Expression can be seen as a prescription of how to find the location meant by this expression in the real world (S), which is based on measuring where the quantities referred to in the expression lead to, beginning from the reference points of the respective reference system.	E41_Appellation	1
+geo:SP4_Spatial_Coordinate_Reference_System	class	CoordinateSystem	Spatial Coordinate Reference System	Scope note: This class compromises systems that are used to describe locations in a SP3 Reference Space (S). An instance of SP4 Spatial Coordinate Reference System is composed of two parts: The first is a Coordinate System which is a set of coordinate axes with specified units of measurement and axis directions. The second part is a set of reference features at rest in the Reference Space it describes in the real world that relate the Coordinate System to real world locations (U) and fix it with respect to the reference object of its Reference Space.	E29_Design_or_Procedure	1