Migration scripts for 11.0.0

[rjyounes]

@Jamie-SA Should this be assigned to you?

[rjyounes]

@Jamie-SA will review the changes to determine the contents of the migration scripts.

[rjyounes]

Assigning to me to compile list of changes to include in migration scripts.

[rjyounes]

Summary of changes in gist 11

Note: doesn't exclude changes that require no migration, such as modifying annotations and adding or removing a domain or range (even though these affect inferencing).

New time model

Most of the model changes probably should be done manually, because it's not a simple renaming. Object properties have to be renamed to datatype properties, but the properties of the TimeInstant object determine which datatype property to use. It could be automated but would take some work.

Deleted

(I think these get added to detect_removed.rq.)

Classes

TimeInstant
DateInstant
GreenwichInstant
HumanInstant
LocalInstant
SystemInstant

Properties

hasEnd
hasActual
hasActualEnd
hasPlannedEnd
hasDeathDate
hasStart
hasActualStart
hasPlanned
hasBirthDate
hasPlannedStart
epoch
localDate
localDateTime
localTime
universalDate
universalDateTime
universalTime
isSameTimeAs
wasLastModifiedAt

Modified

• ContemporaneousEvent renamed to ContemporaryEvent
• usesTimeZoneStandard - domain TimeInstant removed

Added

atDateTime
birthDate
deathDate
endDateTime
actualEndDateTime
actualEndDate
actualEndMicrosecond
actualEndMinute
actualEndYear
plannedEndDateTime
plannedEndDate
plannedEndMinute
plannedEndYear
startDateTime
actualStartDateTime
actualStartDate
actualStartMicrosecond
actualStartMinute
actualStartYear
plannedStartDateTime
plannedStartDate
plannedStartMinute
plannedStartYear

Notes on datetime migration

Example: from triples

:_x gist:hasPlannedEnd :_ti .
:_ti a gist:DateInstant ;
   gist:localDateTime "2022-03-16T01:01:01Z-04:00"^^xsd:datetime ;
   .

You create:

:_x gist:plannedEndDate "2022-03-16T00:00:00Z-04:00"^^xsd:datetime .

Note that hours, minutes, and seconds must be zeroed out for date values. There are a lot of wrinkles. For example, in gist 10, the local datetime may not have an offset, but a value for gist:usesTimeZoneStandard instead. Precision could have been indicated either with hasPrecision or the subclass of TimeInstant.

We have agreed that scripting this will take too much effort, but we will include sample changes covering a variety of conditions with the release.

Country and CountryGovernment

There may be no changes to be scripted. Primarily additions, and some formal definitional changes to CountryGovernment.

Miscellaneous

Deleted

• hasOrderedMember - use hasMember instead
• hasBiologicalOffspring - change triple :_p gist:hasBiologicalOffspring :_c to : _c gist:hasBiologicalParent :_p.

Modified

• hasJurisdictionOver renamed isUnderJurisdictionOf - simple renaming, subject and object are not reversed because previous predicate name was an error.

[rjyounes]

Closing this issue to create two separate issues, one for providing examples of time model changes and one for scripting the remainder (deletions and name changes).