Skip to content

feat(meos): add the set-set spatial-join helper to the shared facade (stacks on #24)#25

Open
estebanzimanyi wants to merge 7 commits into
MobilityDB:mainfrom
estebanzimanyi:feat/jmeos-setset-join
Open

feat(meos): add the set-set spatial-join helper to the shared facade (stacks on #24)#25
estebanzimanyi wants to merge 7 commits into
MobilityDB:mainfrom
estebanzimanyi:feat/jmeos-setset-join

Conversation

@estebanzimanyi
Copy link
Copy Markdown
Member

MeosSetSetJoin exposes the MEOS *_tgeoarr_tgeoarr family as eDwithinPairs / tDwithinPairs / aDisjointPairs over two arrays of temporal-geometry handles: it marshals the native pointer arrays the kernel prunes in C, keeps them reachable across the call with reachabilityFence, and reads back the flattened 0-based index pairs (and, for tDwithin, the per-pair tstzspanset of in-range times). Both JVM engines call it from the shared org.mobilitydb.meos layer so the NxN spatial-join surface derives once; verified against the pinned libmeos.

… surface

Bump codegen/input/meos-idl.json to the MEOS-API IDL and regenerate
functions.GeneratedFunctions over the full consolidated superset: mul_* (incl.
tbigint); minDistance; the circular-buffer and network-point MF-JSON readers; the
ever- and always-covers families (ecovers_*/acovers_*); trgeo_*; the H3 /
th3index family (ever_eq_h3indexset_th3index, h3index_in/out, H3Index lowered to
long); PostgreSQL type I/O; tgeogpoint_great_circle_distance;
meos_initialize_noexit_error_handler. 2916 functions.
…ld flags

The functions.GeneratedFunctions facade is generated at build time from the MEOS
IDL with the optional type families selected by the same flag names and ON|OFF
(also 1|0) values as the MobilityDB/MEOS build: -DCBUFFER, -DNPOINT, -DPOSE,
-DRGEO, -DH3. Every family is included by default; passing -DCBUFFER=OFF (or =0)
drops that family's functions from the generated binding so a subset jar ships
without it (RGEO needs POSE). FunctionsGenerator maps each function's source
header to its family and omits excluded families; jmeos-core runs the generator
at generate-sources (so the flag flows through mvn) and compiles the generated
functions.GeneratedFunctions.
…try C API

MobilityDB #1137 renamed the public rigid-geometry C API from trgeo to
trgeometry. The MEOS IDL the facade is generated from adopts the new names
(verified 1:1 against the master meos_rgeo.h: 67 trgeo->trgeometry; the
trgeoinst_make instant constructor is unchanged, matching master), so the
generated functions.GeneratedFunctions and the bundled jar resolve against a
post-#1137 libmeos.
Bumps codegen/input/meos-idl.json to the public+bound MEOS surface of the
ecosystem pin: the set-set spatial-join family (edwithin/tdwithin/adisjoint
_tgeoarr_tgeoarr), the mindistance_tgeoarr_tgeoarr rename, the trgeometry
analytics (frechet/hausdorff/dyntimewarp/centroid/length/speed), tpose and
tnpoint value accessors, tcbuffer traversed-area, and the aggregate combine
functions. 3031 bound functions (was 2916).
Hoists the tier-aware MeosOps* facade (62 classes) into JMEOS so every
JVM binding inherits the one canonical Java idiom from the shared jar
instead of duplicating it per engine. The facade forwards to
functions.GeneratedFunctions under a package-private MeosOpsRuntime probe
gated by the canonical -Dmeos.enabled property; javadoc is engine-neutral.
Relocates the maintained generator (regen_facade_from_jar + the gap / sql /
tbigint / h3 emitters + parity_audit + meos-ref) under jmeos-core/tools so
the facade stays regenerated, not hand-edited; regeneration is idempotent
against the pin jar.
@estebanzimanyi estebanzimanyi force-pushed the feat/jmeos-setset-join branch from 783ebc7 to 769a4da Compare June 3, 2026 08:03
MeosSetSetJoin exposes the MEOS *_tgeoarr_tgeoarr family as eDwithinPairs /
tDwithinPairs / aDisjointPairs over two arrays of temporal-geometry handles:
it marshals the native pointer arrays the kernel prunes in C, keeps them
reachable across the call with reachabilityFence, and reads back the
flattened 0-based index pairs (and, for tDwithin, the per-pair tstzspanset of
in-range times). Both JVM engines call it from the shared org.mobilitydb.meos
layer, so the NxN spatial-join surface derives once. Verified against
libmeos.
@estebanzimanyi estebanzimanyi force-pushed the feat/jmeos-setset-join branch from 769a4da to 3f0a9d9 Compare June 3, 2026 08:10
The IDL and bundled libmeos carry the 54a9d4bc54 public surface: the per-thread
PROJ context, the box3d_in/gbox_in parsers, and tpose_to_tpoint. The parity-gap
forwarders bind the value-at-timestamptz wrappers through their result-returning
form and drop the pointcloud initializer absent from the surface.
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