docs: describe the build-out, the cash flow and the event stream

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
This commit is contained in:
Kjell Tore Guttormsen 2026-11-12 11:58:25 +01:00
commit 326b80d8d1
Signed by: ktg
SSH key fingerprint: SHA256:JakMjO6FTBBzN0Bhfj9saOoEjaFxlSdYuZQQpM/lF9Q
3 changed files with 30 additions and 9 deletions

View file

@ -24,3 +24,14 @@ All notable changes to this project will be documented in this file.
- Known-answer tests against Argonne, NOU 2026: 4, Epoch and NVE with the sources' own assumptions
(`tests/test_fasit.py`). The misses are kept as documented expected failures: wind on land and offshore wind
come out 5–6 % below NVE, and three rows of Argonne's table depend on a reading the source does not settle.
- Build-out, power system and cash flow in code (`src/tokenfabrikker/`): when each facility starts and which
vintages of IT hardware it gets (S22, S33), the export rule with its own stored stream of random numbers
(`data/aarshendelser.npy`), the fitted price lines and the power and capacity balances (S23–S25, S38), and the
yearly cash flows with residual value, the additionality rule and net present value for Norway (S26, S34, S35,
S40, S45). Tested on made-up numbers only; no result for the hypothesis has been computed.
- A second independent reader coded these equations from the specification alone and found 28 ambiguities. They
are settled in clarifications 21–40 in chapter 16 of the specification. With the readings aligned, the two
implementations agree on 10 000 made-up build-out paths. The clarifications that are choices are marked and put
to the project owner (`modell/fagfellevurdering-utkast-2-og-3.md`, part 5).
- The price lines of S38 are held against NVE's twelve scenarios: within 5 % for Norway and three price areas,
6.0 % and 7.7 % off in one scenario for NO3 and NO4, kept as documented expected failures.