docs: clarification 133, review log part 17, and the tools in README, CHANGELOG and CLAUDE.md

What the coding and an independent reader found in clarifications 126 to
133, the reproduction of the made-up reference files, the measured time for
the 42 rows, and the changed hypothesis in CLAUDE.md and CHANGELOG.

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
This commit is contained in:
Kjell Tore Guttormsen 2026-11-13 22:01:25 +01:00
commit 11f312f1ac
Signed by: ktg
SSH key fingerprint: SHA256:JakMjO6FTBBzN0Bhfj9saOoEjaFxlSdYuZQQpM/lF9Q
5 changed files with 186 additions and 4 deletions

View file

@ -188,3 +188,19 @@ All notable changes to this project will be documented in this file.
figure differs between the two codes, by at most 6e-5: the reader does not scale decommissioning after the
final year in the efficiency row, and the specification says it is scaled
(`modell/fagfellevurdering-utkast-2-og-3.md`, part 16). No result has been computed.
- The tools of chapter 12, fixed in text before they were coded (clarifications 126 to 133) and tried on
made-up numbers only: everything a run needs is one basis (`grunnlag.py`); the main run writes six data
files in a fixed format without rounding (`datafiler.py`); and the command line (`verktoy.py`) has
`hovedkjoring`, `kontroll`, `scenario`, `folsomhet`, `terskel`, `sammenlign` and `arbeidskopi`, with input
in JSON where an unknown field is an error. `kontroll` writes the files again and says «identisk»,
«innenfor toleranse» or «endret». A made-up basis with 200 draws and the files written from it are stored
with the tests; they are reproduced byte for byte with one and with eight processes and in a new process.
The tools cannot yet run on the frozen parameters: the EEA assessment per ownership form is not written
down. No result has been computed.
- The map from equation to function (`modell/kart.md`), generated from the code and held against it by a test:
each of the 54 equations points to at least one function.
- The project owner changed the hypothesis on 13 November 2026, before any result: it is that AI data centres
owned in principle by the state can become a source of income for Norway as oil has been. A dedicated
nuclear plant per data centre is one of the power solutions that are compared, on equal terms. The targets
M1 to M6 and their thresholds are unchanged. The texts and the code that give that solution a verdict of its
own are rewritten before anything is computed (`FORHANDSREGISTRERING.md`, «Endringer»).

View file

@ -113,11 +113,24 @@ carousel, Python code, and a Claude plugin (own repo, later).
`Dimensjonering`) and of `regn_program` (`paaslag`, `diskontering`, `skattekostnad`); with them off every
figure is unchanged to the last digit. The four rows of the ownership forms go through
`kjoring.eierformer_paa_trinnet(..., rad=Eierrad...)`, which also gives the state's cash flow next to M6
(clarification 123). The low and the high path of the carbon price are passed in by the caller. The tools
of chapter 12 are not coded.
(clarification 123). The low and the high path of the carbon price are passed in by the caller.
The tools of chapter 12 (clarifications 126 to 133): `grunnlag.py` holds everything a run needs besides
the model code (`Grunnlag`: the sets per draw, the drawn values and their status, M5, the EEA assessment,
the carbon paths, the mark «frosset», «endret» or «oppdiktet»); `fra_fil` reads a made-up basis file,
`fra_frys` builds it from the freeze and stops before it reads anything until the EEA assessment per
ownership form is written down in the text (missing before part 6). `datafiler.py` builds and writes the
six files of the main run (`dommer.json`, `tidslinje.json`, `eierformer.json`, `terskler.json`,
`folsomheter.json`, `innhold.json`; fixed field order, no rounding, `null` for no value) and compares two
folders (`sammenlign_mapper`: «identisk», «innenfor toleranse» at relative 1e-9, «endret»). `verktoy.py`
is the command line: `hovedkjoring`, `kontroll`, `scenario`, `folsomhet`, `terskel`, `sammenlign`,
`arbeidskopi`; every command that computes takes `--grunnlag FIL` or `--frys`, with no default. `kart.py`
generates `modell/kart.md`, the map from S-number to function (`SAMMENSATT` lists the numbers that are put
together over the years or the draws).
- `data/trekninger.npy` and `data/trekninger.json`: the 10 000 draws of the 91 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.
- `tests/oppdiktet/`: `grunnlag.json` (a made-up basis, 200 draws, written by `lag_grunnlag.py`) and `fasit/`,
the six files the main run writes from it on the ladder 1, 2, 5. Committed; `kontroll` reproduces them.
- `tests/`: unit tests per equation, the loader, the draws, and `test_fasit.py` (known answers from Argonne,
NOU 2026: 4, Epoch and NVE with the sources' own assumptions). Build-out, power system and cash flow are tested
on the made-up set of values in `tests/conftest.py`, and so are the levelised cost, ownership, scale and
@ -134,6 +147,8 @@ carousel, Python code, and a Claude plugin (own repo, later).
search for the price threshold, the threshold in a quantity, the surfaces and the Sobol estimator, by hand.
`test_folsomheter.py` holds the rows of the sensitivity list through the run and the table on invented
outcomes; `test_folsomheter_modell.py` and `test_folsomheter_naaverdi.py` the switches of the model code.
`test_grunnlag.py`, `test_datafiler.py` and `test_verktoy.py` hold the tools on the first draw of the
made-up basis; `test_kart.py` holds the map against the specification and the code.
A condition can only count with enough draws to show an effect (none can with ten), so the tests of the
conditions use forty.
- `requirements.txt` (numpy, scipy) and `requirements-dev.txt` (pytest, ruff, mypy) pin exact versions;
@ -149,6 +164,12 @@ carousel, Python code, and a Claude plugin (own repo, later).
- **Pre-registration:** the criteria in `FORHANDSREGISTRERING.md` are approved by the operator and fixed before
anything is computed. Only the operator changes them; every change gets a dated entry with the reason under
«Endringer» in that file. Parameters are frozen in their own commit before the first result run.
- **The hypothesis was changed by the operator 2026-11-13**, before any result (pre-registration, «Endringer»):
it is that AI data centres owned in principle by the state can become a source of income for Norway as oil
has been. A dedicated nuclear plant per data centre is one of the power solutions, compared on equal terms:
the report says how often each of the five comes out best, with no verdict of its own on A. M1 to M6 and the
thresholds are unchanged. Part II and M7 in the pre-registration, the specification, the code and the data
files still give A its old special status until part 5H rewrites them; nothing is computed before that.
- **Frozen parameters:** `modell/parametere.json` is not edited after the freeze. A change is a deviation: new
commit, new checksum, and a dated entry with the reason under «Endringer» in the pre-registration.
- **Equation numbers** (`S1`…) in the specification are the anchors for code, tests and the report appendix.
@ -162,7 +183,7 @@ carousel, Python code, and a Claude plugin (own repo, later).
the measured deviation and the cause if known, and is reported in the review log.
- **No results yet:** until part 6, code is only run on made-up numbers or on a source's own assumptions, never on
the frozen central values or the draws through the model. `regn_program` and `kjoring.kjor` are only called
with made-up sets.
with made-up sets, and the tools only with `--grunnlag` and a made-up basis file, never `--frys`.
- **Neutrality:** vendors and companies are data sources, cited neutrally, never recommended. Nothing here
advertises a business. "Business case" means profitability for Norway, not something for sale.
- **Sadhguru** is mentioned in exactly one sentence, as inspiration, in the report's foreword and in README; never
@ -175,6 +196,9 @@ carousel, Python code, and a Claude plugin (own repo, later).
- Set up: `uv venv --python 3.13 .venv && uv pip install --python .venv/bin/python -r requirements-dev.txt`
- Tests: `.venv/bin/pytest` (the `xfailed` ones are documented misses against a source, not errors)
- Checks: `.venv/bin/ruff check . && .venv/bin/ruff format --check . && .venv/bin/mypy`
- Reproduction (made-up, about six minutes): `PYTHONPATH=src .venv/bin/python -m tokenfabrikker.verktoy kontroll
--grunnlag tests/oppdiktet/grunnlag.json --fasit tests/oppdiktet/fasit --prosesser 8` must print `identisk`.
Map: `PYTHONPATH=src .venv/bin/python -m tokenfabrikker.kart kontroll` (`lag` rewrites `modell/kart.md`).
- Draws: `PYTHONPATH=src .venv/bin/python -m tokenfabrikker.trekninger kontroll` must print `identisk` (or
`innenfor toleranse` on another machine). `lag` rewrites the file and is only run after a deviation from the freeze.
The same two commands exist for the event stream: `-m tokenfabrikker.hendelser kontroll`.

View file

@ -39,7 +39,14 @@ skal si når satsingen lønner seg, og når den ikke gjør det.
de lagrede trekningene og terskelflater. En betingelse teller bare når størrelsen påviselig påvirker
utfallet. Følsomhetslista er kodet gjennom kjøringen (`folsomheter.py`): de 37 linjene gir 42 rader, hver
er hovedkjøringen med én endring, og de vises i én fast tabell ved siden av hovedkjøringens tall. Alt er
bare prøvd på oppdiktede trekninger. Verktøyene er ikke kodet, og ingen resultater er regnet.
bare prøvd på oppdiktede trekninger, og ingen resultater er regnet. Verktøyene er kodet (`verktoy.py`,
`datafiler.py`, `grunnlag.py`): hovedkjøringen skriver seks datafiler i et fast format uten avrunding,
`kontroll` lager dem på nytt og sier om de er like de lagrede byte for byte, og `scenario`, `folsomhet`,
`terskel` og `sammenlign` lar andre prøve egne forutsetninger fra en inngangsfil i JSON der ukjente felt er
feil. `arbeidskopi` gir en kopi brukeren eier. Verktøyene kan ennå ikke kjøres på de frosne tallene.
- `modell/kart.md`: kart fra hver ligning (S-nummer) til funksjonene i koden, laget av koden selv.
- `tests/oppdiktet/`: en grunnlagsfil med oppdiktede tall og datafilene hovedkjøringen skriver fra den. De
brukes til å prøve at kjøringen kan gjenskapes, og sier ingenting om hypotesen.
- `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.
@ -60,6 +67,17 @@ PYTHONPATH=src .venv/bin/python -m tokenfabrikker.hendelser kontroll
De to siste kommandoene lager trekningene og strømmen for eksportregelen på nytt og sier om de er like de lagrede.
## Prøve gjenskapingen
Kommandoen under regner den oppdiktede hovedkjøringen på nytt (200 oppdiktede trekninger, noen minutter) og
sammenligner de seks datafilene med dem som ligger i `tests/oppdiktet/fasit/`:
```bash
PYTHONPATH=src .venv/bin/python -m tokenfabrikker.verktoy kontroll --grunnlag tests/oppdiktet/grunnlag.json --fasit tests/oppdiktet/fasit --prosesser 8
```
Svaret er «identisk» (samme bytes), «innenfor toleranse» (samme dommer og antall, og hvert desimaltall likt
til ni sifre) eller «endret». Tallene er oppdiktede: prøven viser bare at regningen kan gjentas.
Ideen om et eget kjernekraftverk for hvert datasenter er inspirert av Sadhguru, som ikke er kilde for noe tall eller noen påstand her.
## Lisens

View file

@ -1478,6 +1478,75 @@ rettet. Seks punkter under «bør rettes»:
**Ikke gjort.** Verktøyene i kapittel 12 og gjenskaping på en annen maskin.
## Del 17. Verktøyene, datafilene og gjenskaping byte for byte (2026-11-13)
Alt i denne delen er gjort før noe er regnet. Koden har bare fått oppdiktede tall; ingen tall her sier noe om
hypotesen. Parameterfila er ikke rørt (sjekksummen er uendret).
**Rekkefølgen.** Avklaring 126 til 132 ble skrevet og lagt inn før noe av verktøyene var kodet: hva en kjøring
trenger (grunnlaget), de seks datafilene hovedkjøringen skriver, formatet uten avrunding, hva «byte for byte»
sammenlignes mot, de fem verktøyene, kartet og arbeidskopien. Koden ble skrevet av to hjelpere som fikk teksten
og ikke fikk avgjøre noe selv. Lesningene de måtte gjøre, er avklaring 133.
**Det som ble funnet underveis.**
- EØS-vurderingen per eierform står ikke skrevet noe sted. Regelen for eierformene trenger den (avklaring 51).
Grunnlaget fra de frosne tallene kan derfor ikke lages ennå, og verktøyene stanser med en melding om det.
Den må stå i teksten med kilde før del 6.
- Funksjonen for (S52) ble ikke kalt noe sted i koden. Kartet viste det. Den brukes nå i `terskler.json`.
- Flatene (b) og (c) har ikke tall for klassene langs aksene (avklaring 133 g). Må fastsettes før del 6.
- Kartet: alle 54 ligninger har minst én funksjon, og ingen funksjon bærer et nummer teksten ikke har. (S12)
er den eneste ligningen uten egen funksjon; den er skranker som brukes flere steder, og peker til dem.
**Gjenskapingen** (oppdiktet grunnlag med 200 trekninger, stige 1, 2 og 5; `tests/oppdiktet/`).
- Hovedkjøringen skrevet med 8 prosesser og med 1 prosess: de seks filene har samme SHA-256.
- `kontroll` i ny prosess, kjørt av hjelperen og på nytt av prosjektet: alle seks «identisk», største relative
avvik 0. 6 minutter og 29 sekunder med 8 prosesser (2 221 CPU-sekunder, mens testene gikk samtidig).
- Formatet er prøvd uten prosjektets kode: hver fil lest med et rent JSON-bibliotek og skrevet ut igjen gir
de samme bytene (35 485 desimaltall, 7 124 heltall og 1 815 plasser uten verdi); ingen CR, ett linjeskift
til slutt, ingen tegn skrevet som koder, og sjekksummene i innholdslista stemmer.
- Sperren er prøvd: `hovedkjoring --frys` stanser før noe leses.
**Uavhengig leser av formatet og sammenligningen.** En leser som bare fikk avklaring 126 til 133 og de seks
lagrede filene, og ikke koden, skrev sin egen prøve av formatreglene og sin egen sammenligning.
- Formatet: alle reglene i avklaring 128 holdt i alle seks filene. At hvert av de 35 485 desimaltallene er
skrevet med færrest mulig sifre, ble prøvd ved å se at ingen kortere avrunding leses inn til samme tall.
Leseren fant ingenting avklaring 128 (a) til (f) lover, som mangler i filene.
- Sammenligningen: 60 endringer, én om gangen, med forventet dom skrevet ned før noe ble kjørt. Forventning,
leserens kode og prosjektets kode var enige i 59. I det siste (en sjekksum i innholdslista byttet med en
plass uten verdi) var leserens egen kode strengere enn teksten; prosjektets kode fulgte teksten. Grensen ble
prøvd fra begge sider (0,9 og 1,1 ganger $10^{-9}$, tall nær null, fortegn, heltall mot desimaltall).
- Fem tilfeller avgjorde teksten ikke; alle tre var enige om lesningen, og den er ført inn som avklaring
133 (o).
- Den oppdiktede fasiten prøver ikke alt: ingen løsning mangler median i M1, alle fem har tabell for
eierformene, og ingen løsning har betingelser samlet. De feltene er bare prøvd i testene.
- Ikke prøvd av leseren: kommandolinja, feilkodene, at `kontroll` lager filene på nytt, og om noe tall er
riktig.
**Tiden for de 42 radene** (målt på oppdiktede trekninger; CPU-sekunder per trekning).
- På trinnene 1, 5, 10 og 20 kostet de 37 radene som er egne kjøringer, mellom 4,6 og 11 ganger så mye som
hovedkjøringen på samme trinn (3 trekninger, fem scenarioer). Eierformene med de fire radene kostet 1,3 til
5,5 ganger hovedkjøringen på trinnet. På trinnet med 40 lot ingen bane seg bygge, og tiden var nær null.
- På den oppdiktede fasiten (40 trekninger, stige 1, 2 og 5): kjøringen 1,8, radene 4,3, terskelfila 2,9 og
eierformene 0,2.
- Anslag for hovedkjøringen med alt: kjøringen over trekningene er fra før anslått til rundt 53 kjernetimer.
Radene kommer i tillegg med mellom en halv og to ganger det, terskelfila med om lag to tredeler av radene,
og eierformene med en tredel til to tredeler av kjøringen. Det gir i størrelsesorden 110 til 270
kjernetimer, altså fra et halvt til halvannet døgn på åtte kjerner. Anslaget
er grovt: tiden avhenger av hvilket trinn dommene leses av på, og av hvor mange baner som lar seg bygge, og
begge deler er resultater. Minnebruken med 10 000 trekninger er ikke målt.
**Svakheter i det som er gjort nå.**
- Gjenskapingen er bare prøvd på én maskin. En annen maskin er prosjekteiers å prøve (målstrek 1).
Toleransen på $10^{-9}$ er satt før noe er målt på en annen maskin.
- Grunnlaget fra de frosne tallene er kodet, men aldri kjørt: bare sperren er prøvd. Å kjøre det ville regnet
M5 fra de frosne tallene, som er et resultat.
- Tallene i filene kommer fra funksjonene som er avstemt i del 14 til 16; det nye her er hvordan de skrives.
Testene holder utvalgte tall i hver fil mot funksjonene, ikke hvert tall.
- Hjelperens tester er ikke lest linje for linje av prosjektet.
- Verktøyene er prøvd på den første trekningen i det oppdiktede grunnlaget og stigen 1 og 2, hele fasiten bare
gjennom `hovedkjoring` og `kontroll`.
- Avklaring 126 til 133 er ikke lest av noen leser ut over det som står under.
## Forbehold
Fagfellene er språkmodeller. De leste postene i kildebanken, ikke primærkildene. Prosjektet har kontrollert

View file

@ -2525,6 +2525,61 @@ presisering 17 i forhåndsregistreringen på ett punkt (M6) og er prosjekteiers
merket «endret» (avklaring 127), og trekningene må da lages på nytt i kopien. Ingenting i en
arbeidskopi er rapportens tall, og `kontroll` sier «endret» om det den lager, når det avviker fra de
lagrede filene. Pluginen (del 10) bygger på dette og fastsettes for seg.
133. *Det kodingen fant i avklaring 126 til 132, og hvordan det er lest (2026-11-13).* Ingen tall i
parameterfila endres, og ingenting er regnet. Verktøyene ble kodet av en hjelper som fikk avklaring 126
til 132 og ikke fikk avgjøre noe selv; lesningene den måtte gjøre, står her.
(a) *Hodet.* Avklaring 127 sier at merket står i alt et verktøy skriver, mens 128 (f) bare nevner det i
innholdslista. Hver av de fem filene med tall begynner med det samme hodet: merket med sjekksummene,
antall trekninger, stigen, scenarioene og løsningene. Innholdslista skrives bare når de fem filene har
samme hode.
(b) *Den frosne sjekksummen.* Grunnlaget er «frosset» bare når parameterfila har sjekksummen i
forhåndsregistreringen. Den står for seg i koden, slik at en arbeidskopi som endrer parameterfila og
lager nye trekninger, ikke kan bli merket «frosset». Et grunnlag merket «endret» bærer de samme tre
sjekksummene.
(c) *Enheter.* $y_{\text{obs}}^{\max}$ skrives i kroner per MW IT og år, ved siden av medianen av
$\mathit{LCOC}^{v}(2025)$. $\varepsilon_d$ er den faste størrelsens verdi; settes den i `verdier`, er
det den verdien $d^{*}$ regnes med.
(d) *`terskel` i et annet prisscenario enn «normalisering».* $d^{*}$ har da ingen verdi: avklaring 107
regner den fra terskelen i «normalisering».
(e) *`folsomhet` og stigen.* Verktøyet tar stigen som valg på kommandolinja (uten: den faste), slik at
det kan leses mot en hovedkjøring på en annen stige. Det trengs for den oppdiktede fasiten.
(f) *Hovedkjøringens rad* i `folsomheter.json` gis for hvert scenario en av de valgte radene leses av i;
med hele lista er det fem av de seks.
(g) *Flatene.* (a) gis med medianen av reaktorkostnaden og terskelen per klasse. (b) og (c) gis med
rutene slik avklaring 111 sier, uten verdier for klassene langs aksene. **Mangler før del 6:** en figur
kan da ikke sette tall på aksene fra fila alene. Hvilket tall som står for en klasse, fastsettes i
teksten før del 6.
(h) *Trinn og år* står som innslag i lister med tallet som felt, fordi feltnavn i JSON er tekst.
Løsninger, scenarioer, mål og størrelser er feltnavn i den faste rekkefølgen.
(i) *`sammenlign`.* Forskjellen er den andre mappa minus den første, og bare det begge har,
sammenlignes. Fila bærer navnene på de to mappene og avhenger derfor av hvor de ligger; det gjør ingen
av hovedkjøringens filer.
(j) *`kontroll`.* Navnene på filene i innholdslista må være like. Filer som bare skiller seg i
mellomrom og linjeskift, er «innenfor toleranse» med avvik null. En feil som stanser verktøyet, gir en
egen feilkode.
(k) *`scenario` uten endringer* gir hovedkjøringens to filer når inngangsfila oppgir samme stige som
hovedkjøringen. Lister i inngangsfila settes i den faste rekkefølgen; fila slik den ble lest, står i
det verktøyet legger til.
(l) *Grunnlagsfila* er streng også på innholdet: scenarioene må ha «normalisering» på hovedforløpet, M5
må dekke de sju løsningene, EØS-vurderingen må dekke nøyaktig eierformene i tabellen, bortfallet må ha
de tre merkede scenarioene, og er $\rho_N$ trukket, må $\rho_D$ være det (avklaring 115). Flatene krever
at størrelsene langs aksene er trukket.
(m) *(S52) i koden.* Funksjonen for $d^{*}$ ble ikke kalt noe sted før `terskler.json`; kartet
(avklaring 131) viste det. Den brukes nå der.
(n) *Arbeidskopien* tar også med den oppdiktede fasiten og kodesjekkenes oppsett. Forhåndsregistreringen
kopieres ikke: den gjelder rapportens kjøring, ikke kopien.
(o) *Det en uavhengig leser fant i avklaring 128 og 129.* Leseren kodet formatreglene og
sammenligningen fra teksten alene og prøvde 60 endringer, én om gangen, mot prosjektets kode. Teksten
avgjorde ikke fem tilfeller; de leses slik, og slik er de kodet: rekkefølgen på feltene er en del av
oppbygningen, så to felt som har byttet plass, er «endret»; en fil i mappa ut over de seks ses bort fra;
de samme filnavnene i en annen rekkefølge i innholdslista er «endret»; en fil som ikke kan leses som
JSON i UTF-8, er «endret»; og sjekksummene i innholdslista holdes helt utenfor den andre prøven, også
typen. Et oppdiktet grunnlag bærer én sjekksum, grunnlagsfilas.
(p) *Navn i filene.* Løsninger og scenarioer står med navnene koden har: `B'` for B′, «kildenes lave
forlop» og «80 % paa egne maskiner, lav» og «hoy». Tallet for 2050 ved siden av M6 har årstallet som
feltnavn; det er ett av fire tall og ikke en rekke av år. Utfallene Sobol-indeksene gis for, står i
rekkefølgen netto nåverdi, om banen lar seg bygge, vilkåret for «holder» i M1 til M6, vilkåret for
«holder ikke» i M3, M4 og M6, og M7.
## 17. Tillegget til retningen (2026-11-12)