docs: the conditions that count and the sensitivity list in README, CHANGELOG and CLAUDE.md

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
This commit is contained in:
Kjell Tore Guttormsen 2026-11-13 20:31:13 +01:00
commit e926ed91e1
Signed by: ktg
SSH key fingerprint: SHA256:JakMjO6FTBBzN0Bhfj9saOoEjaFxlSdYuZQQpM/lF9Q
3 changed files with 51 additions and 7 deletions

View file

@ -164,3 +164,26 @@ All notable changes to this project will be documented in this file.
stricter rule is proposed to the project owner and is not coded; neither is the reading that M6 needs no
threshold approved yet (`modell/fagfellevurdering-utkast-2-og-3.md`, part 15). The sensitivity list is not
coded through the run. No result has been computed.
- Clarifications 21 to 23 of the pre-registration, approved by the project owner 2026-11-13 before anything is
computed: M6 is exempt from the requirement of a named condition (this makes part I easier to meet in one
case, and is said so); a threshold counts as a condition only when the quantity demonstrably affects the
outcome (a chi-square test at the 0.1 % level on the stored draws); and a threshold in the required return
for power must hold in both halves of the draws by the required return for compute, an assumption without
a source it is correlated with. The last two make the test stricter. Coded in `terskler.py` and
`kjoring.py`, with the conditions of a solution taken together shown next to them (clarification 115 of
the specification).
- The sensitivity list is settled line by line in the specification before it was coded (clarifications
116–124) and coded through the run (`folsomheter.py`): the 37 lines of the frozen list give 42 rows, each
the main run with one change over the same draws, read on the main run's step and shown in one fixed table
next to the main run. Eleven rows needed new switches in the model code (the markup for nuclear power, the
unit size in the dedicated plant, the income factor by standard terms, lasting and fading scarcity, the
stepped discount rate, the tax cost, the reserve above the dimensioning fault, efficiency by ownership
form); with the switches off every figure is unchanged to the last digit. The state's cash flow next to M6
is coded. A new independent reader coded the same from the specification alone: 474 000 comparisons of the
rules and the table on invented outcomes and 4 300 outcomes of the 37 run rows through both model codes on
made-up draws without a difference. The reader found one place where the text gave two different numbers
(which outage rates size the reserve units when the unit size is chosen freely), now settled, and that the
row with standard contract terms can favour the dedicated plant, which is put to the project owner. One
figure differs between the two codes, by at most 6e-5: the reader does not scale decommissioning after the
final year in the efficiency row, and the specification says it is scaled
(`modell/fagfellevurdering-utkast-2-og-3.md`, part 16). No result has been computed.

View file

@ -58,7 +58,11 @@ carousel, Python code, and a Claude plugin (own repo, later).
pre-registration. Clarifications 105 to 113 settle the rest of clarification 60: the price threshold, the
thresholds behind «holder under betingelser», the conditions of part I, the Sobol indices, the threshold
surfaces, and how the sensitivities are read (on the main run's step, in «normalisering»). 109 (M6 needs
no threshold) fills in clarification 17 of the pre-registration and is the operator's to approve.
no threshold) and 115 (a threshold counts only when the quantity demonstrably affects the outcome, and a
threshold in rho_N must hold in both halves of rho_D) were approved by the operator 2026-11-13 and are
clarifications 21 to 23 of the pre-registration. Clarifications 116 to 123 settle the sensitivity list
line by line (42 rows from 37 lines), and 124 what the independent reader found in them; 124 (b), that
line 10 can favour A, is put to the operator.
Solution T (`Losning.T_F`, `Losning.T_K`) goes through `lag_plan` (a `Trinnvisplan`) and `regn_program`
with a module in the place of a facility (`Programresultat.P_enhet`): renewable modules have their own
portfolio as in C, the nuclear modules of T-K share the programme's units as in B
@ -95,10 +99,21 @@ carousel, Python code, and a Claude plugin (own repo, later).
and decides part I (`dommer.kan_navngis`, `Scenariodommer.betingelser`); without them part I is given as
far as it follows from the targets. `kjoring.py` also has `ved_siden_av_m6`, `sobol_indekser`,
`pristerskel_for_losning` and `prisflate` (they run the model with `regn_program(..., prisfaktor=k)`),
`flate_over_trekningene` and `kraftprisflate`. The sensitivity list of the parameter file is not coded
through the run yet (clarification 112 says how it is read; the survey of the 37 lines against the code
is `private/del5-rapporter/5e/kartlegging-folsomheter-2026-11-13.md`), and neither are the tools of
chapter 12.
`flate_over_trekningene` and `kraftprisflate`. A threshold carries `kilde`, `indeks`, `paavist` and
`begge_halvdeler`, and `teller` only when all hold (`terskler.virkning`, `holder_i_begge_halvdeler`);
`Betingelser.samtidig` gives the conditions of a solution taken together (clarification 115).
`folsomheter.py` is the sensitivity list through the run: `RADER` holds the 42 rows (which solutions a
row applies to, where it is read, and what it changes: fixed values, the switches of the model code as
`kjoring.Brytere`, or a change that depends on the draw), `kjor_rad` runs one row over the draws on the
main run's step for the solutions it applies to, and `tabell` and `hovedtabell` give the fixed table per
scenario (verdicts per target, M7, part I and II as far as they follow from the targets). The switches
of the model code are keywords of `kontantstrom.dimensjoner` (`minstelast`, `fritt_enhetsvalg`,
`gamma_trinn`, `paaslag_kjernekraft`, `skaler_K_U`, `bare_over_dimensjonerende_feil`, stored on
`Dimensjonering`) and of `regn_program` (`paaslag`, `diskontering`, `skattekostnad`); with them off every
figure is unchanged to the last digit. The four rows of the ownership forms go through
`kjoring.eierformer_paa_trinnet(..., rad=Eierrad...)`, which also gives the state's cash flow next to M6
(clarification 123). The low and the high path of the carbon price are passed in by the caller. The tools
of chapter 12 are not coded.
- `data/trekninger.npy` and `data/trekninger.json`: the 10 000 draws of the 91 drawn quantities, in the parameter
file's units. `data/aarshendelser.npy` and `.json`: one uniform number per draw and year 2028–2100 for the
export rule (own seed). Committed; every later computation reads them.
@ -116,6 +131,10 @@ carousel, Python code, and a Claude plugin (own repo, later).
draws by hand, the same figures on several processes and in another order, and the thresholds, the
conditions of part I, the indices and the price threshold through the run. `test_terskler.py` holds the
search for the price threshold, the threshold in a quantity, the surfaces and the Sobol estimator, by hand.
`test_folsomheter.py` holds the rows of the sensitivity list through the run and the table on invented
outcomes; `test_folsomheter_modell.py` and `test_folsomheter_naaverdi.py` the switches of the model code.
A condition can only count with enough draws to show an effect (none can with ten), so the tests of the
conditions use forty.
- `requirements.txt` (numpy, scipy) and `requirements-dev.txt` (pytest, ruff, mypy) pin exact versions;
`pyproject.toml` only configures the tools (ruff `ALL`, mypy strict).

View file

@ -36,8 +36,10 @@ skal si når satsingen lønner seg, og når den ikke gjør det.
på trinnet forhåndsregistreringen peker på, tidslinjen oppsummeres over trekningene, og eierformene
sammenlignes på det samme trinnet. Tersklene er kodet (`terskler.py`, `sobol.py`): hvilken pris på regnekraft
satsingen tåler, hvilke betingelser som kan navngis når et mål holder under betingelser, Sobol-indekser fra
de lagrede trekningene og terskelflater. Alt er bare prøvd på oppdiktede trekninger. Resten av følsomhetene
og verktøyene er ikke kodet, og ingen resultater er regnet.
de lagrede trekningene og terskelflater. En betingelse teller bare når størrelsen påviselig påvirker
utfallet. Følsomhetslista er kodet gjennom kjøringen (`folsomheter.py`): de 37 linjene gir 42 rader, hver
er hovedkjøringen med én endring, og de vises i én fast tabell ved siden av hovedkjøringens tall. Alt er
bare prøvd på oppdiktede trekninger. Verktøyene er ikke kodet, 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.