From 7a02de828ea8ca89f64ff20662ed1df965a7b092 Mon Sep 17 00:00:00 2001 From: Jathavaan Shankarr Date: Wed, 3 Jun 2026 16:11:58 +0200 Subject: [PATCH] docs: cross-link data-contribution and analytics repos Add a Related repositories section with the data -> benchmark -> analysis pipeline so readers can navigate between the three interdependent repos. Link it from the table of contents. Closes #365 --- README.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/README.md b/README.md index 24a8ceaa..21076e9b 100644 --- a/README.md +++ b/README.md @@ -17,8 +17,28 @@ measurable and reproducible on identical datasets and hardware. +## Related repositories + +doppa is the middle stage of a three-repository pipeline built for the thesis (TBA4925, NTNU Geomatics). +The repos depend on each other end to end: datasets are published upstream, benchmarked here, and analysed +downstream. + +``` +doppa-data-contribution ──► doppa ──► doppa-analytics + publish datasets (this repo) read results, build + to blob storage run engines thesis figures/tables + write metrics +``` + +| Repository | Role | Link | +|------------|------|------| +| **doppa-data-contribution** | Downloads OSM, FKB, Microsoft Buildings, and municipality boundaries, normalizes them to the shared GeoParquet schema, and publishes them to the `contributions` blob container that this framework reads | [kartAI/doppa-data-contribution](https://github.com/kartAI/doppa-data-contribution) | +| **doppa** | Reproducible benchmarking framework. Consumes the published datasets, runs the spatial-query benchmarks on Azure, and writes per-iteration samples and cost rows back to blob storage *(this repo)* | — | +| **doppa-analytics** | Reads the benchmark result Parquet from blob storage, runs the statistical tests (Wilcoxon, bootstrapped CIs, Vargha–Delaney Â12), and generates the thesis figures and LaTeX tables | [kartAI/doppa-analytics](https://github.com/kartAI/doppa-analytics) | + ## Table of contents +- [Related repositories](#related-repositories) - [Research gaps addressed](#research-gaps-addressed) - [Benchmarking framework](#benchmarking-framework) - [Measurement loop](#measurement-loop)