Module deepcomp.env.util.utility

Auxiliary functions for calculating the utility of achieving a certain data rate (for a UE). Attention: The absolute reward that's achieved with different utilities cannot be compared directly (diff ranges)!

"""
Auxiliary functions for calculating the utility of achieving a certain data rate (for a UE).
Attention: The absolute reward that's achieved with different utilities cannot be compared directly (diff ranges)!
"""
import numpy as np


def step_utility(curr_dr, req_dr):
    """
    Flat negative utility as long as the required data rate is not met; then positive. Nothing in between.

    :param curr_dr: Current data rate
    :param req_dr: Required data rate
    :return: Utility (-10 or +10)
    """
    if curr_dr >= req_dr:
        return 10
    return -10


def log_utility(curr_dr):
    """
    More data rate increases the utility following a log function: High initial increase, then flattens.

    :param curr_dr: Current data rate
    :param factor: Factor to multiply the log function with
    :param add: Add to current data rate before passing to log function
    :return: Utility
    """
    # 4*log(0.1+x) looks good: around -10 for no dr; 0 for 0.9 dr; slightly positive for more
    # 10*log10(0.1+x) is even better because it's steeper, is exactly -10 for dr=0, and flatter for larger dr
    # with many UEs where each UE only gets around 0.1 data rate, 100*log(0.9+x) looks good (eg, 50 UEs on medium env)

    # better: 10*log10(x) --> clip to [-20, 20]; -20 for <= 0.01 dr; +20 for >= 100 dr
    if curr_dr == 0:
        return -20
    return np.clip(10 * np.log10(curr_dr), -20, 20)

Functions

def log_utility(curr_dr)

More data rate increases the utility following a log function: High initial increase, then flattens.

:param curr_dr: Current data rate :param factor: Factor to multiply the log function with :param add: Add to current data rate before passing to log function :return: Utility

Expand source code

def log_utility(curr_dr):
    """
    More data rate increases the utility following a log function: High initial increase, then flattens.

    :param curr_dr: Current data rate
    :param factor: Factor to multiply the log function with
    :param add: Add to current data rate before passing to log function
    :return: Utility
    """
    # 4*log(0.1+x) looks good: around -10 for no dr; 0 for 0.9 dr; slightly positive for more
    # 10*log10(0.1+x) is even better because it's steeper, is exactly -10 for dr=0, and flatter for larger dr
    # with many UEs where each UE only gets around 0.1 data rate, 100*log(0.9+x) looks good (eg, 50 UEs on medium env)

    # better: 10*log10(x) --> clip to [-20, 20]; -20 for <= 0.01 dr; +20 for >= 100 dr
    if curr_dr == 0:
        return -20
    return np.clip(10 * np.log10(curr_dr), -20, 20)

def step_utility(curr_dr, req_dr)

Flat negative utility as long as the required data rate is not met; then positive. Nothing in between.

:param curr_dr: Current data rate :param req_dr: Required data rate :return: Utility (-10 or +10)

Expand source code

def step_utility(curr_dr, req_dr):
    """
    Flat negative utility as long as the required data rate is not met; then positive. Nothing in between.

    :param curr_dr: Current data rate
    :param req_dr: Required data rate
    :return: Utility (-10 or +10)
    """
    if curr_dr >= req_dr:
        return 10
    return -10