stt-optimize

Analyzer and flag-recommender for STT builds. It inspects an input's spatial extent, temporal distribution, geometry mix, and density, then recommends stt-build settings — zoom range, temporal bucket — so you don't hand-tune them per dataset. The same logic is what runs inside stt-build --auto; the CLI exists to run the analysis standalone, inspect the reasoning (--verbose), or emit machine-readable reports.

Internal implementation crate of spatiotemporal-tiles: the analysis library (the facade's optimize module). The stt-optimize CLI ships with the facade:

cargo install spatiotemporal-tiles --features cli

Example

# Analyze an input (also accepts an existing single-file archive via --stt):
stt-optimize analyze --input data.parquet --time-field timestamp \
  --time-format unix-ms

# Print a copy-pasteable stt-build invocation:
stt-optimize recommend --input data.parquet --time-field timestamp \
  --time-format unix-ms --show-command

# Machine-readable, for pipelines:
stt-optimize analyze --input data.parquet --time-field timestamp \
  --time-format unix-ms --format json -o report.json

Relation to the other crates

Reads inputs via stt-core; stt-build calls the library entry point (recommend_for) when invoked with --auto, applying the zoom-range and temporal-bucket recommendations (compression is not applied — the packed format is zstd-only).

Docs

• CLI reference
• stt-build flag reference
• Packed format spec

License: MIT.