Source code for quantdata.jax.utility
import jax
import jax.numpy as jnp
from cdxcore.err import verify_inp
from collections.abc import Callable
from typing import Tuple
[docs]
def jax_utility(utility : str ="entropy", lmbda : float = 1.0) -> Tuple[Callable, Callable, str]:
"""
Return utility, derivative and name.
"""
verify_inp( lmbda >= 0., lambda: f"Lambda must be non-negative,found {lmbda}" )
if utility == "entropy":
u = lambda x : -jnp.expm1( -lmbda * x ) / lmbda
deriv = lambda x : jnp.exp(-lmbda * x)
label = f"entropy@{lmbda:.2g}"
elif utility == "cvar":
u = lambda x : (1.+lmbda) * jnp.minimum( x, 0. )
deriv = lambda x : jnp.where( x<0., 1.+lmbda, 0. )
label = f"cvar@{lmbda:.2g}"
elif utility == "powexp":
"""
u(x) = 1-exp(-lambda * x) / lambda for x > 0
u(x) = -(-x)^(1+lambda)/(1+lambda) + x for x < 0
u'(x) = exp(-lambda * x) for x > 0 with u'(0) = 1
u'(x) = (-x)^lambda + 1 for x < 0 with u'(0) = 1
u''(x) = -lambda * exp(-lambda * x) for x > 0 with u''(0) = -lambda
u''(x) = -lambda * (-x)^(lambda-1) for x < 0 with u''(0) = -lambda
"""
def u(x):
x_pos = jnp.clip(x, min=0. )
pow = 1.+lmbda
return jnp.where( x>0., -jnp.expm1( -lmbda * x_pos ) / lmbda, -(jnp.abs(x)**pow)/pow+x )
def deriv(x):
x_pos = jnp.clip(x, min=0. )
return jnp.where( x>0., jnp.exp(-lmbda * x_pos), 1.+jnp.abs(x)**lmbda )
label = f"powexp@{lmbda:.2g}"
else:
verify_inp( utility is None or utility == "id", lambda: f"Unknown utility '{utility}'" )
u = lambda x : x
deriv = lambda x : jnp.ones_like(x)
label = "id"
return u, deriv, label