Kappa log: private API
PortfolioOptimisers.kappa_log — Function
kappa_log(u::Number, kappa::Number)Evaluate the Kaniadakis logarithm of [179], the inverse of the κ-deformed exponential.
[204] defines the relativistic value at risk with this logarithm. RRM, set_relativistic_risk_constraints! and the relativistic value at risk views of entropy pooling multiply a dual variable by kappa_log(inv(alpha * T), kappa), where alpha is the significance level and T is the sample size. EntropyBudget finds the kappa that gives a target value of this coefficient.
The function checks neither argument. Each relativistic risk measure and each relativistic value at risk view runs assert_unit_interval on kappa in its constructor. When a calibration rule gives kappa, rebuild_with_slots runs the same constructor on the new value. EntropyBudget passes the midpoints of a bracket inside $(0, 1)$. Every caller passes $u = 1 / (\alpha T)$, which is positive.
Mathematical definition
\[\begin{align} \ln_{\kappa}(u) &= \dfrac{u^{\kappa} - u^{-\kappa}}{2 \kappa}\,. \end{align}\]
Where:
- $\ln_{\kappa}(u) = \dfrac{u^{\kappa} - u^{-\kappa}}{2 \kappa}$: Kaniadakis logarithm.
- $u > 0$: Argument of the logarithm.
- $\kappa$: Kaniadakis deformation parameter, $\kappa \in (0, 1)$.
The value is negative for every $u < 1$, and $\ln_{\kappa}(u) \to \ln(u)$ as $\kappa \to 0$.
Arguments
u: Argument of the logarithm. It must be positive.kappa: Kaniadakis deformation parameter. It must lie in $(0, 1)$.
Returns
lnk::Number: Value of the Kaniadakis logarithm.
Examples
julia> PortfolioOptimisers.kappa_log(2, 0.3)0.6981533616478014julia> PortfolioOptimisers.kappa_log(0.5, 0.3)-0.6981533616478014Related
RRMset_relativistic_risk_constraints!RelativisticValueatRiskConicRelativisticValueatRiskViewGridTailViewEntropyBudgetassert_unit_interval: the check that the constructors run onkappa.
References
- [179] G. Kaniadakis. Non-linear kinetics underlying generalized statistics. Physica A: Statistical Mechanics and its Applications 296, 405–425 (2001). Section VI, Equation 63.
- [204] D. Cajas. Portfolio Optimization of Relativistic Value at Risk. Available at SSRN 4378498 (2023). Section 2.2, Equation 5.
References
- [179]
- G. Kaniadakis. Non-linear kinetics underlying generalized statistics. Physica A: Statistical Mechanics and its Applications 296, 405–425 (2001), arXiv:cond-mat/0103467.
- [204]
- D. Cajas. Portfolio Optimization of Relativistic Value at Risk. Available at SSRN 4378498 (2023).