Functions

import pandas as pd

def abs(x: pd.Series) -> pd.Series:
    """Docstring"""

    # function code

def my_func(x: int) -> str:
    """
    Title / one line description

    :param x: description of parameter x
    :return: description of return value

    **Usage**

    Describe how to use the function should be used

    **Examples**

    Provide one or more examples:

    result = my_func(1)

    **See also**

    :func:`his_func` :func:`her_func`
    """
    # function code

import pandas as pd

def abs(x: pd.Series) -> pd.Series:
    """Absolute value

    :math:`R_t = |X_t|`
    """
    # function code

def abs(x: pd.Series) -> pd.Series:
    """
    Absolute value of each element in series

    :param x: date-based time series of prices
    :return: date-based time series of absolute value

    **Usage**

    Return the absolute value of :math:`X`. For each value in time series :math:`X_t`, return :math:`X_t` if :math:`X_t`
    is greater than or equal to 0; otherwise return :math:`-X_t`:

    :math:`R_t = |X_t|`

    Equivalent to :math:`R_t = \sqrt{X_t^2}`

    **Examples**

    Generate price series and take absolute value of :math:`X_t-100`

    >>> prices = generate_series(100) - 100
    >>> abs_(prices)

    **See also**

    :func:`exp` :func:`sqrt`

    """
    return abs(x)