portfolio-optimiser/shared/examples/veglys-fv-soer/index.md

type	okf_version	title	description	tags	timestamp
index	0.1	Veglys fylkesveg sør — LED-utskifting og adaptiv styring	OKF-bundle for en fylkeskommunal veglysportefølje med to kandidat-tiltak: LED-utskifting av 2 500 eldre HPS-lyspunkter, og adaptiv styring som utnytter den tillatte vedlikeholdsfaktoren. Bygget rundt et dokumentert norsk evidensgap — uten måler kan realiseringsgraden ikke ses.	energieffektivisering veglys vegbelysning M&V IPMVP realiseringsgrad	2026-08-09

Veglys fylkesveg sør

En OKF-bundle for utskifting og styring av veglysanlegg langs fylkesveg: én portefølje, to kandidat-tiltak. Den deler lærings-overflate med bygg-energi-mikro-bundelen, men står på egne ben: metode- og kildelaget er materialisert inn her, ikke lenket på tvers av bundler, og evidensgrunnlaget er norsk der det teller.

Framework-nøytral artefakt (null kode-avhengighet). Deles uendret mellom implementasjonene. Se shared/README.md.

Prosjektlaget er fiktivt, litteraturlaget er ekte. Porteføljen «Fylkesveg Sør» finnes ikke; parameterne den er bygget av (installert effekt, brenntimer, energipris, realiseringsgrad) er hentet fra navngitte primærkilder og merket [V] der de er verifisert. Det er samme konvensjon som mikro-bundelen bruker — en produksjons-deployer erstatter prosjektlaget med en ekte kunnskapsbase og beholder litteraturlaget.

Hvorfor veglys

Domenet ble valgt fordi det bærer lærings-overflaten skarpere enn kontorbygget gjør.

I et kontorbygg er gapet mellom modellert og realisert besparelse målbart, men sjelden målt. I norsk veglys er det noe strengere: NVE og RME dokumenterer at mange veilysanlegg mangler måling helt, eller avregnes på estimerte verdier. Uten meterdata finnes det ingen ex-post å sammenligne ex-ante med. Realiseringsgraden er ikke ukjent fordi ingen har regnet på den — den er strukturelt usynlig.

Det gjør domenet til et godt frø for lærings-sløyfa: den eneste kilden til korreksjon er akkumulert ekspert-erfaring, som er nøyaktig det verdict-laget bærer og validatoren ikke kan regne. Se verdict-veglys-fro.md.

Innhold (progressiv disclosure)

• veglys-fv-soer.md — type: project — porteføljen, energibaselinen og rammene.
• tiltak-led-utskifting.md — type: hypothesis — kandidat-tiltak 1: LED-utskifting av 2 500 eldre HPS-lyspunkter. Det er dette tiltaket som er projisert inn i validatoren.
• tiltak-adaptiv-styring.md — type: hypothesis — kandidat-tiltak 2: adaptiv styring som henter ut den overdimensjoneringen vedlikeholdsfaktoren allerede tillater. Svakere kildebelagt enn tiltak 1, og merket slik.
• metode-ipmvp-a.md — type: methodology — M&V-metoden (IPMVP Option A), og hvorfor de øvrige opsjonene er stengt for et umålt veglysanlegg.
• kilder-veglys-realisering.md — type: reference — verifisert litteratur: norske baseline- og regelverksankere, og programlitteraturen realiseringsgraden er lånt fra.
• verdict-veglys-fro.md — type: verdict — frøsatt ekspert-dom. ExpeL-frøet loopens steg 1 henter fra.

Hvordan den kjøres i dag

validator-input.json er IR-projeksjonen den eksisterende deterministiske validatoren konsumerer uendret; cost-baseline.json bærer det samme tallgrunnlaget som prosjektets kostdata. De to filene er bygget fra samme linje aritmetikk og bærer identisk code, quantity og unit_cost — se tiltak-led-utskifting.md, §«Mapping til validatoren».

Bundelen ships uten golden.json. Den blokken er kryss-implementasjons-fasit produsert av en seedet Monte Carlo, og commons har ingen kjørbar pipeline å produsere den med. En fasit ingen gate leser er verre enn ingen fasit. Lærings-overflaten går ikke tapt: de strukturerte feltene ExpeL-folden faktisk henter (realization_rate, expected_actual_saving_nok) ligger i frontmatteren til verdict-veglys-fro.md, som er der loopen leser dem.