Examples

The examples are executable Jupyter notebooks, committed with their outputs, so every page below shows real results. They live in the repository’s examples/ directory; run them yourself with the examples pixi environment (pixi run -e examples jupyter lab).

Each notebook is self-contained. The first five write their files to the system temporary directory; the taxi notebook builds its file from a small committed sample of the public NYC TLC trip data, so it too runs offline.

Notebook	Covers
Quickstart	Create → append → read → validate, and reopen from disk.
Column types	Fixed-length strings (no silent truncation), categoricals, booleans, valid ranges, and missing values.
List columns	list<float>, list<str>, nested lists, null versus empty, and the offsets layout.
Filters and storage	Per-column filter pipelines, hdf5plugin codecs, compression ratios, and the raw HDF5 layout.
JSON logs	Modeling semi-structured log records with columns and list columns.
NYC taxi trips	A real dataset end to end: categoricals, both missing-value styles, a datetime codec, filters, and indexed queries with explain().