tokenfabrikker/CHANGELOG.md
Kjell Tore Guttormsen aee22b9101
docs: describe the code, the commands and the new conventions
Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
2026-11-12 10:08:48 +01:00

26 lines
2 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.

# Changelog
All notable changes to this project will be documented in this file.
## Unreleased
- Pre-registration of what is tested and what it takes for the hypothesis to hold (`FORHANDSREGISTRERING.md`).
- Source bank: 948 entries in 21 areas, each checked against its primary source (`kilder/`). The second round
(areas 13–21) covers the parameters that lacked a source when the model was specified.
- Model specification, draft 3 (47 equations), after a pre-read of draft 2, two independent reviews of draft 3
and a control of the corrections (`modell/`).
- Parameters frozen before anything is computed: 124 parameters in 2025 kroner, one distribution each, with the
source entries they rest on (`modell/parametere.json`). The checksum is recorded in the pre-registration.
No code and no results yet.
- Eight clarifications of the pre-registered criteria, approved by the project owner after the parameter freeze
and before anything is computed (`FORHANDSREGISTRERING.md`, «Presiseringer»). The parameter file is unchanged.
- First code (`src/tokenfabrikker/`): one function per equation for the power plant, the data centre and the
revenue (S1–S21, S36, S43–S47), a strict reader for the frozen parameter file with unit conversion, and the
10 000 Monte Carlo draws stored in `data/`. Python with pinned numpy and scipy, pytest, ruff `ALL` and mypy strict.
No result for the hypothesis has been computed.
- An independent reader coded the key equations from the specification alone. The two implementations agree on
all 23 functions. The 19 ambiguities the reader found are settled in a new, dated chapter 16 of the
specification (`modell/`); the parameter file and the pre-registration are unchanged.
- 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.