Add the temporal-covering descriptor to the catalog#24
Open
estebanzimanyi wants to merge 1 commit into
Open
Conversation
This was referenced Jun 26, 2026
Fold meta/temporal-covering.json into meos-idl.json as temporalCovering, the single codegen source of truth for projecting a MEOS temporal column into Parquet/Iceberg covering columns (RFC #870 TemporalParquet / #913 Temporal Data Lake). Every binding generates the identical covering schema, so a temporal table prunes the same way on every platform (Iceberg manifest + Parquet row-group min/max) with no spatial-aware engine. The descriptor is keyed by temporal-type class, not by type: the spatial class derives an STBOX covering (xmin..zmax, tmin/tmax, srid) via tspatial_to_stbox; the number class derives a TBOX covering (vmin/vmax, tmin/tmax) via tnumber_to_tbox. parser/covering.py attaches it with a byType index and the set of referenced C symbols; tools/covering_parity.py audits that every symbol is exported by the catalog and every covered type is a real MeosType, reporting any miss as a worklist rather than a pass. Mirrors the portable-aliases infrastructure (descriptor + schema + parser hook + parity audit + tests + doc).
estebanzimanyi
force-pushed
the
feat/temporal-covering-descriptor
branch
from
5501138 to
a0af945
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Folds
meta/temporal-covering.jsonintomeos-idl.jsonastemporalCovering— the single codegen source of truth for projecting a MEOS temporal column into Parquet/Iceberg covering columns (RFC #870 TemporalParquet / #913 Temporal Data Lake). Every binding/engine generates the identical covering schema from this one mapping, so a temporal table prunes the same way on every platform (Iceberg manifest pruning + Parquet row-group min/max) with no spatial-aware engine — GeoParquet 1.1covering.bbox.What it adds
meta/temporal-covering.json(+ JSON schema) — curated descriptor keyed by temporal-type class, not by type:spatial→STBOXcovering (xmin..zmax,tmin/tmax,srid) viatspatial_to_stbox/tspatial_srid— tgeompoint, tgeogpoint, tgeometry, tgeography, tcbuffer, tnpoint, tpose, trgeometry.number→TBOXcovering (vmin/vmax,tmin/tmax) viatnumber_to_tbox— tint, tfloat, tbigint.temporal_as_hexwkb/temporal_from_hexwkb; the canonical MEOS-WKB value column stays lossless, covering columns are denormalised derivations.parser/covering.py—attach_temporal_coveringfolds it into the catalog with abyTypeindex and the set of referenced C symbols.tools/covering_parity.py— audits that every referenced symbol is exported by the catalog and every covered type is a realMeosType; a miss is reported as a worklist (add/export the accessor in MEOS), never a fabricated pass.docs/temporal-covering.md. Mirrors the portable-aliases infrastructure exactly.Verification
tests/test_covering.py+tests/test_covering_parity.pygreen (11 tests).MeosType.Not yet covered (surfaced as gaps, not filled binding-side)
tbool,ttext): needs a span lower/upper bound accessor (not exported) — close in MEOS C.spatialonce a uniform temporal→STBOXconverter is confirmed.