riskvalidation 0.8.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (164) hide show
  1. riskvalidation/__init__.py +30 -0
  2. riskvalidation/aggregation/__init__.py +11 -0
  3. riskvalidation/aggregation/band.py +151 -0
  4. riskvalidation/aggregation/bounds.py +191 -0
  5. riskvalidation/aggregation/copulas.py +241 -0
  6. riskvalidation/aggregation/model_risk.py +133 -0
  7. riskvalidation/aggregation/simple.py +147 -0
  8. riskvalidation/ccr/__init__.py +13 -0
  9. riskvalidation/ccr/collateral.py +175 -0
  10. riskvalidation/ccr/cva.py +193 -0
  11. riskvalidation/ccr/exposure.py +192 -0
  12. riskvalidation/ccr/hw1f.py +426 -0
  13. riskvalidation/ccr/swaps.py +172 -0
  14. riskvalidation/core/__init__.py +1 -0
  15. riskvalidation/core/build.py +57 -0
  16. riskvalidation/core/hashing.py +48 -0
  17. riskvalidation/core/policy.py +130 -0
  18. riskvalidation/core/registry.py +65 -0
  19. riskvalidation/core/result.py +117 -0
  20. riskvalidation/core/suite.py +78 -0
  21. riskvalidation/engines/__init__.py +2 -0
  22. riskvalidation/engines/low_default.py +170 -0
  23. riskvalidation/engines/pd_curve.py +529 -0
  24. riskvalidation/engines/vasicek.py +72 -0
  25. riskvalidation/fairness/__init__.py +10 -0
  26. riskvalidation/fairness/_checks.py +115 -0
  27. riskvalidation/fairness/conditional.py +201 -0
  28. riskvalidation/fairness/inference.py +64 -0
  29. riskvalidation/fairness/metrics.py +261 -0
  30. riskvalidation/fairness/plants.py +240 -0
  31. riskvalidation/fairness/policy.py +97 -0
  32. riskvalidation/fairness/replication.py +39 -0
  33. riskvalidation/fairness/situation.py +307 -0
  34. riskvalidation/generators/__init__.py +68 -0
  35. riskvalidation/generators/_base.py +145 -0
  36. riskvalidation/generators/counts.py +232 -0
  37. riskvalidation/generators/drift.py +107 -0
  38. riskvalidation/generators/framingham.py +124 -0
  39. riskvalidation/generators/paths.py +349 -0
  40. riskvalidation/generators/ratings.py +186 -0
  41. riskvalidation/generators/scores.py +347 -0
  42. riskvalidation/harness/__init__.py +46 -0
  43. riskvalidation/harness/exact.py +137 -0
  44. riskvalidation/harness/performance.py +74 -0
  45. riskvalidation/harness/rates.py +103 -0
  46. riskvalidation/harness/run.py +197 -0
  47. riskvalidation/irrbb/__init__.py +9 -0
  48. riskvalidation/irrbb/behavioural.py +206 -0
  49. riskvalidation/irrbb/curves.py +286 -0
  50. riskvalidation/irrbb/eve_nii.py +245 -0
  51. riskvalidation/irrbb/shocks.py +171 -0
  52. riskvalidation/irrbb/simulation.py +203 -0
  53. riskvalidation/irrbb/slotting.py +184 -0
  54. riskvalidation/lgd_ead/__init__.py +8 -0
  55. riskvalidation/lgd_ead/_checks.py +50 -0
  56. riskvalidation/lgd_ead/ccf.py +228 -0
  57. riskvalidation/lgd_ead/downturn.py +64 -0
  58. riskvalidation/lgd_ead/floors.py +114 -0
  59. riskvalidation/lgd_ead/lgd_models.py +297 -0
  60. riskvalidation/lgd_ead/workout.py +162 -0
  61. riskvalidation/liquidity/__init__.py +9 -0
  62. riskvalidation/liquidity/_checks.py +78 -0
  63. riskvalidation/liquidity/cbc.py +158 -0
  64. riskvalidation/liquidity/deposits.py +151 -0
  65. riskvalidation/liquidity/ladder.py +119 -0
  66. riskvalidation/liquidity/reverse.py +141 -0
  67. riskvalidation/liquidity/runoff.py +220 -0
  68. riskvalidation/liquidity/scenarios.py +272 -0
  69. riskvalidation/market/__init__.py +8 -0
  70. riskvalidation/market/caviar.py +239 -0
  71. riskvalidation/market/conventions.py +83 -0
  72. riskvalidation/market/evt.py +111 -0
  73. riskvalidation/market/frtb.py +175 -0
  74. riskvalidation/market/garch.py +204 -0
  75. riskvalidation/market/gas_fz.py +219 -0
  76. riskvalidation/market/historical.py +96 -0
  77. riskvalidation/market/parametric.py +78 -0
  78. riskvalidation/market/scoring.py +145 -0
  79. riskvalidation/ml/__init__.py +11 -0
  80. riskvalidation/ml/_checks.py +67 -0
  81. riskvalidation/ml/_logistic.py +82 -0
  82. riskvalidation/ml/cbpe.py +91 -0
  83. riskvalidation/ml/challenger.py +73 -0
  84. riskvalidation/ml/conformal.py +116 -0
  85. riskvalidation/ml/dataquality.py +130 -0
  86. riskvalidation/ml/effects.py +67 -0
  87. riskvalidation/ml/explanations.py +125 -0
  88. riskvalidation/ml/generalisation.py +79 -0
  89. riskvalidation/ml/leakage.py +99 -0
  90. riskvalidation/ml/plants.py +425 -0
  91. riskvalidation/ml/policy.py +182 -0
  92. riskvalidation/ml/robustness.py +286 -0
  93. riskvalidation/ml/seeds.py +106 -0
  94. riskvalidation/oprisk/__init__.py +18 -0
  95. riskvalidation/oprisk/_checks.py +60 -0
  96. riskvalidation/oprisk/aggregate.py +375 -0
  97. riskvalidation/oprisk/distributions.py +758 -0
  98. riskvalidation/oprisk/scenarios.py +342 -0
  99. riskvalidation/oprisk/sla.py +80 -0
  100. riskvalidation/oprisk/sma.py +169 -0
  101. riskvalidation/policies/__init__.py +4 -0
  102. riskvalidation/policies/default.json +273 -0
  103. riskvalidation/portfolio/__init__.py +16 -0
  104. riskvalidation/portfolio/asrf_fit.py +283 -0
  105. riskvalidation/portfolio/copula.py +129 -0
  106. riskvalidation/portfolio/creditrisk_plus.py +232 -0
  107. riskvalidation/portfolio/euler.py +126 -0
  108. riskvalidation/portfolio/granularity.py +135 -0
  109. riskvalidation/portfolio/importance.py +277 -0
  110. riskvalidation/portfolio/portfolio.py +309 -0
  111. riskvalidation/provisions/__init__.py +8 -0
  112. riskvalidation/provisions/_checks.py +100 -0
  113. riskvalidation/provisions/ecl.py +233 -0
  114. riskvalidation/provisions/local_cl.py +360 -0
  115. riskvalidation/provisions/local_es.py +157 -0
  116. riskvalidation/provisions/overlays.py +102 -0
  117. riskvalidation/provisions/reconciliation.py +157 -0
  118. riskvalidation/provisions/staging.py +211 -0
  119. riskvalidation/provisions/term_structure.py +199 -0
  120. riskvalidation/regulatory/__init__.py +14 -0
  121. riskvalidation/regulatory/ba_cva.py +138 -0
  122. riskvalidation/regulatory/frtb.py +345 -0
  123. riskvalidation/regulatory/irb.py +314 -0
  124. riskvalidation/regulatory/lcr_nsfr.py +369 -0
  125. riskvalidation/regulatory/output_floor.py +45 -0
  126. riskvalidation/regulatory/sa_ccr.py +486 -0
  127. riskvalidation/regulatory/standardised.py +348 -0
  128. riskvalidation/stress/__init__.py +9 -0
  129. riskvalidation/stress/capital.py +476 -0
  130. riskvalidation/stress/paths.py +108 -0
  131. riskvalidation/stress/reverse.py +179 -0
  132. riskvalidation/stress/satellites.py +268 -0
  133. riskvalidation/stress/scenario_models.py +274 -0
  134. riskvalidation/transitions/__init__.py +0 -0
  135. riskvalidation/transitions/em.py +120 -0
  136. riskvalidation/transitions/embedding.py +221 -0
  137. riskvalidation/transitions/estimators.py +213 -0
  138. riskvalidation/transitions/intervals.py +306 -0
  139. riskvalidation/transitions/mobility.py +57 -0
  140. riskvalidation/transitions/ttc.py +171 -0
  141. riskvalidation/validation/__init__.py +103 -0
  142. riskvalidation/validation/_common.py +57 -0
  143. riskvalidation/validation/aggregation.py +425 -0
  144. riskvalidation/validation/calibration.py +757 -0
  145. riskvalidation/validation/ccr.py +530 -0
  146. riskvalidation/validation/discrimination.py +314 -0
  147. riskvalidation/validation/fairness.py +632 -0
  148. riskvalidation/validation/ifrs9.py +693 -0
  149. riskvalidation/validation/irrbb.py +389 -0
  150. riskvalidation/validation/lgd_ead.py +469 -0
  151. riskvalidation/validation/liquidity.py +647 -0
  152. riskvalidation/validation/market.py +807 -0
  153. riskvalidation/validation/ml.py +958 -0
  154. riskvalidation/validation/oprisk.py +357 -0
  155. riskvalidation/validation/portfolio.py +353 -0
  156. riskvalidation/validation/rating_system.py +245 -0
  157. riskvalidation/validation/stability.py +256 -0
  158. riskvalidation/validation/stress.py +552 -0
  159. riskvalidation/validation/transitions.py +386 -0
  160. riskvalidation-0.8.0.dist-info/METADATA +136 -0
  161. riskvalidation-0.8.0.dist-info/RECORD +164 -0
  162. riskvalidation-0.8.0.dist-info/WHEEL +5 -0
  163. riskvalidation-0.8.0.dist-info/licenses/LICENSE +21 -0
  164. riskvalidation-0.8.0.dist-info/top_level.txt +1 -0
@@ -0,0 +1,171 @@
1
+ r"""The through-the-cycle portfolio a migration matrix implies, and the projection that drifts towards it.
2
+
3
+ Engelmann (2024), Spurious default probability projections in credit risk stress testing models, arXiv 2401.08892v1
4
+ (read in full): a portfolio $W$ over $n$ states (default last) is propagated one period by a transition matrix $T$,
5
+ its defaulted part written off and re-originated by the vector $O$ ($\sum_i o_i = 1$), keeping the balance constant,
6
+
7
+ $$W_t' = W_{t-1}' T(z_t) I_w + (W_{t-1}' T(z_t) V_w)\, O' \qquad (9)$$
8
+
9
+ with $I_w$ the identity whose last diagonal entry is 0 and $V_w = (0, \dots, 0, 1)'$. Theorem 1: if the performing
10
+ block $T_p = (p_{ij})_{i,j<n}$ is primitive (some power strictly positive) and $o_n = 0$, there is a unique portfolio
11
+ with
12
+
13
+ $$W_{ttc}' = W_{ttc}' T I_w + (W_{ttc}' T V_w)\, O' \qquad (10)$$
14
+
15
+ computed by iterating (9) with the unstressed $T$ "for an arbitrary initial portfolio" (the proof applies
16
+ Perron-Frobenius to $M = T I_w + T V_w O'$). "Independent of the stress imposed to the model, the current portfolio
17
+ will have a tendency to propagate towards the through-the-cycle portfolio", and the convergence "is not monotonic":
18
+ a projection under the unstressed matrix can show a spurious recession or boom. The portfolio PD is
19
+ $\sum_i w_i\, T_{in}$. Section 4's example (the Trueck and Rachev 2009 matrix (11)) is reproduced in
20
+ ``tests/test_reproductions.py``.
21
+
22
+ A printed matrix has rows summing to 1 only up to its rounding (the matrix (11): 1 +- 0.0001). It is used as printed,
23
+ and the balance is kept constant, as the paper's step 5 states ("to keep total loan balance constant over time"), by
24
+ rescaling the portfolio to unit balance after each period. That reproduces section 4 to the printed digits;
25
+ renormalising the rows instead moves two entries of the printed TTC portfolio by 0.0002.
26
+
27
+ Primitivity is checked by Wielandt's bound: a non-negative $k \times k$ matrix is primitive if and only if its
28
+ $((k - 1)^2 + 1)$-th power is strictly positive.
29
+ """
30
+
31
+ from __future__ import annotations
32
+
33
+ from typing import Any
34
+
35
+ import numpy as np
36
+
37
+ ENGELMANN_2024 = (
38
+ "Engelmann (2024), Spurious default probability projections in credit risk stress testing models, arXiv "
39
+ "2401.08892v1, equations (9) and (10), Theorem 1"
40
+ )
41
+
42
+
43
+ def _transition(t: Any, atol: float) -> tuple[np.ndarray, float]:
44
+ """A transition matrix, default last and absorbing, its rows summing to 1 within ``atol`` (a printed matrix's
45
+ rounding), kept as given. Returns the matrix and the largest row-sum deviation."""
46
+ a = np.asarray(t, dtype=float)
47
+ if a.ndim != 2 or a.shape[0] != a.shape[1] or a.shape[0] < 3:
48
+ raise ValueError(f"the transition matrix must be square with at least two grades and default, got {a.shape}")
49
+ if not np.all(np.isfinite(a)) or np.any(a < 0):
50
+ raise ValueError("the transition matrix must be finite and non-negative")
51
+ dev = float(np.max(np.abs(a.sum(axis=1) - 1.0)))
52
+ if dev > atol:
53
+ raise ValueError(f"a row sums to 1 +- {dev:.2g}, beyond atol {atol}")
54
+ n = a.shape[0]
55
+ if not np.allclose(a[-1], np.eye(n)[-1], atol=atol):
56
+ raise ValueError("default (the last state) must be absorbing")
57
+ return a, dev
58
+
59
+
60
+ def _origination(o: Any, n: int, atol: float) -> np.ndarray:
61
+ v = np.asarray(o, dtype=float)
62
+ if v.shape == (n - 1,):
63
+ v = np.append(v, 0.0)
64
+ if v.shape != (n,) or not np.all(np.isfinite(v)) or np.any(v < 0):
65
+ raise ValueError(f"the origination vector must give {n - 1} or {n} non-negative shares")
66
+ if v[-1] > 0:
67
+ raise ValueError("origination into default breaks Theorem 1's second condition (o_n = 0)")
68
+ if abs(v.sum() - 1.0) > atol:
69
+ raise ValueError(f"the origination shares sum to {v.sum():.6g}, not 1")
70
+ return v / v.sum()
71
+
72
+
73
+ def is_primitive(a: Any) -> bool:
74
+ """Wielandt: a non-negative k x k matrix is primitive iff its ((k - 1)^2 + 1)-th power is strictly positive."""
75
+ b = (np.asarray(a, dtype=float) > 0).astype(np.int64)
76
+ k = b.shape[0]
77
+ power = (k - 1) ** 2 + 1
78
+ result = np.eye(k, dtype=np.int64)
79
+ base = b
80
+ while power:
81
+ if power & 1:
82
+ result = np.minimum(result @ base, 1)
83
+ base = np.minimum(base @ base, 1)
84
+ power >>= 1
85
+ return bool(np.all(result > 0))
86
+
87
+
88
+ def propagation_matrix(transition: Any, origination: Any, *, atol: float = 1e-3) -> np.ndarray:
89
+ """M = T I_w + (T V_w) O', so that (9) with a constant T is W_t' = W_{t-1}' M."""
90
+ t, _ = _transition(transition, atol)
91
+ o = _origination(origination, t.shape[0], atol)
92
+ m = t.copy()
93
+ m[:, -1] = 0.0
94
+ return m + np.outer(t[:, -1], o)
95
+
96
+
97
+ def ttc_portfolio(transition: Any, origination: Any, *, atol: float = 1e-3, tol: float = 1e-14,
98
+ max_iter: int = 1_000_000) -> dict[str, Any]:
99
+ """Engelmann's W_ttc: iterate (9) from the uniform performing portfolio, at unit balance, until the L1 change is
100
+ below ``tol``; refuses a matrix whose performing block is not primitive or an origination into default (Theorem
101
+ 1). ``eigenvector_distance`` checks the result against the Perron vector of M."""
102
+ t, dev = _transition(transition, atol)
103
+ n = t.shape[0]
104
+ if not is_primitive(t[:-1, :-1]):
105
+ raise ValueError("the performing block is not primitive (Theorem 1's first condition): no unique TTC "
106
+ "portfolio")
107
+ m = propagation_matrix(t, origination, atol=atol)
108
+ w = np.append(np.full(n - 1, 1.0 / (n - 1)), 0.0)
109
+ converged = False
110
+ iterations = 0
111
+ while not converged and iterations < max_iter:
112
+ iterations += 1
113
+ nxt = w @ m
114
+ nxt = nxt / nxt.sum()
115
+ converged = float(np.abs(nxt - w).sum()) < tol
116
+ w = nxt
117
+ vals, vecs = np.linalg.eig(m.T)
118
+ v = np.real(vecs[:, np.argmax(np.real(vals))])
119
+ v = v / v.sum()
120
+ return {
121
+ "portfolio": w,
122
+ "default_rate": float(w @ t[:, -1]),
123
+ "iterations": iterations,
124
+ "converged": converged,
125
+ "eigenvector_distance": float(np.abs(v - w).sum()),
126
+ "row_sum_deviation": dev,
127
+ "reference": ENGELMANN_2024,
128
+ }
129
+
130
+
131
+ def project(transition: Any, portfolio: Any, origination: Any, years: int | None = None, *,
132
+ atol: float = 1e-3) -> dict[str, Any]:
133
+ """Propagate ``portfolio`` by (9) at unit balance: ``transition`` one matrix (the unstressed projection, over
134
+ ``years``) or one matrix per year (a stressed path T(z_t)). Returns the portfolio at each date (years + 1 rows),
135
+ the portfolio PD at each date before the last (``default_rate[t]`` = W_t' T_{t+1} V_w, the default rate of year
136
+ t + 1), and, for one matrix, the TTC portfolio and each date's L1 distance to it."""
137
+ arr = np.asarray(transition, dtype=float)
138
+ if arr.ndim == 2:
139
+ if years is None or years < 1:
140
+ raise ValueError("one matrix needs years >= 1")
141
+ mats = [_transition(arr, atol)[0]] * int(years)
142
+ elif arr.ndim == 3:
143
+ if years is not None and years != arr.shape[0]:
144
+ raise ValueError("years must equal the number of matrices")
145
+ mats = [_transition(a, atol)[0] for a in arr]
146
+ else:
147
+ raise ValueError("transition is one matrix or one matrix per year")
148
+ n = mats[0].shape[0]
149
+ w0 = np.asarray(portfolio, dtype=float)
150
+ if w0.shape == (n - 1,):
151
+ w0 = np.append(w0, 0.0)
152
+ if w0.shape != (n,) or np.any(w0 < 0) or abs(w0.sum() - 1.0) > atol:
153
+ raise ValueError(f"the portfolio must give {n - 1} or {n} non-negative shares summing to 1")
154
+ o = _origination(origination, n, atol)
155
+ path = [w0 / w0.sum()]
156
+ rates = []
157
+ for t in mats:
158
+ w = path[-1]
159
+ rates.append(float(w @ t[:, -1]))
160
+ moved = w @ t
161
+ nxt = np.append(moved[:-1], 0.0) + moved[-1] * o
162
+ path.append(nxt / nxt.sum())
163
+ out: dict[str, Any] = {"portfolio": np.array(path), "default_rate": np.array(rates), "reference": ENGELMANN_2024}
164
+ if arr.ndim == 2:
165
+ ttc = ttc_portfolio(arr, o, atol=atol)
166
+ out["ttc"] = ttc
167
+ out["distance_to_ttc"] = np.abs(out["portfolio"] - ttc["portfolio"]).sum(axis=1)
168
+ return out
169
+
170
+
171
+ __all__ = ["is_primitive", "project", "propagation_matrix", "ttc_portfolio"]
@@ -0,0 +1,103 @@
1
+ """Validation tests, grouped by family. Importing this package registers every test in the catalogue."""
2
+
3
+ from riskvalidation.validation import ( # noqa: F401 (each module registers its tests on import)
4
+ aggregation,
5
+ calibration,
6
+ ccr,
7
+ discrimination,
8
+ fairness,
9
+ ifrs9,
10
+ irrbb,
11
+ lgd_ead,
12
+ liquidity,
13
+ market,
14
+ ml,
15
+ oprisk,
16
+ portfolio,
17
+ rating_system,
18
+ stability,
19
+ stress,
20
+ transitions,
21
+ )
22
+ from riskvalidation.validation.calibration import (
23
+ critical_default_count,
24
+ pd_binomial,
25
+ pd_binomial_vasicek,
26
+ pd_brier,
27
+ pd_chi2_grades,
28
+ pd_default_profile,
29
+ pd_ece,
30
+ pd_hosmer_lemeshow,
31
+ pd_jeffreys,
32
+ pd_jeffreys_grades,
33
+ pd_normal_multiperiod,
34
+ pd_spiegelhalter,
35
+ pd_traffic_lights,
36
+ )
37
+ from riskvalidation.validation.discrimination import (
38
+ bootstrap_ci,
39
+ cap_accuracy_ratio,
40
+ disc_auc,
41
+ disc_auc_vs_initial,
42
+ disc_delong,
43
+ disc_ks,
44
+ )
45
+ from riskvalidation.validation.rating_system import rating_hhi, rating_migration_ztests, rating_mwb
46
+ from riskvalidation.validation.stability import (
47
+ bin_counts,
48
+ psi_benchmark,
49
+ quantile_edges,
50
+ stability_chi2,
51
+ stability_csi,
52
+ stability_ks,
53
+ stability_psi,
54
+ stability_wasserstein,
55
+ )
56
+ from riskvalidation.validation.transitions import (
57
+ rating_markov_order,
58
+ rating_matrix_reference,
59
+ rating_momentum,
60
+ rating_time_homogeneity,
61
+ )
62
+
63
+ __all__ = [
64
+ "bin_counts",
65
+ "bootstrap_ci",
66
+ "calibration",
67
+ "cap_accuracy_ratio",
68
+ "critical_default_count",
69
+ "disc_auc",
70
+ "disc_auc_vs_initial",
71
+ "disc_delong",
72
+ "disc_ks",
73
+ "discrimination",
74
+ "pd_binomial",
75
+ "pd_binomial_vasicek",
76
+ "pd_brier",
77
+ "pd_chi2_grades",
78
+ "pd_default_profile",
79
+ "pd_ece",
80
+ "pd_hosmer_lemeshow",
81
+ "pd_jeffreys",
82
+ "pd_jeffreys_grades",
83
+ "pd_normal_multiperiod",
84
+ "pd_spiegelhalter",
85
+ "pd_traffic_lights",
86
+ "psi_benchmark",
87
+ "quantile_edges",
88
+ "rating_hhi",
89
+ "rating_migration_ztests",
90
+ "rating_mwb",
91
+ "rating_system",
92
+ "stability",
93
+ "stability_chi2",
94
+ "stability_csi",
95
+ "stability_ks",
96
+ "stability_psi",
97
+ "stability_wasserstein",
98
+ "rating_markov_order",
99
+ "rating_matrix_reference",
100
+ "rating_momentum",
101
+ "rating_time_homogeneity",
102
+ "transitions",
103
+ ]
@@ -0,0 +1,57 @@
1
+ """Input checks shared by the validation tests."""
2
+
3
+ from __future__ import annotations
4
+
5
+ from collections.abc import Sequence
6
+ from typing import Any
7
+
8
+ import numpy as np
9
+
10
+
11
+ def as_float_array(x: Any, name: str) -> np.ndarray:
12
+ a = np.asarray(x, dtype=float)
13
+ if a.ndim != 1:
14
+ raise ValueError(f"{name} must be one-dimensional, got shape {a.shape}")
15
+ if a.size == 0:
16
+ raise ValueError(f"{name} is empty")
17
+ if not np.all(np.isfinite(a)):
18
+ raise ValueError(f"{name} contains non-finite values")
19
+ return a
20
+
21
+
22
+ def as_binary(y: Any, name: str = "defaults") -> np.ndarray:
23
+ a = np.asarray(y)
24
+ if a.ndim != 1 or a.size == 0:
25
+ raise ValueError(f"{name} must be a non-empty one-dimensional array")
26
+ vals = np.unique(a)
27
+ if not np.all(np.isin(vals, (0, 1))):
28
+ raise ValueError(f"{name} must contain only 0 and 1, got values {vals[:5].tolist()}")
29
+ return a.astype(int)
30
+
31
+
32
+ def check_pd(pd: Any, name: str = "pd") -> np.ndarray:
33
+ a = np.atleast_1d(np.asarray(pd, dtype=float))
34
+ if np.any(~np.isfinite(a)) or np.any(a <= 0.0) or np.any(a >= 1.0):
35
+ raise ValueError(f"{name} must lie strictly between 0 and 1")
36
+ return a
37
+
38
+
39
+ def check_counts(n: Any, d: Any) -> tuple[np.ndarray, np.ndarray]:
40
+ n_a = np.atleast_1d(np.asarray(n))
41
+ d_a = np.atleast_1d(np.asarray(d))
42
+ if n_a.shape != d_a.shape:
43
+ raise ValueError("obligor and default counts must have the same shape")
44
+ for arr, name in ((n_a, "obligor counts"), (d_a, "default counts")):
45
+ if not np.all(np.equal(np.mod(arr, 1), 0)) or np.any(arr < 0):
46
+ raise ValueError(f"{name} must be non-negative integers")
47
+ if np.any(d_a > n_a):
48
+ raise ValueError("default counts cannot exceed obligor counts")
49
+ return n_a.astype(np.int64), d_a.astype(np.int64)
50
+
51
+
52
+ def labels(k: int, given: Sequence[str] | None) -> list[str]:
53
+ if given is None:
54
+ return [f"grade {i + 1}" for i in range(k)]
55
+ if len(given) != k:
56
+ raise ValueError(f"expected {k} labels, got {len(given)}")
57
+ return [str(g) for g in given]