experiments/README.md

Riprap experiments

Exploratory model-prototyping scratch space. Nothing here ships to production until it has a RESULTS.md documenting double-gated validation (Ollama + AMD vLLM) and an integration plan agreed upstream.

Conventions

• Each experiment is NN_<name>/ and is fully self-contained.
• shared/ is the only cross-experiment code: backend client (shared/backends.py), doc_id helpers (shared/doc_id.py), trace renderer mock (shared/trace_render.py), and the running license ledger (shared/licenses.md).
• .cache/ directories inside experiments hold downloaded HF models and cached HTTP responses; gitignored.
• requirements-experiments.txt (top-level) is the experiment-only dependency set. Production requirements.txt is not modified.
• All experiments call into Riprap's existing LLM abstraction via from app import llm (or shared.backends). Experiments do not fork the call surface.

Test addresses

Three points used across all experiments — they exercise the three NYC flood mechanisms and one each from Brooklyn / Queens / Bronx.

Name	lat, lon	Mechanism
Brighton Beach (Brooklyn)	40.5780, -73.9617	coastal
Hollis (Queens)	40.7115, -73.7681	pluvial
Hunts Point (Bronx)	40.8155, -73.8830	mixed

Status

Phase	Specialist	Status
0	Endpoints smoke tests	done · 8/8 pass
1	Prithvi-EO live water segmentation	done · double-gated 3/3 addresses
2	GLiNER structured extraction	done · double-gated on real corpus PDF
3	Granite Embedding Reranker R2	done · double-gated; reorders top-3
4	TerraMind synthetic SAR	post-hackathon
5	SAM 2 promptable	post-hackathon
6	Chronos-Bolt forecast	post-hackathon