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:
parent
5f139a0698
commit
bce42b91ff
1 changed files with 114 additions and 1 deletions
|
|
@ -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)
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue