Skip to content

State the codec each Spark value travels in, a box's among them - #60

Merged
estebanzimanyi merged 1 commit into
MobilityDB:mainfrom
estebanzimanyi:docs/codec-from-catalog
Sep 28, 2026
Merged

estebanzimanyi merged 1 commit into
MobilityDB:mainfrom
estebanzimanyi:docs/codec-from-catalog

Conversation

@estebanzimanyi

Copy link
Copy Markdown
Member

The generated surface carries a value in the codec the MEOS catalog states for its type:
temporal values, spans, span sets, sets, boxes, circular buffers, network points and poses as
their WKB bytes, read as well from their hex-WKB text and, for a type with a generic text
reader, from their text form; geometries as EWKT, read from WKT or EWKT; network segments and
JSON as their text form. The README states that rule, and
values_travel_as_wkb_and_hex_wkb_stays_readable reads a box back as byte[], writes it out as
its text, and answers hasZ over its text literal.

Witness. The box check fails on the generator of JMEOS 04e0a71e, whose boxes travel as text:
a box travels as WKB, got class java.lang.String.

Measured. Against JMEOS main e47aa744, the catalog and libmeos of MobilityDB 438528db44 with
MEOS-API 20efba81be and the jar JMEOS builds from them, the suite runs 21 tests, all passing.

Why. The README and the test state the form each value takes, so the codec the catalog
decides reaches the suite and the reader of the binding alike.

The generated surface carries a value in the codec the MEOS catalog states for its type:
temporal values, spans, span sets, sets, boxes, circular buffers, network points and poses as
their WKB bytes, read as well from their hex-WKB text and, for a type with a generic text
reader, from their text form; geometries as EWKT, read from WKT or EWKT; network segments and
JSON as their text form. The README states that rule, and
values_travel_as_wkb_and_hex_wkb_stays_readable reads a box back as byte[], writes it out as
its text, and answers hasZ over its text literal.

Witness. The box check fails on the generator of JMEOS 04e0a71e, whose boxes travel as text:
a box travels as WKB, got class java.lang.String.

Measured. Against JMEOS main e47aa744, the catalog and libmeos of MobilityDB 438528db44 with
MEOS-API 20efba81be and the jar JMEOS builds from them, the suite runs 21 tests, all passing.

Why. The README and the test state the form each value takes, so the codec the catalog
decides reaches the suite and the reader of the binding alike.
@estebanzimanyi
estebanzimanyi merged commit ca72e95 into MobilityDB:main Sep 28, 2026
2 checks passed
@estebanzimanyi
estebanzimanyi deleted the docs/codec-from-catalog branch September 28, 2026 14:52
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