Skip to content

MobilitySpark canonical UDF foundation library (temporal/geo/base)#22

Closed
estebanzimanyi wants to merge 1 commit into
MobilityDB:mainfrom
estebanzimanyi:feat/canonical-jmeos-udf-library
Closed

MobilitySpark canonical UDF foundation library (temporal/geo/base)#22
estebanzimanyi wants to merge 1 commit into
MobilityDB:mainfrom
estebanzimanyi:feat/canonical-jmeos-udf-library

Conversation

@estebanzimanyi

Copy link
Copy Markdown
Member

The MobilitySpark UDF library bound to the canonical single-source functions.GeneratedFunctions surface (the MEOS-API / meos-idl.json codegen output), bundled as libs/JMEOS-1.4.jar regenerated against the ecosystem pin, with lib/libmeos.so built from the pin (CBUFFER/NPOINT/POSE/RGEO + H3).

Covers the full temporal, geo, cbuffer, npoint, pose, rgeo, th3index and portable-operator UDF families plus the boxes/time/set surfaces — every UDF binds the generated surface directly; the legacy hand-rolled functions.functions facade is retired. The pg_-prefixed PG-compat I/O (pg_interval_in/out, pg_timestamptz_in) is preserved to disambiguate the PostgreSQL built-ins of the same name.

CI builds libmeos from the ecosystem pin on Linux/macOS (with H3, and an in-source build dir so pgtypes/postgres.h's relative ../../meos/include resolves); Windows is non-blocking. Full unit suite green (907/907).

The BerlinMOD benchmark harness and the 3-tier index framework build on this library in a separate change (the integration branch #16 carries both as the benchmark/evidence vehicle).

@estebanzimanyi estebanzimanyi force-pushed the feat/canonical-jmeos-udf-library branch from aadd4b0 to be26d13 Compare June 12, 2026 10:42
@estebanzimanyi estebanzimanyi force-pushed the feat/canonical-jmeos-udf-library branch from be26d13 to d872b53 Compare June 12, 2026 11:42
@estebanzimanyi estebanzimanyi changed the title MobilitySpark canonical UDF library on the generated JMEOS surface MobilitySpark canonical UDF foundation library (temporal/geo/base) Jun 12, 2026
The MobilitySpark base UDF library — temporal, geo, boxes, time and set
surfaces plus the base infrastructure — bound to the canonical single-source
functions.GeneratedFunctions surface (the MEOS-API / meos-idl.json codegen
output), bundled as libs/JMEOS-1.4.jar regenerated against the ecosystem pin,
with lib/libmeos.so built from the pin (CBUFFER/NPOINT/POSE/RGEO + H3).

Every UDF binds the generated surface directly; the legacy hand-rolled
functions.functions facade is retired. The pg_-prefixed PG-compat I/O
(pg_interval_in/out, pg_timestamptz_in) is preserved to disambiguate the
PostgreSQL built-ins of the same name.

CI builds libmeos from the ecosystem pin on Linux/macOS (with H3, and an
in-source build dir so pgtypes/postgres.h's relative ../../meos/include
resolves); Windows is non-blocking. Full unit suite green (907/907).

The th3index, sibling (cbuffer/npoint/pose/rgeo) and portable-operator families
stack on this foundation as separate changes; the BerlinMOD benchmark builds on
the full surface.
@estebanzimanyi estebanzimanyi force-pushed the feat/canonical-jmeos-udf-library branch from d872b53 to 4ab3524 Compare June 12, 2026 12:52
estebanzimanyi added a commit to estebanzimanyi/MobilitySpark that referenced this pull request Jun 14, 2026
GeneratedSurfaceTest registers the catalog-generated UDFs
(GeneratedSpatioTemporalUDFs.registerAll) in a real SparkSession and asserts
results across families via spark.sql against libmeos: temporal_num_instants==3,
tint_start_value==1, tint_out renders the values, tnumber_integral is finite —
the safety gate proving the generated surface binds and executes before the hand
UDF layers (MobilityDB#22/MobilityDB#24/MobilityDB#25/MobilityDB#26) are retired. Adds junit-jupiter + surefire (fork per
class, JDK17 --add-opens) and bumps jnr-ffi to 2.2.17.

NOTE: these Spark-integration tests require JDK 17 — Spark 3.4 cannot init on
JDK 21 (DirectByteBuffer.<init>(long,int) removed) and the Java-17 JMEOS jar
cannot load on JDK 11. CI must run the Spark build/test on JDK 17.
estebanzimanyi added a commit to estebanzimanyi/MobilitySpark that referenced this pull request Jun 14, 2026
GeneratedSurfaceTest registers the catalog-generated UDFs
(GeneratedSpatioTemporalUDFs.registerAll) in a real SparkSession and asserts
results across families via spark.sql against libmeos: temporal_num_instants==3,
tint_start_value==1, tint_out renders the values, tnumber_integral is finite —
the safety gate proving the generated surface binds and executes before the hand
UDF layers (MobilityDB#22/MobilityDB#24/MobilityDB#25/MobilityDB#26) are retired. Adds junit-jupiter + surefire (fork per
class, JDK17 --add-opens) and bumps jnr-ffi to 2.2.17.

NOTE: these Spark-integration tests require JDK 17 — Spark 3.4 cannot init on
JDK 21 (DirectByteBuffer.<init>(long,int) removed) and the Java-17 JMEOS jar
cannot load on JDK 11. CI must run the Spark build/test on JDK 17.
@estebanzimanyi

Copy link
Copy Markdown
Member Author

Superseded by the catalog-driven generator (#27 foundation + #28 generated dispatch) and the rebuilt benchmark (#23), which now consumes the catalog-GENERATED UDF surface end-to-end. Per the North Star (bindings generated from the MEOS-API catalog, zero hand-written UDF surface), this hand UDF layer is retired; #23 no longer stacks on it, so there is no remaining consumer.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant