tokenfabrikker/README.md
Kjell Tore Guttormsen 4c9539d68a
docs: describe the code for the build-out of solution T
Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
2026-11-12 23:55:57 +01:00

56 lines
3.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# tokenfabrikker
En åpen matematisk modell som tester om, og under hvilke betingelser, statlig eide AI-datasentre med egen kraftforsyning kan lønne seg for Norge.
**Status: under arbeid. Ingen resultater ennå.** Kriteriene for hva som skal til for at hypotesen holder, er
skrevet ned før noe er regnet: se [FORHANDSREGISTRERING.md](FORHANDSREGISTRERING.md).
Modellen sammenligner flere måter å skaffe kraft på (ett dedikert kjernekraftverk per datasenter, kjernekraft koblet
til nettet, ny fornybar kraft med lagring og fleksibilitet, en trinnvis oppbygging i moduler med og uten
kjernekraft, og ingen satsing) og flere statlige eierformer. Den
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. Kapittel 16 har
avklaringene som ble gjort etter at en uavhengig leser kodet ligningene. Kapittel 17 har tillegget til
retningen: trinnvis oppbygging, AI-bruk på brukernes egne maskiner, utslipp «med fradrag» og kjølevann. Av
det er utbyggingen i moduler og ligningene S48–S54 kodet; resten er ikke kodet ennå.
- `modell/parametere.json`: parameterne, frosset før noe er regnet: verdi, spenn, fordeling og poster i
kildebanken. Fila er endret én gang etter frysen, 12. november 2026, da størrelsene for tillegget til retningen
kom inn, også det før noe er regnet. Sjekksummen og hva som ble endret, 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: 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. For den trinnvise løsningen er bare utbyggingen kodet
(kapittel 17.1): når hver modul starter, og hvilken kraft den går på. 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.
Alt fra utbyggingen og utover er testet på oppdiktede tall, ikke på de frosne parameterne.
## 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
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.
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
Tekst: CC BY 4.0 (`LICENSE-CC-BY-4.0.txt`). Kode og data: MIT (`LICENSE`).
## Endringslogg
Se [CHANGELOG.md](CHANGELOG.md).