Crate stt_core 

Core library for the SpatioTemporal Tiles (STT) format.

The canonical container is the packed format (pack): a per-dataset manifest.json plus many content-addressed, immutable pack objects (packs/<blake3>.sttp) and one directory object (index/<blake3>.sttd). Splitting a dataset into small, immutable objects is what makes it edge-cacheable on a plain CDN — see docs/spec/stt-packed-format.md.

Building blocks:

• pack — the packed format: PackWriter, PackedReader, Manifest, verify_packed_objects.
• arrow_tile — Arrow-IPC tile payloads with GeoArrow geometry.
• directory — the run-length tile directory (v5) and its TileEntry.
• curve — spatial (Hilbert) + temporal blob ordering.
• metadata — dataset metadata (folded verbatim into the manifest).
• compression — per-blob zstd.

Re-exports

pub use pack::verify_packed_objects;

pub use pack::Manifest;

pub use pack::PackWriter;

pub use pack::PackedReader;

pub use directory::TileEntry;

pub use directory_page::decode_paged_directory;

pub use directory_page::encode_paged_directory;

pub use directory_page::verify_paged_structure;

pub use directory_page::PageDescriptor;

pub use directory_page::PagedRoot;

pub use directory_page::DEFAULT_PAGE_ENTRIES;

pub use curve::BlobOrdering;

pub use ordering_sim::evaluate as evaluate_orderings;

pub use ordering_sim::measured_ordering;

pub use ordering_sim::OrderingCost;

pub use ordering_sim::QueryCost;

pub use ordering_sim::SimOptions;

pub use ordering_sim::TileSample;

pub use ordering_sim::CANDIDATES;

pub use ordering_sim::DEFAULT_COALESCE_GAP_BYTES;

pub use error::Error;

pub use error::Result;

pub use tile::TileId;

pub use timestamp::normalize_timestamp_to_ms;

pub use timestamp::reject_negative_timestamp;

pub use timestamp::scale_timestamp_to_ms;

pub use timestamp::TimestampUnit;

pub use types::BoundingBox;

pub use types::TimeRange;

Modules

arrow_tile

Arrow-based tile payload format.

budget

Tile size budget enforcement and intelligent feature dropping

compression

Compression utilities for tiles. The format is zstd-only — there is no gzip path (it was never shipped; zstd beats it on both ratio and browser decode). Compression::None exists only for already-incompressible blobs.

curve

Space-time blob ordering for the packed writer.

directory

STT v5 directory — a compact, range-request-friendly tile index.

directory_page

Paged-directory container (Wave 2 — COPC/GeoParquet-1.1 steal).

error

Error types for the STT library

geometry

Geometry processing utilities

metadata

Archive metadata structures

ordering_sim

Measured blob-ordering picker: simulate per-ordering HTTP range-read cost.

pack

STT packed format — a multi-object, edge-cacheable container.

projection

Coordinate projection utilities

tile

Tile types and operations

timestamp

Shared timestamp-unit normalization for all STT input adaptors.

types

Core types used throughout the STT library