spatialpack benchmark

Synopsis

spatialpack benchmark <command> [options]

Description

Pack quality benchmark commands.

Run quality benchmarks against built PMTiles files with configurable metrics and pass/fail gates. Suitable for CI regression testing.

Commands

Command	Description
benchmark run	Run a benchmark against a PMTiles file.

Examples

# Inspect an existing PMTiles file
spatialpack benchmark run pipelines/wa-road-z10.benchmark.yaml

# Build pipeline first, then inspect output
spatialpack benchmark run pipelines/wa-road-z10.benchmark.yaml --build

# Custom result output directory
spatialpack benchmark run spec.yaml --output ./benchmark-results/

Command Details

benchmark run

Run a benchmark against a PMTiles file.

SPEC_PATH is the path to a .benchmark.yaml file.

Exit codes: 0 — all gates passed 1 — one or more gates failed 2 — runtime error (missing file, load failure, infrastructure error)

spatialpack benchmark run SPEC_PATH [options]

Arguments

SPEC_PATH — path (required)

Options:

Option	Type	Default	Description
--build	flag	false	Run pipeline build (from spec’s pipeline_spec field) before inspecting
--output	path	-	Override default result output directory (default: benchmarks/results/)

# Inspect existing PMTiles
spatialpack benchmark run pipelines/wa-road-z10.benchmark.yaml

# Build pipeline first
spatialpack benchmark run pipelines/wa-road-z10.benchmark.yaml --build

# Custom output directory
spatialpack benchmark run spec.yaml --output ./ci-results/