# Source code for deltasigma._rmsGain

# -*- coding: utf-8 -*-
# _rmsGain.py
# Module providing the rmsGain function
# This file is part of python-deltasigma.
#
# python-deltasigma is a 1:1 Python replacement of Richard Schreier's
# MATLAB delta sigma toolbox (aka "delsigma"), upon which it is heavily based.
# The delta sigma toolbox is (c) 2009, Richard Schreier.
#
# python-deltasigma is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# LICENSE file for the licensing terms.

"""Module providing the rmsGain() function
"""

import numpy as np
from scipy.linalg import norm

from ._evalTF import evalTF

[docs]def rmsGain(H, f1, f2, N=100): """Compute the root mean-square gain of a discrete-time TF. The computation is carried out over the frequency band (f1, f2), employing N discretization steps. **Parameters:** H : object The discrete-time transfer function. See :func:evalTF for the supported types. f1 : scalar The start value in Hertz of the frequency band over which the gain is evaluated. f2 : scalar The end value (inclusive) in Hertz of the aforementioned frequency band. N : integer, optional The number of discretization points to be taken over specified interval. **Returns:** Grms : scalar The root mean-square gain """ w = np.linspace(2*np.pi*f1, 2*np.pi*f2, N) g = norm(evalTF(H, np.exp(1j*w))) / np.sqrt(N) return g