docs: describe the settled code for chapters 7 to 11

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
This commit is contained in:
Kjell Tore Guttormsen 2026-11-12 14:33:50 +01:00
commit a705842f88
Signed by: ktg
SSH key fingerprint: SHA256:JakMjO6FTBBzN0Bhfj9saOoEjaFxlSdYuZQQpM/lF9Q
3 changed files with 20 additions and 8 deletions

View file

@ -35,3 +35,13 @@ All notable changes to this project will be documented in this file.
to the project owner (`modell/fagfellevurdering-utkast-2-og-3.md`, part 5).
- The price lines of S38 are held against NVE's twelve scenarios: within 5 % for Norway and three price areas,
6.0 % and 7.7 % off in one scenario for NO3 and NO4, kept as documented expected failures.
- Business economics, ownership, scale, environment and verdicts in code (`nivaaisert.py`, `eierskap.py`,
`skala.py`, `miljo.py`, `dommer.py`; S15, S19, S27 to S32, S37, S42), tested on made-up numbers only. A third
independent reader coded the same chapters from the specification alone and found 60 points, 14 of them
objections to the economics; a new reader then recoded from the clarifications in four more rounds (17, 5, 1
and 0 new points). The readings stand in clarifications 41–61 in chapter 16; the two implementations agree on
1 000 made-up paths. Corrected after the readers: the accident cost stays when the additionality rule binds,
tax depreciation loses real value with price growth, and the special tax only meets return above the cost of
capital. Weaknesses in the comparison of ownership forms that are not corrected are listed in clarification 61
and put to the project owner (`modell/fagfellevurdering-utkast-2-og-3.md`, part 6). No result for the
hypothesis has been computed.

View file

@ -33,9 +33,10 @@ carousel, Python code, and a Claude plugin (own repo, later).
years. `nivaaisert.py` (the power cost per facility, year and vintage on levelised form; S15, S19, S27, S42),
`eierskap.py` (S28 to S30: business cash flow, tax, ownership forms, the criteria over the draws), `skala.py`
(S31, M6), `miljo.py` (S32, the rules of M5) and `dommer.py` (S37, the verdict per target, the step of the
ladder, the overall verdicts) cover chapters 7 to 11. They are a first coding: the readings in them are being
held against an independent reader's code and are not yet settled in chapter 16. The run over the draws, the
sensitivities and the tools of chapter 12 are not coded yet.
ladder, the overall verdicts) cover chapters 7 to 11. The readings in them stand in chapter 16 (clarifications
41 to 61), settled against an independent reader's code; clarification 61 lists weaknesses in the comparison of
ownership forms that are not corrected. The run over the draws, the sensitivities and the tools of chapter 12
are not coded yet.
- `data/trekninger.npy` and `data/trekninger.json`: the 10 000 draws of the 87 drawn quantities, in the parameter
file's units. `data/aarshendelser.npy` and `.json`: one uniform number per draw and year 2028–2100 for the
export rule (own seed). Committed; every later computation reads them.

View file

@ -17,16 +17,17 @@ skal si når satsingen lønner seg, og når den ikke gjør det.
kildebanken. Sjekksummen står i forhåndsregistreringen.
- `modell/fagfellevurdering-utkast-1.md` og `modell/fagfellevurdering-utkast-2-og-3.md`: hva uavhengige lesere
fant i utkastene, og hva som er gjort med det.
- `src/tokenfabrikker/`: koden. Én funksjon per ligning, med samme nummer som i spesifikasjonen. Foreløpig
kraftverket, datasenteret og inntekten (kapittel 1–3), utbyggingen (kapittel 4), kraftsystemet (kapittel 5) og
kontantstrømmen med netto nåverdi for Norge (kapittel 6), og innlesing av parameterne og trekningene.
Bedriftsøkonomien, eierformene, skala, miljø og dommene er ikke kodet ennå.
- `src/tokenfabrikker/`: koden. Én funksjon per ligning, med samme nummer som i spesifikasjonen: kraftverket,
datasenteret og inntekten (kapittel 1–3), utbyggingen (kapittel 4), kraftsystemet (kapittel 5), kontantstrømmen
med netto nåverdi for Norge (kapittel 6), bedriftsøkonomien, eierformene, skala, miljø og dommene (kapittel
7–11), og innlesing av parameterne og trekningene. Kjøringen over trekningene, følsomhetene og verktøyene er
ikke kodet ennå, og ingen resultater er regnet.
- `data/trekninger.npy`: de 10 000 trekningene av parameterne, laget med fast frø. `data/trekninger.json` sier hva
kolonnene er. `data/aarshendelser.npy` er en egen strøm av tilfeldige tall for eksportregelen, ett tall per
trekning og år.
- `tests/`: testene. `tests/test_fasit.py` holder koden mot fire publiserte beregninger (Argonne, NOU 2026: 4,
Epoch og NVE). Der koden ikke treffer innenfor 5 %, står avviket åpent i testen og i fagfelleloggen.
Utbyggingen og kontantstrømmen er testet på oppdiktede tall, ikke på de frosne parameterne.
Alt fra utbyggingen og utover er testet på oppdiktede tall, ikke på de frosne parameterne.
## Kjøre testene
Krever Python 3.11 eller nyere.