cumulative_trapezoidal_integral
==========================================================================

.. py:function:: petpal.kinetic_modeling.graphical_analysis.cumulative_trapezoidal_integral(xdata: numpy.ndarray, ydata: numpy.ndarray, initial: float = 0.0) -> numpy.ndarray

   Calculates the cumulative integral of `ydata` over `xdata` using the trapezoidal rule.

   This function is based `heavily` on the :py:func:`scipy.integrate.cumulative_trapezoid`
   implementation (`source <https://github.com/scipy/scipy/blob/v1.12.0/scipy/integrate/_quadrature.py#L432-L536>`_).
   This implementation only works for 1D arrays and was implemented to work with :mod:`numba`.

   :param xdata: Array for the integration coordinate.
   :type xdata: np.ndarray
   :param ydata: Array for the values to integrate
   :type ydata: np.ndarray

   :returns: *(np.ndarray)* -- Cumulative integral of ``ydata`` over ``xdata`` using the trapezoidal rule.