tokenfabrikker/README.md
2026-11-12 11:58:25 +01:00

50 lines
3 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 fire måter å skaffe kraft på (ett dedikert kjernekraftverk per datasenter, kjernekraft koblet
til nettet, ny fornybar kraft med lagring og fleksibilitet, 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.
- `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), 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å.
- `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.
## 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).