Skip to content

refactor: RDF, documentation and briefing pack for RC2 - #23

Merged
afizzycola merged 15 commits into
mainfrom
rc2
Sep 11, 2026
Merged

afizzycola merged 15 commits into
mainfrom
rc2

Conversation

@afizzycola

@afizzycola afizzycola commented Aug 23, 2026

Copy link
Copy Markdown
Collaborator

All changes listed below cover:

  1. RDF serialisation
  2. markdown documentation
  3. Briefing pack

Added

  • Extent class as the root of the individuals hierarchy, allowing for individuals that are not necessarily spatiotemporal. This makes explicit IES-Top's commitment to Extensionalism, upon which Four-Dimensionalism is subsequently built, and moves IES-Top closer to David Lewis' principle of plenitude, under which "the worlds are many and varied" and may differ fundamentally from our own — including worlds in which "totally different laws govern the doings of alien particles with alien properties". SpacetimeExtent is now a subclass of Extent
  • WorldboundExtent and TransworldExtent classes. In RC1 these distinctions were represented through class definitions; they are now explicit classes in their own right
  • RegularSpacetimeExtent class as a subclass of SpacetimeExtent, providing the foundation for updates to IES-Core in relation to spatial objects, relative spaces and coordinate systems. Note: in practice, virtually all usage of IES relate to regular spacetime extents
  • World class as the superclass of the existing Universe class, allowing for worlds irrespective of whether they are spacetime worlds or not
  • connected and disconnected relations
  • SHACL validation file for for all classes and properties

Changed

  • Renamed SpatiotemporalExtent to SpacetimeExtent. This makes clearer that, at this level, we are talking about "chunks" of spacetime (in a spacetime world), aligns the terminology with the foundational spacetime literature originating with Minkowski and Einstein, and provides a shorter and cleaner term in the RDF implementation
  • Refined the pattern for continuous and intermittent states, giving it a standard mereotopological foundation based on self-connection and self-disconnection, itself built on the newly introduced connected and disconnected relations

Still to do before release (upcoming PRs)

  • Re-introduce to the RDF serialisation: Object- and DataType- Properties
  • Update Change Log

@github-actions github-actions Bot added documentation General documentation tasks release labels Aug 23, 2026
@github-actions

github-actions Bot commented Aug 25, 2026

Copy link
Copy Markdown

Required repository documentation checks passed

All required repository documentation checks passed in this run.

Total Files Passed Failed Score
11 11 0 100%

Results from commit 4939b68, view the full job summary for detailed results.

♻️ This comment has been updated with latest results.

@afizzycola afizzycola changed the title refactor: RC2 refactor: RDF, documentation and briefing pack changes for RC2 Aug 28, 2026
@afizzycola afizzycola changed the title refactor: RDF, documentation and briefing pack changes for RC2 refactor: RDF, documentation and briefing pack for RC2 Aug 28, 2026
@afizzycola
afizzycola marked this pull request as ready for review August 28, 2026 07:25
@jamrce

jamrce commented Aug 28, 2026

Copy link
Copy Markdown

@afizzycola - I've just ran a diff across rc1 and rc2 and have found some of the ID's do not align to where you've renamed classes between versions. This may not be of significance whilst still in RCs, but if you could fix for anyone resolving on these IDs for class name changes as users would expect the dcterms:identifier to be a oblique ID mechanism that could be relied upon. I've not exhausting checked everything, but if other classes have been renamed they may have the same problem.

# rc1
ies_top:SpatiotemporalExtent dcterms:identifier "{DCB3F671-0FA3-4de6-B037-A011C432A087}" . 

RC2 briefing pack states that: "The class SpatiotemporalExtent has been renamed to SpacetimeExtent."

# rc2 - a fresh ID for SpacetimeExtent.
ies_top:SpacetimeExtent dcterms:identifier "{77BB5948-C5BF-4cc2-B6DC-B7FFE413ADF5}" .
# the resolved rc2 class of where the rc1 ies_top:SpatiotemporalExtent now resolves to instead
ies_top:RegularSpacetimeExtent dcterms:identifier "{DCB3F671-0FA3-4de6-B037-A011C432A087}" . 

@afizzycola

Copy link
Copy Markdown
Collaborator Author

@afizzycola - I've just ran a diff across rc1 and rc2 and have found some of the ID's do not align to where you've renamed classes between versions. This may not be of significance whilst still in RCs, but if you could fix for anyone resolving on these IDs for class name changes as users would expect the dcterms:identifier to be a oblique ID mechanism that could be relied upon. I've not exhausting checked everything, but if other classes have been renamed they may have the same problem.

# rc1
ies_top:SpatiotemporalExtent dcterms:identifier "{DCB3F671-0FA3-4de6-B037-A011C432A087}" . 

RC2 briefing pack states that: "The class SpatiotemporalExtent has been renamed to SpacetimeExtent."

# rc2 - a fresh ID for SpacetimeExtent.
ies_top:SpacetimeExtent dcterms:identifier "{77BB5948-C5BF-4cc2-B6DC-B7FFE413ADF5}" .
# the resolved rc2 class of where the rc1 ies_top:SpatiotemporalExtent now resolves to instead
ies_top:RegularSpacetimeExtent dcterms:identifier "{DCB3F671-0FA3-4de6-B037-A011C432A087}" . 

This example is fine: a SpatiotemporalExtent was always a an extent in regular spacetime (where we do most of the work) i.e. RegularSpacetimeExtent. There might be the odd mismatch but I am going to say considering these are RC, I think breaking changes in this regard need to be expected.

@jamrce

jamrce commented Aug 28, 2026

Copy link
Copy Markdown

This example is fine: a SpatiotemporalExtent was always a an extent in regular spacetime (where we do most of the work) i.e. RegularSpacetimeExtent. There might be the odd mismatch but I am going to say considering these are RC, I think breaking changes in this regard need to be expected.

Agreed, I was mostly raising for awareness for others who find the same issue.

On your logic, I've just seen the same for the Disjoint sets and a previous SetOfDisjointSpatiotemporalExtents is now not always a SetOfDisjointExtents. Still no change required.
RC1: ies_top:SetOfDisjointSpatiotemporalExtents dcterms:identifier "{2733C396-A001-42fb-945F-B4F26E120B33}" .
RC2: ies_top:SetOfDisjointExtents dcterms:identifier "{2733C396-A001-42fb-945F-B4F26E120B33}" .

Comment thread spec/validation_artefacts/PowerSetURIMinting.shacl.ttl Outdated
Comment thread docs/ies-top.md Outdated
Comment thread docs/ies-top.md
Comment thread spec/ies-top.ttl

@chrispartridge1091 chrispartridge1091 left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Looks okay.

@nigel81562 nigel81562 left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Comments addressed - all looks okay now

@afizzycola
afizzycola merged commit a1c5249 into main Sep 11, 2026
4 checks passed
@afizzycola
afizzycola deleted the rc2 branch September 11, 2026 07:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

actions documentation General documentation tasks release

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants