xarpes 0.2.4__py3-none-any.whl → 0.3.0__py3-none-any.whl

xarpes/distributions.py

@@ -1,11 +1,151 @@
-# Copyright (C) 2024 xARPES Developers
+# Copyright (C) 2025 xARPES Developers
 # This program is free software under the terms of the GNU GPLv3 license.
 
 """The distributions used throughout the code."""
 
 import numpy as np
+from .functions import extend_function
+from .plotting import get_ax_fig_plt, add_fig_kwargs
+from .constants import k_B, pref, dtor
+
+class CreateDistributions:
+    r"""
+    Thin container for distributions with leaf-aware utilities.
+    If a distribution implements `components()` -> iterable of leaf
+    distributions, we use it to count/flatten; otherwise it's treated as a leaf.
+    """
+    def __init__(self, distributions):
+        # Adds a call method to the distribution list
+        self.distributions = distributions
+
+    def __call__(self):
+        r"""
+        """
+        return self.distributions
+
+    @property
+    def distributions(self):
+        r"""
+        """
+        return self._distributions
+
+    @distributions.setter
+    def distributions(self, x):
+        r"""
+        """
+        self._distributions = x
+
+    def __iter__(self):
+        r"""
+        """
+        return iter(self.distributions)
+
+    def __getitem__(self, index):
+        r"""
+        """
+        return self.distributions[index]
+
+    def __setitem__(self, index, value):
+        r"""
+        """
+        self.distributions[index] = value
+
+    def __len__(self):
+        r"""
+        """
+        # Fast path: flat list length (may be different from n_individuals 
+        # if composites exist)
+        return len(self.distributions)
+
+    def __deepcopy__(self, memo):
+        r"""
+        """
+        import copy
+        return type(self)(copy.deepcopy(self.distributions, memo))
+
+    # -------- Leaf-aware helpers --------
+    def _iter_leaves(self):
+        """
+        Yield leaf distributions. If an item has .components(), flatten it;
+        else treat the item itself as a leaf.
+        """
+        for d in self.distributions:
+            comps = getattr(d, "components", None)
+            if callable(comps):
+                for leaf in comps():
+                    yield leaf
+            else:
+                yield d
+
+    @property
+    def n_individuals(self) -> int:
+        """
+        Number of leaf components (i.e., individual curves to plot).
+        """
+        # If items define __len__ as num_leaves you can use that;
+        # but components() is the most explicit/robust.
+        return sum(1 for _ in self._iter_leaves())
+
+    def flatten(self):
+        """
+        Return a flat list of leaf distributions (useful for plotting/storage).
+        """
+        return list(self._iter_leaves())
+    
+
+    @add_fig_kwargs
+    def plot(self, angle_range, angle_resolution, kinetic_energy=None,
+             hnuminphi=None, matrix_element=None, matrix_args=None, ax=None,
+             **kwargs):
+        r"""
+        """
+        if angle_resolution < 0:
+            raise ValueError('Distributions cannot be plotted with negative '
+                            + 'resolution.')
 
-class distribution:
+        from scipy.ndimage import gaussian_filter
+
+        ax, fig, plt = get_ax_fig_plt(ax=ax)
+
+        ax.set_xlabel('Angle ($\degree$)')
+        ax.set_ylabel('Counts (-)')
+
+
+        extend, step, numb = extend_function(angle_range, angle_resolution)
+
+        total_result = np.zeros(np.shape(extend))
+
+        for dist in self.distributions:
+            if dist.class_name == 'SpectralQuadratic':
+                if (dist.center_angle is not None) and (kinetic_energy is
+                    None or hnuminphi is None):
+                    raise ValueError('Spectral quadratic function is '
+                    'defined in terms of a center angle. Please provide '
+                    'a kinetic energy and hnuminphi.')
+                extended_result = dist.evaluate(extend,
+                                            kinetic_energy, hnuminphi)
+            else:
+                extended_result = dist.evaluate(extend)
+
+            if matrix_element is not None:
+                extended_result *= matrix_element(extend, **matrix_args)
+
+            total_result += extended_result
+
+            individual_result = gaussian_filter(extended_result, sigma=step
+                                               )[numb:-numb if numb else None]
+            ax.plot(angle_range, individual_result, label=dist.label)
+
+        final_result = gaussian_filter(total_result, sigma=step
+                                               )[numb:-numb if numb else None]
+
+        ax.plot(angle_range, final_result, label=str('Distribution sum'))
+
+        ax.legend()
+
+        return fig
+
+class Distribution:
     r"""Parent class for distributions. The class cannot be used on its own,
     but is used to instantiate unique and non-unique distributions.
 
@@ -19,17 +159,52 @@ class distribution:
 
     @property
     def name(self):
-        r"""Returns the name of the class instance.
-
-        Returns
-        -------
-        name : str
-            Non-unique name for instances, not to be modified after
-            instantiation.
+        r"""
         """
         return self._name
 
-class unique_distribution(distribution):
+    @property
+    def class_name(self):
+        r"""TBD
+        """
+        return self.__class__.__name__
+
+    @add_fig_kwargs
+    def plot(self, angle_range, angle_resolution, kinetic_energy=None,
+             hnuminphi=None, matrix_element=None, matrix_args=None,
+             ax=None, **kwargs):
+        r"""Overwritten for FermiDirac distribution.
+        """
+        if angle_resolution < 0:
+            raise ValueError('Distribution cannot be plotted with negative '
+                            + 'resolution.')
+        from scipy.ndimage import gaussian_filter
+
+        ax, fig, plt = get_ax_fig_plt(ax=ax)
+
+        ax.set_xlabel('Angle ($\degree$)')
+        ax.set_ylabel('Counts (-)')
+
+        extend, step, numb = extend_function(angle_range, angle_resolution)
+
+        if self.class_name == 'SpectralQuadratic':
+            extended_result = self.evaluate(extend, kinetic_energy, hnuminphi)
+        else:
+            extended_result = self.evaluate(extend)
+
+        if matrix_element is not None:
+            extended_result *= matrix_element(extend, **matrix_args)
+
+        final_result = gaussian_filter(extended_result, sigma=step)\
+        [numb:-numb if numb else None]
+
+        ax.plot(angle_range, final_result, label=self.label)
+
+        ax.legend()
+
+        return fig
+
+class UniqueDistribution(Distribution):
     r"""Parent class for unique distributions, to be used one at a time, e.g.,
     during the background of an MDC fit or the Fermi-Dirac distribution.
 
@@ -55,105 +230,10 @@ class unique_distribution(distribution):
         """
         return self._label
 
-class constant(unique_distribution):
-    r"""Child class for constant distributions, used e.g., during MDC fitting.
-    The constant class is unique, only one instance should be used per task.
-
-    Parameters
-    ----------
-    offset : float
-        The value of the distribution for the abscissa equal to 0.
-    """
-    def __init__(self, offset, name='constant'):
-        super().__init__(name)
-        self._offset = offset
-
-    @property
-    def offset(self):
-        r"""Returns the offset of the constant distribution.
-
-        Returns
-        -------
-        offset : float
-            The value of the distribution for the abscissa equal to 0.
-        """
-        return self._offset
-
-    @offset.setter
-    def set_offset(self, x):
-        r"""Sets the offset of the constant distribution.
-
-        Parameters
-        ----------
-        offset : float
-            The value of the distribution for the abscissa equal to 0.
-        """
-        self._offset = x
-
-class linear(unique_distribution):
-    r"""Child cass for for linear distributions, used e.g., during MDC fitting.
-    The constant class is unique, only one instance should be used per task.
-
-    Parameters
-    ----------
-    offset : float
-        The value of the distribution for the abscissa equal to 0.
-    slope : float
-        The linear slope of the distribution w.r.t. the abscissa.
-    """
-    def __init__(self, slope, offset, name='linear'):
-        super().__init__(name)
-        self._offset = offset
-        self._slope = slope
-
-    @property
-    def offset(self):
-        r"""Returns the offset of the linear distribution.
-
-        Returns
-        -------
-        offset : float
-            The value of the distribution for the abscissa equal to 0.
-        """
-        return self._offset
-
-    @offset.setter
-    def set_offset(self, x):
-        r"""Sets the offset of the linear distribution.
-
-        Parameters
-        ----------
-        offset : float
-            The value of the distribution for the abscissa equal to 0.
-        """
-        self._offset = x
-
-    @property
-    def slope(self):
-        r"""Returns the slope of the linear distribution.
-
-        Returns
-        -------
-        slope : float
-            The linear slope of the distribution w.r.t. the abscissa.
-        """
-        return self._slope
-
-    @slope.setter
-    def set_slope(self, x):
-        r"""Sets the slope of the linear distribution.
-
-        Parameters
-        ----------
-        slope : float
-            The linear slope of the distribution w.r.t. the abscissa.
-        """
-        self._slope = x
-
-class fermi_dirac(unique_distribution):
-    r"""Child class for Fermi-Dirac (FD) distributions, used e.g., during Fermi
-    edge fitting. The FD class is unique, only one instance should be used
-    per task.
+class FermiDirac(UniqueDistribution):
+    r"""Child class for Fermi-Dirac (FD) distributions, used e.g., during 
+    Fermi-edge fitting. The FD class is unique, only one instance should be
+    used per task.
 
     The Fermi-Dirac distribution is described by the following formula:
 
@@ -177,7 +257,7 @@ class fermi_dirac(unique_distribution):
         Integrated weight on top of the background [counts]
     """
     def __init__(self, temperature, hnuminphi, background=0,
-                 integrated_weight=1, name='fermi_dirac'):
+                 integrated_weight=1, name='FermiDirac'):
         super().__init__(name)
         self.temperature = temperature
         self.hnuminphi = hnuminphi
@@ -196,7 +276,7 @@ class fermi_dirac(unique_distribution):
             return self._temperature
 
         @temperature.setter
-        def set_temperature(self, x):
+        def temperature(self, x):
             r"""Sets the temperature of the FD distribution.
 
             Parameters
@@ -219,7 +299,7 @@ class fermi_dirac(unique_distribution):
             return self._hnuminphi
 
         @hnuminphi.setter
-        def set_hnuminphi(self, x):
+        def hnuminphi(self, x):
             r"""Sets the photon energy minus the work function of the FD
             distribution.
 
@@ -242,7 +322,7 @@ class fermi_dirac(unique_distribution):
             return self._background
 
         @background.setter
-        def set_background(self, x):
+        def background(self, x):
             r"""Sets the background intensity of the FD distribution.
 
             Parameters
@@ -264,7 +344,7 @@ class fermi_dirac(unique_distribution):
             return self._integrated_weight
 
         @integrated_weight.setter
-        def set_integrated_weight(self, x):
+        def integrated_weight(self, x):
             r"""Sets the integrated weight of the FD distribution.
 
             Parameters
@@ -275,7 +355,7 @@ class fermi_dirac(unique_distribution):
             self._integrated_weight = x
 
     def __call__(self, energy_range, hnuminphi, background, integrated_weight,
-                 energy_resolution):
+                 temperature):
         """Call method to directly evaluate a FD distribution without having to
         instantiate a class instance.
 
@@ -297,23 +377,10 @@ class fermi_dirac(unique_distribution):
         evalf : ndarray
             1D array of the energy-convolved FD distribution [counts]
         """
-        from scipy.ndimage import gaussian_filter
+        k_BT = temperature * k_B
 
-        sigma_extend = 5 # Extend data range by "5 sigma"
-        # Conversion from FWHM to standard deviation [-]
-        fwhm_to_std = np.sqrt(8 * np.log(2))
-        k_B = 8.617e-5 # Boltzmann constant [eV/K]
-        k_BT = self.temperature * k_B
-        step_size = np.abs(energy_range[1] - energy_range[0])
-        estep = energy_resolution / (step_size * fwhm_to_std)
-        enumb = int(sigma_extend * estep)
-        extend = np.linspace(energy_range[0] - enumb * step_size,
-                             energy_range[-1] + enumb * step_size,
-                             len(energy_range) + 2 * enumb)
-        result = (integrated_weight / (1 + np.exp((extend - hnuminphi) / k_BT))
-            + background)
-        evalf = gaussian_filter(result, sigma=estep)[enumb:-enumb]
-        return evalf
+        return (integrated_weight / (1 + np.exp((energy_range - hnuminphi)
+               / k_BT)) + background)
 
     def evaluate(self, energy_range):
         r"""Evaluates the FD distribution for a given class instance.
@@ -329,47 +396,157 @@ class fermi_dirac(unique_distribution):
         evalf : ndarray
             1D array of the evaluated FD distribution [counts]
         """
-        k_B = 8.617e-5 # Boltzmann constant [eV/K]
         k_BT = self.temperature * k_B
-        evalf = (self.integrated_weight
+
+        return (self.integrated_weight
             / (1 + np.exp((energy_range - self.hnuminphi) / k_BT))
             + self.background)
-        return evalf
 
-    def convolve(self, energy_range, energy_resolution):
-        r"""Evaluates the FD distribution for a given class instance and
-        performs the energy convolution with the given resolution. The
-        convolution is performed with an expanded abscissa range of 5
-        times the standard deviation.
+    @add_fig_kwargs
+    def plot(self, energy_range, energy_resolution, ax=None, **kwargs):
+        r"""TBD
+        """
+        if energy_resolution < 0:
+            raise ValueError('Distribution cannot be plotted with negative '
+                            + 'resolution.')
+        from scipy.ndimage import gaussian_filter
+
+        ax, fig, plt = get_ax_fig_plt(ax=ax)
+
+        ax.set_xlabel(r'$E_{\mathrm{kin}}$ (-)')
+        ax.set_ylabel('Counts (-)')
+
+        extend, step, numb = extend_function(energy_range, \
+                                               energy_resolution)
+
+        extended_result = self.evaluate(extend)
+
+        final_result = gaussian_filter(extended_result, sigma=step)\
+        [numb:-numb if numb else None]
+
+        ax.plot(energy_range, final_result, label=self.label)
+
+        ax.legend()
+
+        return fig
+
+class Constant(UniqueDistribution):
+    r"""Child class for constant distributions, used e.g., during MDC fitting.
+    The constant class is unique, only one instance should be used per task.
+
+    Parameters
+    ----------
+    offset : float
+        The value of the distribution for the abscissa equal to 0.
+    """
+    def __init__(self, offset, name='Constant'):
+        super().__init__(name)
+        self.offset = offset
+
+    @property
+    def offset(self):
+        r"""Returns the offset of the constant distribution.
+
+        Returns
+        -------
+        offset : float
+            The value of the distribution for the abscissa equal to 0.
+        """
+        return self._offset
+
+    @offset.setter
+    def offset(self, x):
+        r"""Sets the offset of the constant distribution.
 
         Parameters
         ----------
-        energy_range : ndarray
-            1D array on which to evaluate and convolve FD distribution [eV]
-        energy_resolution : float
-            Energy resolution of the detector for the convolution [eV]
+        offset : float
+            The value of the distribution for the abscissa equal to 0.
+        """
+        self._offset = x
+
+    def __call__(self, angle_range, offset):
+        r"""TBD
+        """
+        return np.full(np.shape(angle_range), offset)
+
+    def evaluate(self, angle_range):
+        r"""TBD
+        """
+        return np.full(np.shape(angle_range), self.offset)
+
+class Linear(UniqueDistribution):
+    r"""Child cass for for linear distributions, used e.g., during MDC 
+    fitting. The linear class is unique, only one instance should be used per 
+    task.
+
+    Parameters
+    ----------
+    offset : float
+        The value of the distribution for the abscissa equal to 0.
+    slope : float
+        The linear slope of the distribution w.r.t. the abscissa.
+    """
+    def __init__(self, slope, offset, name='Linear'):
+        super().__init__(name)
+        self.offset = offset
+        self.slope = slope
+
+    @property
+    def offset(self):
+        r"""Returns the offset of the linear distribution.
 
         Returns
         -------
-        evalf : ndarray
-            1D array of the energy-convolved FD distribution [counts]
+        offset : float
+            The value of the distribution for the abscissa equal to 0.
         """
-        from scipy.ndimage import gaussian_filter
+        return self._offset
+
+    @offset.setter
+    def offset(self, x):
+        r"""Sets the offset of the linear distribution.
+
+        Parameters
+        ----------
+        offset : float
+            The value of the distribution for the abscissa equal to 0.
+        """
+        self._offset = x
+
+    @property
+    def slope(self):
+        r"""Returns the slope of the linear distribution.
+
+        Returns
+        -------
+        slope : float
+            The linear slope of the distribution w.r.t. the abscissa.
+        """
+        return self._slope
+
+    @slope.setter
+    def slope(self, x):
+        r"""Sets the slope of the linear distribution.
 
-        sigma_extend = 5 # Extend data range by "5 sigma"
-        # Conversion from FWHM to standard deviation [-]
-        fwhm_to_std = np.sqrt(8 * np.log(2))
-        step_size = np.abs(energy_range[1] - energy_range[0])
-        estep = energy_resolution / (step_size * fwhm_to_std)
-        enumb = int(sigma_extend * estep)
-        extend = np.linspace(energy_range[0] - enumb * step_size,
-                             energy_range[-1] + enumb * step_size,
-                             len(energy_range) + 2 * enumb)
-        evalf = gaussian_filter(self.evaluate(extend),
-                                sigma=estep)[enumb:-enumb]
-        return evalf
-
-class non_unique_distribution(distribution):
+        Parameters
+        ----------
+        slope : float
+            The linear slope of the distribution w.r.t. the abscissa.
+        """
+        self._slope = x
+
+    def __call__(self, angle_range, offset, slope):
+        r"""For a linear slope, convolution changes something.
+        """
+        return offset + slope * angle_range
+
+    def evaluate(self, angle_range):
+        r"""No energy convolution is performed with evaluate.
+        """
+        return self.offset + self.slope * angle_range
+
+class NonUniqueDistribution(Distribution):
     r"""Parent class for unique distributions, to be used one at a time, e.g.,
     during the background of an MDC fit or the Fermi-Dirac distribution.
 
@@ -381,7 +558,8 @@ class non_unique_distribution(distribution):
     """
     def __init__(self, name, index):
         super().__init__(name)
-        self._label = name + index
+        self._label = name + '_' + index
+        self._index = index
 
     @property
     def label(self):
@@ -390,26 +568,32 @@ class non_unique_distribution(distribution):
         Returns
         -------
         label : str
-            Unique label for instances, identical to the name for unique
-            distributions. Not to be modified after instantiation.
+            Unique label for instances, consisting of the label and the index
+            for non-unique distributions. Not to be modified after
+            instantiation.
         """
         return self._label
 
-class dispersion(distribution):
-    r"""Dispersions are assumed to be unique, so they need an index.
-    """
-    def __init__(self, amplitude, center, broadening, name, index):
-        super().__init__(name)
-        self._amplitude = amplitude
-        self._center = center
-        self._broadening = broadening
-        self._label = name + index
-
     @property
-    def label(self):
-        r"""
+    def index(self):
+        r"""Returns the unique class index.
+
+        Returns
+        -------
+        index : str
+            Unique index for instances. Not to be modified after 
+            instantiation.
         """
-        return self._label
+        return self._index
+
+class Dispersion(NonUniqueDistribution):
+    r"""Dispersions are assumed to be unique, so they need an index.
+    """
+    def __init__(self, amplitude, peak, broadening, name, index):
+        super().__init__(name, index)
+        self.amplitude = amplitude
+        self.peak = peak
+        self.broadening = broadening
 
     @property
     def amplitude(self):
@@ -418,22 +602,22 @@ class dispersion(distribution):
         return self._amplitude
 
     @amplitude.setter
-    def set_amplitude(self, x):
+    def amplitude(self, x):
         r"""
         """
         self._amplitude = x
 
     @property
-    def center(self):
+    def peak(self):
         r"""
         """
-        return self._center
+        return self._peak
 
-    @amplitude.setter
-    def set_center(self, x):
+    @peak.setter
+    def peak(self, x):
         r"""
         """
-        self._center = x
+        self._peak = x
 
     @property
     def broadening(self):
@@ -442,56 +626,141 @@ class dispersion(distribution):
         return self._broadening
 
     @broadening.setter
-    def set_broadening(self, x):
+    def broadening(self, x):
         r"""
         """
         self._broadening = x
 
-# class spectral_linear(dispersion):
-#     r"""Class for the linear dispersion spectral function"""
-#     def __init__(self, amplitude, center, broadening, name, index):
-#         super().__init__(amplitude=amplitude, center=center,
-#                          broadening=broadening, name=name, index=index)
-
-#     def result(self, x):
-#         r"""
-#         """
-#         dtor = np.pi/180
-#         evalf = self.amplitude / np.pi * self.broadening / ((np.sin(x*dtor)
-#               - np.sin(self.center*dtor))**2 + self.broadening**2)
-#         return evalf
-
-# class spectral_linear(dispersion):
-#     r"""Class for the linear dispersion spectral function"""
-#     def __init__(self, amplitude, center, broadening, bottom, side, name,
-#                  index):
-#         super()__init__(amplitude=amplitude, center=center,
-#                          broadening=broadening, name=name, index=index)
-#         self._bottom = bottom
-#         self._side = side
-
-#     @property
-#     def bottom(self):
-#         r"""
-#         """
-#         return self._bottom
-
-#     @bottom.setter
-#     def set_bottom(self, x):
-#         r"""
-#         """
-#         self._bottom = x
-
-#     @property
-#     def side(self):
-#         r"""
-#         """
-#         return self._side
-
-#     def result(self, x):
-#         r"""
-#         """
-#         dtor = np.pi/180
-#         evalf = self.amplitude / np.pi * self.broadening / (((np.sin(x*dtor)
-#               - np.sin(self.bottom*dtor))**2 - np.sin(self.center*dtor)**2)**2
-#               + self.broadening**2)
+class SpectralLinear(Dispersion):
+    r"""Class for the linear dispersion spectral function"""
+    def __init__(self, amplitude, peak, broadening, name, index):
+        super().__init__(amplitude=amplitude, peak=peak,
+                         broadening=broadening, name=name, index=index)
+
+    def __call__(self, angle_range, amplitude, broadening,
+                peak):
+        r"""
+        """
+        result = amplitude / np.pi * broadening / ((np.sin(angle_range * dtor)
+                            - np.sin(peak * dtor)) ** 2 + broadening ** 2)
+        return result
+
+    def evaluate(self, angle_range):
+        r"""
+        """
+        return self.amplitude / np.pi * self.broadening / ((np.sin(
+        angle_range * dtor) - np.sin(self.peak * dtor)) ** 2 +
+        self.broadening ** 2)
+
+    
+class SpectralQuadratic(Dispersion):
+    r"""Class for the quadratic dispersion spectral function"""
+    def __init__(self, amplitude, peak, broadening, name, index,
+                 center_wavevector=None, center_angle=None):
+        self.check_center_coordinates(center_wavevector, center_angle)
+        super().__init__(amplitude=amplitude, peak=peak,
+                         broadening=broadening, name=name, index=index)
+        self.center_wavevector = center_wavevector
+        self.center_angle = center_angle
+
+    @property
+    def center_angle(self):
+        r"""TBD
+        """
+        return self._center_angle
+
+    @center_angle.setter
+    def center_angle(self, x):
+        r"""TBD
+        """
+        self._center_angle = x
+
+    @property
+    def center_wavevector(self):
+        r"""TBD
+        """
+        return self._center_wavevector
+
+    @center_wavevector.setter
+    def center_wavevector(self, x):
+        r"""TBD
+        """
+        self._center_wavevector = x
+
+    def check_center_coordinates(self, center_wavevector, center_angle):
+        r"""TBD
+        """
+        if (center_wavevector is None and center_angle is None) \
+        or (center_wavevector is not None and center_angle is not None):
+            raise ValueError('Please specify exactly one of '
+                             'center_wavevector and center_angle.')
+
+    def check_binding_angle(self, binding_angle):
+        r"""TBD
+        """
+        if np.isnan(binding_angle):
+            raise ValueError('The provided wavevector cannot be reached '
+                             'with the available range of kinetic '
+                             'energies. Please check again.')
+
+    def __call__(self, angle_range, amplitude, broadening,
+                peak, kinetic_energy, hnuminphi, center_wavevector=None,
+                 center_angle=None):
+        r"""TBD
+        """
+        self.check_center_coordinates(center_wavevector, center_angle)
+
+        if center_wavevector is not None:
+            binding_angle = np.arcsin(np.sqrt(pref / kinetic_energy)
+                                      * center_wavevector) / dtor
+            self.check_binding_angle(binding_angle)
+        elif center_angle is not None:
+            binding_angle = self.center_angle * np.sqrt(hnuminphi /
+                                                      kinetic_energy)
+
+        return amplitude / np.pi * broadening / (((np.sin(angle_range * dtor)
+             - np.sin(binding_angle * dtor)) ** 2 - np.sin(peak * dtor) ** 2)
+             ** 2 + broadening ** 2)
+
+    def evaluate(self, angle_range, kinetic_energy, hnuminphi):
+        r"""TBD
+        """
+        if self.center_wavevector is not None:
+            binding_angle = np.arcsin(np.sqrt(pref / kinetic_energy)
+                                      * self.center_wavevector) / dtor
+            self.check_binding_angle(binding_angle)
+        elif self.center_angle is not None:
+            binding_angle = self.center_angle * np.sqrt(hnuminphi /
+                                                      kinetic_energy)
+
+        return self.amplitude / np.pi * self.broadening / (((np.sin(
+            angle_range * dtor) - np.sin(binding_angle * dtor)) ** 2 - np.sin(
+            self.peak * dtor) ** 2) ** 2 + self.broadening ** 2)
+
+    @add_fig_kwargs
+    def plot(self, angle_range, angle_resolution, kinetic_energy, hnuminphi,
+             matrix_element=None, matrix_args=None, ax=None, **kwargs):
+        r"""Overwrites generic class plotting method.
+        """
+        from scipy.ndimage import gaussian_filter
+
+        ax, fig, plt = get_ax_fig_plt(ax=ax)
+
+        ax.set_xlabel('Angle ($\degree$)')
+        ax.set_ylabel('Counts (-)')
+
+        extend, step, numb = extend_function(angle_range, angle_resolution)
+
+        extended_result = self.evaluate(extend, kinetic_energy, hnuminphi)
+
+        if matrix_element is not None:
+            extended_result *= matrix_element(extend, **matrix_args)
+
+        final_result = gaussian_filter(extended_result, sigma=step)[
+        numb:-numb if numb else None]
+
+        ax.plot(angle_range, final_result, label=self.label)
+
+        ax.legend()
+
+        return fig