docs(modell): the tools of chapter 12, the data files and what byte for byte is compared against (clarifications 126 to 132)

Written before the tools are coded. Nothing is computed and no value in the
parameter file changes.

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
This commit is contained in:
Kjell Tore Guttormsen 2026-11-13 20:45:06 +01:00
commit bce42b91ff
Signed by: ktg
SSH key fingerprint: SHA256:JakMjO6FTBBzN0Bhfj9saOoEjaFxlSdYuZQQpM/lF9Q

View file

@ -708,7 +708,8 @@ $$\text{andel}_M^{\,x} = \frac{1}{N_\omega} \sum_\omega \mathbb{1}\big[\text{vil
Samme kode som rapporten bruker, med inngang i JSON der ukjente felt er feil: `scenario`, `sammenlign`,
`folsomhet`, `terskel`, `kontroll` (gjenskaper rapportens datafiler byte for byte), og en arbeidskopi brukeren
eier, med et kart fra ligning (S-nummer) til funksjon.
eier, med et kart fra ligning (S-nummer) til funksjon. Hva hvert verktøy tar inn og gir, hvilke datafiler
hovedkjøringen skriver, og hva «byte for byte» sammenlignes mot, er fastsatt i kapittel 16, avklaring 126 til 132.
## 13. Det modellen ikke gjør
@ -2412,6 +2413,118 @@ presisering 17 i forhåndsregistreringen på ett punkt (M6) og er prosjekteiers
trinnet alene (avklaring 119 c og 124 b). Ved raden skal det stå at vilkårene erstatter regelen i
hovedkjøringen, slik at anlegget får full inntekt når tilgjengeligheten når kravet, og at raden derfor
kan trekke i favør av A. Ingen dom i en rad teller.
126. *Verktøyene i kapittel 12: hva som fastsettes (2026-11-13).* Kapittel 12 nevner fem verktøy, en
arbeidskopi og et kart, og sier ikke mer. Avklaring 127 til 132 fastsetter hva en kjøring trenger, hvilke
datafiler hovedkjøringen skriver, hva «byte for byte» sammenlignes mot, hva hvert verktøy tar inn og gir,
kartet og arbeidskopien. De er skrevet før verktøyene er kodet. Ingen tall i parameterfila endres, ingen
dom endres, og ingenting regnes: verktøyene prøves bare på oppdiktede tall før del 6.
127. *Grunnlaget for en kjøring.* Alt en kjøring trenger utenom modellkoden, samles i ett grunnlag:
(a) ett tallsett per trekning, i trekningenes rekkefølge, med trekningens rad i strømmen for årlige
hendelser (avklaring 95); (b) de trukne verdiene av hver trukket størrelse, i den rekkefølgen størrelsene
står i parameterfila, og status for hver (til tersklene, indeksene og flatene, avklaring 108 til 111);
(c) dommen i M5 per løsning (avklaring 68 og 88); (d) EØS-vurderingen per eierform (avklaring 51);
(e) karbonprisens lave og høye bane (linje 19 i følsomhetslista); (f) $y_{\text{obs}}^{\max}$ og den faste
$\varepsilon_d$ (avklaring 106 og 107); (g) for hver størrelse faktoren fra parameterfilas enhet til
ligningenes. Grunnlaget kommer fra ett av to steder. *Frysen:* parameterfila og de lagrede trekningene og
strømmen; grunnlaget er da merket «frosset» og bærer de tre sjekksummene. Er parameterfila en annen enn
den frosne (en arbeidskopi, avklaring 132), er merket «endret». *En grunnlagsfil* i JSON med de samme
delene skrevet ut, merket «oppdiktet»; den brukes til å prøve verktøyene og gjenskapingen før noe er
regnet, og ingenting som kommer fra den, sier noe om hypotesen. Merket står i alt et verktøy skriver.
Trukne verdier og terskler i en størrelse står i enheten grunnlaget har dem i: parameterfilas for frysen.
**Mangler før del 6:** EØS-vurderingen er kvalitativ (kapittel 8) og er ikke skrevet ned for de fire
eierformene noe sted. Den skal stå i teksten med kilde før del 6. Til da kan grunnlaget fra frysen ikke
lages, og verktøyene går bare på en grunnlagsfil.
128. *Datafilene hovedkjøringen skriver.* Hovedkjøringen er kjøringen i avklaring 95 med dommene, tersklene
og følsomhetslista (avklaring 97 til 125). Den skriver seks filer i én mappe. Fem av dem holder
tallene, den sjette er innholdslista.
(a) `dommer.json`: trinnet dommene leses av på og grunnlaget for det, og scenarioet som teller. For hvert
scenario: for hvert trinn og hver løsning dommen i M1, M2, M3, M4 og M6 med andelene den er satt fra og
de to tallene ved siden av (avklaring 69 og 100), dommen i M5, medianen i M1 og de fire tallene ved
siden av M6 (avklaring 103 c); M7 per trinn; del I og del II; og på trinnet betingelsene per løsning
(om den er felt, målene som holder under betingelser, om betingelsene kan navngis, hver terskel med
alt som står ved siden av den, og betingelsene samlet, avklaring 108, 109 og 115) og tersklene for M7.
(b) `tidslinje.json`: for hver løsning og hvert trinn, for hver type kraft og for summen: år, median,
10- og 90-persentil og de to andelene (avklaring 99).
(c) `eierformer.json`: for hver av de fem løsningene tabellen i avklaring 98 med antallet trekninger,
kriteriene per eierform, rangeringen og statens kontantstrøm ved siden av M6 (avklaring 123), eller
ingen verdi der løsningen ikke har noen tabell.
(d) `terskler.json`: pristerskelen for hver av de sju løsningene i hvert av de tre prisscenarioene
(avklaring 105) med kontrollen mot kontraktsprisene (avklaring 106) og $d^{*}$ med den faste
$\varepsilon_d$ og med 0,5 og 2 (avklaring 107); Sobol-indeksene med antall trekninger, antall klasser
og forventningen uten virkning (avklaring 110); og de tre flatene (avklaring 111).
(e) `folsomheter.json`: hovedkjøringens rad og de 42 radene i den faste tabellen, for hvert scenario
raden leses av i (avklaring 112 og 116), med merknaden der raden har en; og for de fire radene som
gjelder eierformene, tabellene per løsning (avklaring 122).
(f) `innhold.json`: merket for grunnlaget med sjekksummene, antall trekninger, stigen, scenarioene,
løsningene, og SHA-256 for hver av de fem andre filene. Den skrives sist. Den inneholder ingenting som
avhenger av maskinen, tidspunktet eller antall prosesser.
*Formatet.* JSON i UTF-8, linjeskift LF, ett linjeskift til slutt, innrykk på ett mellomrom, ingen
tegn skrevet som koder. Feltene står i fast rekkefølge, aldri sortert etter navn og aldri i rekkefølgen
til en mengde: løsningene i rekkefølgen A, B, B′, C, R, T-F, T-K, trinnene stigende, scenarioene som i
avklaring 95, målene M1 til M7, størrelsene som i parameterfila, radene som i lista, årene stigende.
*Ingen avrunding.* Et desimaltall skrives med de færreste sifrene som gir det samme 64-bits flyttallet
når det leses inn igjen; ingenting rundes av til visning. Antall, år og trinn er heltall. Et tall uten
verdi er `null`; det gjelder også medianen i M1 når banen ikke lar seg bygge i minst halvparten av
trekningene (avklaring 103 a). Dommer står med ordlyden «holder», «holder under betingelser» og
«holder ikke». Trekningenes utfall hver for seg lagres ikke: filene holder det dommene, tabellene og
figurene leses fra. Trengs fordelingen over trekningene til en figur, fastsettes en fil for det før
del 6.
*Kostnaden.* (d) kjører modellen mange ganger per løsning (avklaring 105 og 111 a). Hovedkjøringen kan
derfor skrives i to omganger, først (a) til (c) og (e), så (d); filene er de samme.
129. *Hva «byte for byte» sammenlignes mot (`kontroll`).* `kontroll` lager de seks filene på nytt fra
grunnlaget, i en ny mappe, og sammenligner dem med de lagrede. For hovedkjøringen ligger de lagrede i
`data/resultater/` fra del 6; før det finnes bare en oppdiktet fasit, laget fra en grunnlagsfil, som
ligger sammen med testene. Dommen settes per fil og samlet, med tre utfall, de samme som for trekningene:
«identisk» når hver fil har de samme bytene; «innenfor toleranse» når filene har samme oppbygning og
hver tekst, hvert heltall, hver sannhetsverdi og hver plass uten verdi er lik (dermed også hver dom,
hvert trinn, hvert antall og hvert navn), og hvert desimaltall avviker relativt med høyst $10^{-9}$,
$|a - b| \le 10^{-9} \max(|a|, |b|)$; ellers «endret». I `innhold.json` holdes sjekksummene for de
andre filene utenfor den andre prøven. Det største relative avviket og hvor det står, skrives ut.
«Endret» gir feilkode. Grunn til at det finnes en toleranse: potenser, eksponential- og
logaritmefunksjoner kommer fra maskinens matematikkbibliotek, og en annen prosessor eller et annet
operativsystem kan gi et annet siste siffer. Målstrek 1 krever byte for byte; gir en annen maskin
«innenfor toleranse», rapporteres det slik og kalles ikke identisk. Toleransen er satt før noe er målt
på en annen maskin. Gjentakbarheten i avklaring 101 gjelder filene: de har de samme bytene uansett
hvor mange prosesser kjøringen deles på, og i en ny prosess.
130. *De fire andre verktøyene.* Hvert verktøy er én kommando som tar grunnlaget og én inngangsfil i JSON
(`sammenlign` tar to mapper). I inngangsfila er et ukjent felt en feil, og likeså et felt som mangler,
en verdi av feil type, og et ukjent navn på en løsning, et scenario, en størrelse eller en rad. Feilen
stanser verktøyet før noe regnes. Det som skrives, følger formatet i avklaring 128, bærer inngangsfila
slik den ble lest, merket for grunnlaget og setningen «Egen kjøring: ingen dom her er rapportens dom».
Antall prosesser er et valg på kommandolinja og endrer ingen tall.
`scenario`: en egen kjøring med brukerens forutsetninger. Felt: `navn` (må stå); `verdier`, størrelser
som får én fast verdi i alle trekningene, i parameterfilas enhet, satt etter trekningen slik
følsomhetslista gjør (avklaring 116), bare størrelser som er ett tall; `losninger`, `stige` og
`scenarioer` (uten dem: de sju, den faste stigen og de seks); `trekninger`, de $N$ første (uten: alle).
Verktøyet skriver `dommer.json` og `tidslinje.json` som i avklaring 128. Trinnet velges fra
kjøringens egen M6, slik hovedkjøringen gjør det. Et scenario uten endringer gir hovedkjøringens to
filer byte for byte, bortsett fra det verktøyet legger til.
`folsomhet`: rader fra følsomhetslista. Felt: `rader` (uten: alle 42) og `trekninger`. Verktøyet finner
trinnet slik hovedkjøringen gjør (M6 i «normalisering» på hovedforløpet for de fem løsningene på
stigen), regner hovedkjøringen på det trinnet i scenarioene radene leses av i, og skriver
`folsomheter.json` som i avklaring 128 med de radene som er valgt.
`terskel`: pristerskelen for én løsning. Felt: `losning` og `trinn` (må stå), `scenario` (ett av de
tre prisscenarioene; uten: «normalisering»), `verdier` og `trekninger`. Verktøyet skriver
`terskel.json` med terskelen, kontrollen og $d^{*}$ (avklaring 105 til 107). Tersklene i en størrelse
står i `dommer.json` fra `scenario`.
`sammenlign`: to mapper som hver har en `dommer.json`, fra hovedkjøringen eller fra `scenario`.
Verktøyet regner ingenting med modellen. Det skriver `sammenligning.json`: for hvert scenario, trinn og
hver løsning som finnes i begge, dommen per mål i begge, forskjellen i andelen som oppfyller vilkåret
for «holder», og medianen i M1 i begge med forskjellen; M7, del I, del II og trinnet i begge. Er de to
laget fra ulikt grunnlag eller ulikt antall trekninger, står det først.
131. *Kartet fra ligning til funksjon.* Kartet lages fra koden og lagres som `modell/kart.md`. For hvert
S-nummer i spesifikasjonen står funksjonene som har nummeret i navnet (`s9_…`), med modul og første
linje av beskrivelsen. Et nummer som ikke er én funksjon, men settes sammen over årene eller over
trekningene (for eksempel (S22), (S26), (S37) og (S50)), peker til funksjonene som setter det sammen,
etter en liste som står i koden. En test krever at hvert S-nummer i spesifikasjonen har minst én
funksjon, at ingen funksjon bærer et nummer spesifikasjonen ikke har, og at den lagrede fila er lik
den som lages.
132. *Arbeidskopien.* `arbeidskopi` kopierer koden, testene, parameterfila, trekningene, strømmen,
spesifikasjonen og kartet til en mappe brukeren velger og eier, med en fil som sier hva den er kopiert
fra. I kopien kan alt endres. En parameterfil som ikke har den frosne sjekksummen, gir grunnlaget
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.
## 17. Tillegget til retningen (2026-11-12)