portfolio-optimiser-commons/examples/veglys-fv-soer/index.md
Kjell Tore Guttormsen 002f000bf6 examples(veglys): VEGLYS-FV-SOER komplett — den forpliktede leveransen til 11.08 18:00
Ni filer: index i bundle-rota, `type: project`, to `type: hypothesis`, metode,
kilder, ett `type: verdict`-frø, og de to JSON-ene. Alle sju .md-filer er
verifisert nåbare fra index.md med specens eget lenkemønster
(`\]\(([^)]+\.md)\)`) — navigasjonen følger kun kryss-lenker, så en ulenket fil
ville forsvunnet tyst ut av read-contexten.

Tallkjeden er bygget fra to norske ankere: 114 W installert (NMFV, 100 W HPS +
14 W forkobling) og 4 050 brenntimer/år (Håndbok V124, 2021, midtpunkt i
4 000–4 100 for eldre vegbelysning). Alt annet er aritmetikk fra dem.

`cost-baseline.json` og `validator-input.json` bærer IDENTISK code, quantity og
unit_cost (`ENERGI-VEGLYS-EL`, 4 386 150, 1.0) — 5 %-toleransen
(BASELINE_TOLERANCE_DEFAULT) er lukket ved konstruksjon, ikke ved avstemming,
fordi begge filene er skrevet fra linjen `114 W × 9 500 × 4 050 t / 1 000`.
Målt avvik: 0,000000 %.

affected_items er HELE porteføljen, ikke de berørte punktene. Hadde den vært de
2 500 punktenes eget forbruk, ville besparelsen vært 38,6 % av den — over
30 %-cap-en — og det RIKTIGE forslaget blitt avvist på scenen. Med porteføljen
er claimed/nominal_feasible 0,3386, som ligger i samme familie som reservens
0,3333.

Ingen `golden.json`. Konsumenten svarte (a) på de tre veiene, og vår egen spec
peker samme vei: method-spec §3 steg 1 bygger ExpeL-folden fra verdict-filas
`description` pluss `[realiseringsgrad=…; forventet_faktisk_NOK=…]`, altså fra
frontmatteren — ikke fra golden. `learning_surface` ville vært en andre kopi
uten gate. Fasit og gate lander sammen etter 13.08.

Realiseringsgraden 0,81 er LÅNT fra belysnings-programlitteratur (National Grid
SBS 2010: 81,1 %; Efficiency Maine 2021: 3 053 metrede mot 3 772 antatte timer
= 0,809) og merket som lån i `provenance`. Det finnes ingen norsk ex-post-måling
for veglys — NVE/RME dokumenterer hvorfor: mange anlegg mangler måler. Det er
ikke et hull i bundelen, det er bundelens poeng. 0,81 × 445 500 = 360 855, som
lukker eksakt i heltall.

Reserven `bygg-energi-mikro` og nav-golden-settene er byte-urørt.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_014eutntDRkadNX4von1a6HV
2026-08-09 14:36:17 +02:00

4.1 KiB

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.mdtype: project — porteføljen, energibaselinen og rammene.
  • tiltak-led-utskifting.mdtype: 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.mdtype: 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.mdtype: methodology — M&V-metoden (IPMVP Option A), og hvorfor de øvrige opsjonene er stengt for et umålt veglysanlegg.
  • kilder-veglys-realisering.mdtype: reference — verifisert litteratur: norske baseline- og regelverksankere, og programlitteraturen realiseringsgraden er lånt fra.
  • verdict-veglys-fro.mdtype: 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.