docs: describe the code, the commands and the new conventions

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

View file

@ -11,11 +11,31 @@ skal si når satsingen lønner seg, og når den ikke gjør det.
## Innhold
- `FORHANDSREGISTRERING.md`: hva som testes, og hva som skal til for at hypotesen holder.
- `kilder/`: kildebanken. Én fil per område, med påstand, tall, kilde, ordrett sitat og kontroll mot primærkilden.
- `modell/spesifikasjon.md`: modellen: ligninger, størrelser og parametere med kilde. Ingen kode ennå.
- `modell/spesifikasjon.md`: modellen: ligninger, størrelser og parametere med kilde. Kapittel 16 har
avklaringene som ble gjort etter at en uavhengig leser kodet ligningene.
- `modell/parametere.json`: parameterne, frosset før noe er regnet: verdi, spenn, fordeling og poster i
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), innlesing av parameterne og trekningene. Kontantstrømmen,
utbyggingen, kraftsystemet og eierformene er ikke kodet ennå.
- `data/trekninger.npy`: de 10 000 trekningene av parameterne, laget med fast frø. `data/trekninger.json` sier hva
kolonnene er.
- `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.
## Kjøre testene
Krever Python 3.11 eller nyere.
```bash
python3 -m venv .venv
.venv/bin/pip install -r requirements-dev.txt
.venv/bin/pytest
PYTHONPATH=src .venv/bin/python -m tokenfabrikker.trekninger kontroll
```
Den siste kommandoen lager trekningene på nytt og sier om de er like de lagrede.
Ideen om et eget kjernekraftverk for hvert datasenter er inspirert av Sadhguru, som ikke er kilde for noe tall eller noen påstand her.