tokenfabrikker/README.md
Kjell Tore Guttormsen cc0c306bac
docs(modell): write the addition to the direction into the specification and the pre-registration
Chapter 17 of the specification (S48-S54): solution T, "stepwise", in two
versions (T-F and T-K), the timeline, a threshold and two labelled scenarios
for compute on the users' own machines, emissions with a deduction, and
cooling water. The pre-registration gets T-F and T-K in the table of
alternatives, in M7 and in clarifications 1, 3, 10 and 11, new clarifications
13-16 and a dated entry. An independent reader coded the chapter from the text
alone in three rounds; the findings and what was done are in part 8 of the
review log.

Nothing is computed. The parameter file is unchanged (checksum 4582835...f6cc);
the new quantities are candidates until the deviation from the freeze. The
eight choices in 17.7 are put to the project owner and not yet approved.

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
2026-11-12 22:39:36 +01:00

54 lines
3.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 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. Det er
ikke kodet ennå.
- `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: 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.
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).