feat(kode): first coding of business economics, ownership, scale, environment and verdicts

Chapters 7 to 11 of the specification, on the made-up set only:

- nivaaisert: the power cost per facility, year and vintage on levelised
  form (S9, S11 with clarifications 2, 11, 13 and 15), S15, S19, S27, S42
- eierskap: the business cash flow with every asset booked, tax, S28, S29
  and S30 for the four ownership forms, the criteria over the draws
- skala: S31 year by year, the first year with stable operation, M6
- miljo: S32 year by year, the rules of M5 (i) and (ii)
- dommer: S37, the verdict per target, the step of the ladder, the overall
  verdicts; tested on invented outcomes
- kontantstrom: each asset is recorded as it is paid, and the price of
  compute exposes the competitor's cost and the markup

This is an intermediate step. The readings are not settled: an independent
reader is coding the same from the specification alone, a first comparison
agrees on the levelised cost, S19, S42, the cash flows, M3 and M4 and
differs on depreciation at the final year, tax, debt and two definitions.
Chapter 16 gets the clarifications before any result is computed.
Nothing is computed for the hypothesis; the parameter file is unchanged.

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
This commit is contained in:
Kjell Tore Guttormsen 2026-11-12 12:45:54 +01:00
commit e216702d69
Signed by: ktg
SSH key fingerprint: SHA256:JakMjO6FTBBzN0Bhfj9saOoEjaFxlSdYuZQQpM/lF9Q
15 changed files with 3697 additions and 45 deletions

455
tests/test_eierskap.py Normal file
View file

@ -0,0 +1,455 @@
"""Business cash flow, tax and ownership (chapters 7 and 8): S28, S29 and S30.
Made-up round numbers only; the ownership forms are those of ``conftest.py``, not the
parameter file's. Nothing here says anything about the hypothesis.
"""
from __future__ import annotations
import math
from typing import TYPE_CHECKING
import numpy as np
import pytest
from tokenfabrikker import eierskap as ei
from tokenfabrikker import kontantstrom as ks
from tokenfabrikker import ligninger as lg
from tokenfabrikker.kontantstrom import Knapphet
from tokenfabrikker.utbygging import Losning
if TYPE_CHECKING:
from conftest import LagInndata
from tokenfabrikker.inndata import Inndata
E_D = 8760.0 * 0.75 * 1.2 * 1000.0
"""Yearly energy to one made-up data centre: 7 884 000 MWh."""
def _crf(rho: float, levetid: float) -> float:
return float(rho / (1.0 - (1.0 + rho) ** -levetid))
def _lcoc_v() -> float:
"""S15 for the made-up competitor, per MW IT and year."""
return 100e6 * _crf(0.08, 15) + 200e6 * _crf(0.08, 5) + 3e6 + 8760.0 * 0.75 * 1.2 * 800.0
def _regn(
inn: Inndata,
losning: Losning,
*,
N_anlegg: int = 1,
knapphet: Knapphet = Knapphet.NORMALISERING,
) -> ks.Programresultat:
dim = ks.dimensjoner(inn, losning)
plan = ks.lag_plan(inn, losning, dim, N_anlegg=N_anlegg)
return ks.regn_program(inn, losning, plan, knapphet, dim=dim)
def _lonnsom(inn: Inndata) -> ei.Bedriftsstrom:
"""One facility in R with the scarcity markup: the made-up price is about twice the cost."""
return ei.bedriftsstrom(inn, _regn(inn, Losning.R, knapphet=Knapphet.VARER))
# ------------------------------------------------------- the equations one at a time
def test_avskrivning_er_lineaer_over_levetiden() -> None:
aar = [
lg.s28_avskrivning(kostnad=100.0, levetid=4, start=2030, slutt=2033, t=t)
for t in range(2029, 2035)
]
assert aar == pytest.approx([0.0, 25.0, 25.0, 25.0, 25.0, 0.0])
def test_resten_skrives_av_naar_eiendelen_gaar_ut_for_tiden() -> None:
"""A lifetime of ten years, but the facility goes out after three: 10, 10 and the last 80."""
aar = [
lg.s28_avskrivning(kostnad=100.0, levetid=10, start=2030, slutt=2032, t=t)
for t in range(2030, 2034)
]
assert aar == pytest.approx([10.0, 10.0, 80.0, 0.0])
assert math.fsum(aar) == pytest.approx(100.0)
def test_underskudd_fores_fram_uten_rente() -> None:
"""A loss of 100 is used against 60 and then against 40 of the next 80."""
assert lg.s28_etter_framforing([-100.0, 60.0, 80.0, 50.0]) == (0.0, 0.0, 40.0, 50.0)
assert lg.s28_etter_framforing([10.0, -5.0, -5.0, 30.0]) == (10.0, 0.0, 0.0, 20.0)
def test_s28_naaverdi() -> None:
assert lg.s28_naaverdi(netto=[-100.0, 0.0, 121.0], rente=0.1) == pytest.approx(0.0)
def test_s29_kapitalkostnad() -> None:
"""Half debt at 5 % (4 % after 20 % tax) and half equity at 10 %: 7 % nominal, 4.9 % real."""
r_e = lg.s29_kapitalkostnad(h=0.5, r_d=0.05, r_q=0.10, tau_s=0.2, iota=0.02)
assert r_e == pytest.approx(1.07 / 1.02 - 1.0)
assert lg.realrente(nominell=0.071, iota=0.05) == pytest.approx(0.02)
def test_s30_skatt_med_egen_framforing_for_saerskatten() -> None:
"""Corporate tax 20 % on profit after the loss; special tax 50 % above 5 % of capital 200.
Profit above the return: -100, 50, 70, 40. The loss of 100 takes the 50 and half of the
70, so the special tax base is 0, 0, 20, 40.
"""
selskap, saer = lg.s30_skatt(
overskudd=[-100.0, 60.0, 80.0, 50.0],
kapital_inn=[0.0, 200.0, 200.0, 200.0],
tau_s=0.2,
tau_g=0.5,
r_e=0.05,
)
assert selskap == pytest.approx((0.0, 0.0, 8.0, 10.0))
assert saer == pytest.approx((0.0, 0.0, 10.0, 20.0))
def test_s30_statens_kontantstrom() -> None:
"""State share 0.6, direct share 0.25, the state carries all overruns (zeta = 1)."""
KS = lg.s30_statens_kontantstrom(
skatt=30.0, FKE=100.0, NK=200.0, overskridelse=40.0, s=0.6, theta=0.25, zeta=1.0
)
assert KS == pytest.approx(30.0 + 0.6 * 0.75 * 100.0 + 0.25 * 200.0 - 0.4 * 0.75 * 40.0)
# with zeta equal to the ownership share the state covers nothing beyond its share
uten = lg.s30_statens_kontantstrom(
skatt=30.0, FKE=100.0, NK=200.0, overskridelse=40.0, s=0.6, theta=0.25, zeta=0.6
)
assert uten == pytest.approx(30.0 + 45.0 + 50.0)
# ------------------------------------------------------------ the business cash flow
def test_R_bedriftsstrom_haandregnet(oppdiktet: LagInndata) -> None:
"""One facility in R to 2040, as a business pays.
Building 110 mrd. kr and first vintage 200, paid in 2028 and 2029; vintages of 200 paid
in 2034 and 2039; no grid investment. In operation it pays operation, power at the
price, electricity tax, grid tariff on 1 200 MW and disconnection for 600 MW.
"""
inn = oppdiktet(T_slutt=2040)
res = _regn(inn, Losning.R)
strom = ei.bedriftsstrom(inn, res)
aar = dict(zip(res.aar, range(len(res.aar)), strict=True))
pris = 700.0 - 10e-6 * (10e6 - 0.5 * E_D)
utkobling = 100.0 * _lcoc_v() / (8760.0 * 1.2) * 600.0
assert strom.inntekt[aar[2031]] == pytest.approx(1000.0 * _lcoc_v())
assert strom.avgifter[aar[2031]] == pytest.approx(70.0 * E_D + 0.3e6 * 1200.0)
assert strom.drift[aar[2031]] == pytest.approx(
2.5e9 + pris * E_D + 70.0 * E_D + 0.3e6 * 1200.0 + utkobling
)
assert not strom.drift[: aar[2030]].any()
investert = {2028: 155e9, 2029: 155e9, 2034: 200e9, 2039: 200e9}
for t in res.aar:
assert strom.investering[aar[t]] == pytest.approx(investert.get(t, 0.0))
assert (strom.budsjett == strom.investering).all()
# the building over 15 years and one vintage at a time over 5
assert strom.avskrivning[aar[2030] :] == pytest.approx(110e9 / 15.0 + 40e9)
assert not strom.avskrivning[: aar[2030]].any()
assert strom.kapital[aar[2029]] == pytest.approx(310e9)
assert strom.kapital[aar[2030]] == pytest.approx(310e9 - 110e9 / 15.0 - 40e9)
assert strom.NK[aar[2034]] == pytest.approx(
strom.inntekt[aar[2034]] - strom.drift[aar[2034]] - 200e9
)
@pytest.mark.parametrize("losning", list(Losning))
@pytest.mark.parametrize(
"endringer", [{}, {"T_slutt": 2045, "u_xi": 0.1}, {"L_N": 12.0, "L_B": 7.0}]
)
def test_eiendelene_gir_de_samme_investeringene_som_kontantstrommen(
oppdiktet: LagInndata, losning: Losning, endringer: dict[str, float]
) -> None:
"""The booked assets, paid over their construction time, are the investments of S34 and S35.
All but the grid connection, which the tariff covers. In A the table for the buffer
also holds its fixed operation, which is taken out here.
"""
inn = oppdiktet(u_eksport=None, **endringer)
res = _regn(inn, losning, N_anlegg=2)
strom = ei.bedriftsstrom(inn, res)
ventet = np.zeros(len(res.aar))
for k, a in enumerate(res.anlegg):
ventet += a.I_bygg + a.I_H + a.I_g + a.buffer
for tabell in a.investering.values():
ventet += tabell
if losning is Losning.A:
i_drift = np.array([res.plan.i_drift(k, t) for t in res.aar], dtype=np.float64)
ventet -= i_drift * 0.4e6 * 600.0
for f in res.felles:
ventet += f.investering
assert strom.investering == pytest.approx(ventet)
# the overrun factor is 1.5 in the second set, and only nuclear power carries it
overskridelse = float((strom.investering - strom.budsjett).sum())
if losning.kjernekraft and res.dim.xi_N > 1.0:
eiendeler = [e for a in res.anlegg for e in a.eiendeler]
eiendeler += [e for f in res.felles for e in f.eiendeler]
kjernekraft = math.fsum(e.kostnad for e in eiendeler if e.slag == ks.KJERNEKRAFT)
assert overskridelse == pytest.approx(kjernekraft / 3.0)
else:
assert overskridelse == 0.0
def test_avskrivningene_summerer_seg_til_det_som_er_betalt(oppdiktet: LagInndata) -> None:
"""Every asset is out of operation by 2060, so the booked capital ends at zero."""
inn = oppdiktet()
res = _regn(inn, Losning.A)
strom = ei.bedriftsstrom(inn, res)
assert float(strom.avskrivning.sum()) == pytest.approx(float(strom.investering.sum()))
assert strom.kapital[-1] == pytest.approx(0.0, abs=1.0)
assert (strom.kapital > -1.0).all()
def test_A_betaler_elavgift_men_ikke_nettariff(oppdiktet: LagInndata) -> None:
inn = oppdiktet()
res = _regn(inn, Losning.A)
strom = ei.bedriftsstrom(inn, res)
j = 2040 - 2027
assert strom.avgifter[j] == pytest.approx(70.0 * E_D)
anlegg = res.anlegg[0]
assert strom.drift[j] == pytest.approx(
2.5e9
+ float(anlegg.kraftdrift[ks.KJERNEKRAFT][j])
+ float(anlegg.ulykke[j])
+ 0.4e6 * 600.0
+ 70.0 * E_D
)
def test_kraftverk_paa_nettet_selger_uten_tilleggsregelen(oppdiktet: LagInndata) -> None:
"""The business keeps the plant's whole sales, also when S45 binds in M1."""
inn = oppdiktet(c_N_ref=10e6, f_N=0.3e6)
res = _regn(inn, Losning.B_MERKET)
assert res.varsigma[ks.KJERNEKRAFT] < 1.0
strom = ei.bedriftsstrom(inn, res)
j = 2040 - 2027
anlegg = res.anlegg[0]
uten_salg = (
2.5e9
+ float(anlegg.kraftdrift[ks.KJERNEKRAFT][j])
+ float(anlegg.ulykke[j])
+ res.kraftaar[j].pris * E_D
+ float(strom.avgifter[j])
)
assert strom.drift[j] == pytest.approx(uten_salg - float(anlegg.salg[ks.KJERNEKRAFT][j]))
# S30 is computed with the factor of S45 on the sales (chapter 1.4)
med_regel = ei.bedriftsstrom(inn, res, tilleggsregel=True)
assert med_regel.drift[j] == pytest.approx(
uten_salg - res.varsigma[ks.KJERNEKRAFT] * float(anlegg.salg[ks.KJERNEKRAFT][j])
)
assert (med_regel.investering == strom.investering).all()
# -------------------------------------------------------------- the ownership forms
def test_kapitalkostnad_per_eierform(oppdiktet: LagInndata) -> None:
inn = oppdiktet()
assert ei.kapitalkostnad(inn, inn.eierformer["direkte"]) == 0.02
assert ei.kapitalkostnad(inn, inn.eierformer["heleid_selskap"]) == pytest.approx(
1.07 / 1.02 - 1.0
)
assert ei.kapitalkostnad(inn, inn.eierformer["majoritet_boers"]) == pytest.approx(
1.08 / 1.02 - 1.0
)
def test_direkte_eierskap_gir_staten_hele_kontantstrommen(oppdiktet: LagInndata) -> None:
"""No company and no corporate tax: FKE = NK, and the state also receives tax and tariff."""
inn = oppdiktet(T_slutt=2040)
strom = ei.bedriftsstrom(inn, _regn(inn, Losning.R))
ut = ei.eierresultat(inn, strom, inn.eierformer["direkte"])
assert not ut.selskapsskatt.any()
assert not ut.saerskatt.any()
assert (ut.FKE == strom.NK).all()
assert not ut.gjeld.any()
assert ut.KS_stat == pytest.approx(strom.NK + strom.avgifter)
NV = math.fsum(float(x) / 1.02**j for j, x in enumerate(strom.NK))
assert ei.naaverdi_etter_skatt(inn, strom, inn.eierformer["direkte"]) == pytest.approx(NV)
assert ut.NV_NK == pytest.approx(NV)
# 310 mrd. kr is paid before the first revenue
assert ut.storste_innskutte_kapital == pytest.approx(310e9)
def test_heleid_selskap_skatt_gjeld_og_statens_kontantstrom(oppdiktet: LagInndata) -> None:
"""One wholly owned company, half debt at 5 % nominal (1.05 / 1.02 - 1 real).
Tax is 20 % of revenue minus operation and depreciation; nothing is carried forward
because the first operating year already has a profit. The state owns everything, so
the tax cancels: what it gets is NK, tax and tariff, minus interest, plus new debt.
"""
inn = oppdiktet(T_slutt=2040)
strom = _lonnsom(inn)
ut = ei.eierresultat(inn, strom, inn.eierformer["heleid_selskap"])
overskudd = strom.inntekt - strom.drift - strom.avskrivning
assert (overskudd[3:] > 0).all()
assert ut.selskapsskatt == pytest.approx(0.2 * overskudd)
assert not ut.saerskatt.any()
assert ut.gjeld[:-1] == pytest.approx(0.5 * strom.kapital[:-1])
assert ut.gjeld[-1] == 0.0
gjeld_inn = np.concatenate(([0.0], ut.gjeld[:-1]))
rente = 1.05 / 1.02 - 1.0
FKE = strom.NK - ut.selskapsskatt - rente * gjeld_inn + ut.gjeld - gjeld_inn
assert ut.FKE == pytest.approx(FKE)
assert ut.KS_stat == pytest.approx(
strom.NK + strom.avgifter - rente * gjeld_inn + ut.gjeld - gjeld_inn
)
r_e = 1.07 / 1.02 - 1.0
NV_e = ei.naaverdi_etter_skatt(inn, strom, inn.eierformer["heleid_selskap"])
assert NV_e == pytest.approx(
math.fsum(float(x) / (1.0 + r_e) ** j for j, x in enumerate(strom.NK - ut.selskapsskatt))
)
assert ut.NV_stat == pytest.approx(
math.fsum(float(x) / 1.02**j for j, x in enumerate(ut.KS_stat))
)
andel = ut.andel_av_overskudd
assert andel is not None
assert andel == pytest.approx(ut.NV_stat / ut.NV_NK)
# the owners put in half of what is built, and the interest in 2029 on what was borrowed
# in 2028; the other half is borrowed
assert ut.storste_innskutte_kapital == pytest.approx(155e9 + rente * 77.5e9)
def test_privat_minoritet_og_direkte_andel(oppdiktet: LagInndata) -> None:
"""The petroleum model: the state owns 60 % of the company and 25 % of the facilities directly.
The company's part, 75 %, pays corporate tax and special tax; the state's direct part
does not. Electricity tax and grid tariff come from the whole project.
"""
inn = oppdiktet(T_slutt=2040)
strom = _lonnsom(inn)
ut = ei.eierresultat(inn, strom, inn.eierformer["petroleumsmodell"])
assert ut.saerskatt.sum() > 0
skatt = ut.selskapsskatt + ut.saerskatt
ventet = 0.75 * skatt + strom.avgifter + 0.6 * 0.75 * ut.FKE + 0.25 * strom.NK
assert ut.KS_stat == pytest.approx(ventet)
# the special tax is 50 % of the profit above r_e on the capital booked at the start of the
# year; the return on what was booked during construction is carried forward and used in 2030
r_e = 1.08 / 1.02 - 1.0
overskudd = strom.inntekt - strom.drift - strom.avskrivning
j = 2031 - 2027
assert ut.saerskatt[j] == pytest.approx(0.5 * (overskudd[j] - r_e * strom.kapital[j - 1]))
boers = ei.eierresultat(inn, strom, inn.eierformer["majoritet_boers"])
assert boers.NV_stat < ut.NV_stat
# the special tax lowers the project's value after tax (S28)
assert ei.naaverdi_etter_skatt(
inn, strom, inn.eierformer["majoritet_boers"]
) > ei.naaverdi_etter_skatt(inn, strom, inn.eierformer["petroleumsmodell"])
def test_staten_dekker_overskridelser_ut_over_eierandelen(oppdiktet: LagInndata) -> None:
"""Overrun 50 % on nuclear power; the state owns 60 % but carries all of it (zeta = 1)."""
inn = oppdiktet(u_xi=0.1)
res = _regn(inn, Losning.A)
assert res.dim.xi_N == 1.5
strom = ei.bedriftsstrom(inn, res)
overskridelse = strom.investering - strom.budsjett
assert overskridelse.sum() > 0
ut = ei.eierresultat(inn, strom, inn.eierformer["majoritet_boers"])
skatt = ut.selskapsskatt + ut.saerskatt
uten = skatt + strom.avgifter + 0.6 * ut.FKE
assert ut.KS_stat == pytest.approx(uten - 0.4 * overskridelse)
def test_underskudd_i_oppstarten_gir_ingen_skatt(oppdiktet: LagInndata) -> None:
"""«Overkapasitet»: the price is 30 % under the competitor's cost, and nothing is taxable.
The last vintage, from 2040, is sold at cost and gives a small profit; the losses
carried forward cover it.
"""
inn = oppdiktet(T_slutt=2040)
strom = ei.bedriftsstrom(inn, _regn(inn, Losning.R, knapphet=Knapphet.OVERKAPASITET))
assert (strom.inntekt - strom.drift - strom.avskrivning)[-1] > 0
ut = ei.eierresultat(inn, strom, inn.eierformer["heleid_selskap"])
assert not ut.selskapsskatt.any()
assert ut.NV_stat < 0
assert ut.andel_av_overskudd is None
def test_kapitalkostnaden_flytter_kostnaden_for_regnekraft(oppdiktet: LagInndata) -> None:
inn = oppdiktet()
res = _regn(inn, Losning.B_MERKET)
lav = ei.lcoc_med_kapitalkostnad(inn, res, 0.02)
hoy = ei.lcoc_med_kapitalkostnad(inn, res, 0.06)
assert lav < hoy
# ------------------------------------------------------ the criteria over the draws
def test_risikomaalene() -> None:
utfall = [float(x) for x in range(-10, 30)] # 40 draws: -10 .. 29
assert ei.sannsynlighet_for_tap(utfall) == pytest.approx(10 / 40)
# 5 % of 40 draws is the two worst
assert ei.snitt_av_de_daarligste(utfall) == pytest.approx(-9.5)
assert ei.snitt_av_de_daarligste([3.0, 1.0, 2.0]) == 1.0
def test_storste_innskutte_kapital() -> None:
"""Paid in 100 and 50, then 30 back, then 40 more: 160 out at the most."""
KS = np.array([-100.0, -50.0, 30.0, -40.0, 500.0])
assert ei.storste_innskutte_kapital(KS) == pytest.approx(160.0)
assert ei.storste_innskutte_kapital(np.array([10.0, 20.0])) == 0.0
def _kriterier(navn: str, **endringer: float | None) -> ei.Eierkriterier:
verdier: dict[str, float | None] = {
"verdi": 100.0,
"andel_av_overskudd": 0.9,
"r_e": 0.05,
"LCOC": 80.0,
"tapssannsynlighet": 0.1,
"daarligste": -50.0,
"kapital_ute": 300.0,
}
verdier.update(endringer)
return ei.Eierkriterier(navn=navn, **verdier) # type: ignore[arg-type]
def test_eierkriterier_fra_utfallene(oppdiktet: LagInndata) -> None:
"""Two draws with the same made-up path: the averages are those of the one outcome."""
inn = oppdiktet(T_slutt=2040)
strom = _lonnsom(inn)
ut = ei.eierresultat(inn, strom, inn.eierformer["heleid_selskap"])
k = ei.eierkriterier("heleid_selskap", [ut, ut], [80.0, 90.0])
assert k.verdi == pytest.approx(ut.NV_stat)
assert k.andel_av_overskudd == pytest.approx(ut.NV_stat / ut.NV_NK)
assert k.r_e == pytest.approx(ut.r_e)
assert k.LCOC == pytest.approx(85.0)
assert k.tapssannsynlighet == 0.0
assert k.daarligste == pytest.approx(ut.NV_stat)
assert k.kapital_ute == pytest.approx(ut.storste_innskutte_kapital)
def test_regelen_for_eierformer() -> None:
"""One form fails the EEA test, one is worse on everything, one breaks the risk limit."""
kriterier = [
_kriterier("a", verdi=120.0),
_kriterier("b", verdi=150.0, tapssannsynlighet=0.3),
_kriterier(
"c",
verdi=90.0,
andel_av_overskudd=0.8,
r_e=0.06,
LCOC=85.0,
tapssannsynlighet=0.2,
daarligste=-60.0,
kapital_ute=310.0,
),
_kriterier("d", verdi=200.0),
_kriterier("e", verdi=110.0, r_e=0.06, LCOC=85.0),
]
eos = {"a": "består", "b": "usikker", "c": "består", "d": "består ikke", "e": "består"}
rangering = ei.ranger_eierformer(kriterier, eos)
assert rangering.rangert == ("a", "e")
assert rangering.over_risikogrensen == ("b",)
assert set(rangering.ute) == {"c", "d"}
assert rangering.ute["d"] == "består ikke EØS-vurderingen"
assert "dårligere enn a" in rangering.ute["c"]
# e is worse than a on value and capital cost, but not on risk, so it stays
strengere = ei.ranger_eierformer(kriterier, eos, risikogrense=0.05)
assert strengere.rangert == ()
assert strengere.over_risikogrensen == ("b", "a", "e")