phasorpy 0.6__cp313-cp313-win_amd64.whl → 0.8__cp313-cp313-win_amd64.whl

phasorpy/plot/_functions.py

@@ -66,10 +66,15 @@ def plot_phasor(
     show : bool, optional, default: True
         Display figure.
     **kwargs
-        Additional parguments passed to :py:class:`PhasorPlot`,
+        Optional arguments passed to :py:class:`PhasorPlot`,
         :py:meth:`PhasorPlot.plot`, :py:meth:`PhasorPlot.hist2d`, or
         :py:meth:`PhasorPlot.contour` depending on `style`.
 
+    Raises
+    ------
+    ValueError
+        If style is not one of 'plot', 'hist2d', or 'contour'.
+
     See Also
     --------
     phasorpy.plot.PhasorPlot
@@ -87,6 +92,7 @@ def plot_phasor(
         'xticks',
         'yticks',
         'grid',
+        'pad',
     )
 
     real = numpy.asanyarray(real)
@@ -153,7 +159,7 @@ def plot_phasor_image(
     show : bool, optional, default: True
         Display figure.
     **kwargs
-        Additional arguments passed to :func:`matplotlib.pyplot.imshow`.
+        Optional arguments passed to :func:`matplotlib.pyplot.imshow`.
 
     Raises
     ------
@@ -321,7 +327,7 @@ def plot_signal_image(
     show : bool, optional, default: True
         Display figure.
     **kwargs
-        Additional arguments passed to :func:`matplotlib.pyplot.imshow`.
+        Optional arguments passed to :func:`matplotlib.pyplot.imshow`.
 
     Raises
     ------
@@ -426,7 +432,7 @@ def plot_image(
     show : bool, optional, default: True
         Display figure.
     **kwargs
-        Additional arguments passed to :func:`matplotlib.pyplot.imshow`.
+        Optional arguments passed to :func:`matplotlib.pyplot.imshow`.
 
     Raises
     ------
@@ -572,7 +578,7 @@ def plot_polar_frequency(
     show : bool, optional, default: True
         Display figure.
     **kwargs
-        Additional arguments passed to :py:func:`matplotlib.pyplot.plot`.
+        Optional arguments passed to :py:func:`matplotlib.pyplot.plot`.
 
     """
     # TODO: make this customizable: labels, colors, ...
@@ -619,7 +625,7 @@ def plot_histograms(
 
     Parameters
     ----------
-    data: array_like
+    *data : array_like
         Data arrays to be plotted as histograms.
     title : str, optional
         Figure title.
@@ -632,7 +638,7 @@ def plot_histograms(
     show : bool, optional, default: True
         Display figure.
     **kwargs
-        Additional arguments passed to :func:`matplotlib.pyplot.hist`.
+        Optional arguments passed to :func:`matplotlib.pyplot.hist`.
 
     """
     ax = pyplot.subplots()[1]

phasorpy/plot/_lifetime_plots.py

@@ -17,16 +17,18 @@ from matplotlib.lines import Line2D
 from matplotlib.widgets import Slider
 
 from .._utils import update_kwargs
-from ..phasor import (
+from ..lifetime import (
     lifetime_to_frequency,
     lifetime_to_signal,
     phasor_from_lifetime,
+)
+from ..phasor import (
     phasor_to_polar,
     phasor_transform,
 )
 from ..plot._phasorplot import (
+    CircleTicks,
     PhasorPlot,
-    SemicircleTicks,
     _semicircle_ticks,
 )
 
@@ -60,7 +62,7 @@ class LifetimePlots:
         If True, add sliders to change frequency and lifetimes interactively.
         Default is False.
     **kwargs:
-        Additional arguments passed to matplotlib figure.
+        Optional arguments passed to matplotlib figure.
 
     """
 
@@ -91,7 +93,7 @@ class LifetimePlots:
     _modulation_lines: list[Line2D]
 
     _semicircle_line: Line2D
-    _semicircle_ticks: SemicircleTicks | None
+    _semicircle_ticks: CircleTicks | None
 
     _component_colors = (
         # 'tab:blue',  # main
@@ -167,7 +169,12 @@ class LifetimePlots:
         time_plot.set_xlabel('Time [ns]')
         time_plot.set_ylabel('Intensity [normalized]')
         lines = time_plot.plot(
-            times, signal, label='Signal', color='tab:blue', lw=2, zorder=10
+            times,
+            signal,
+            label='Signal',
+            color='tab:blue',
+            linewidth=2,
+            zorder=10,
         )
         self._signal_lines.append(lines[0])
         if num_components > 1:
@@ -177,7 +184,7 @@ class LifetimePlots:
                     component_signal[i],
                     label=f'Lifetime {i}',
                     color=self._component_colors[i],
-                    lw=0.8,
+                    linewidth=0.8,
                     alpha=0.5,
                 )
                 self._signal_lines.append(lines[0])
@@ -186,7 +193,7 @@ class LifetimePlots:
             irf,
             label='Instrument response',
             color='tab:grey',
-            lw=0.8,
+            linewidth=0.8,
             alpha=0.5,
         )
         self._signal_lines.append(lines[0])
@@ -204,11 +211,11 @@ class LifetimePlots:
         if num_components > 1:
             for i in range(num_components):
                 lines = phasorplot.plot(
-                    [real, component_real[i]],
-                    [imag, component_imag[i]],
+                    (real, component_real[i]),
+                    (imag, component_imag[i]),
                     color=self._component_colors[i],
-                    ls='-',
-                    lw=0.8,
+                    linestyle='-',
+                    linewidth=0.8,
                     alpha=0.5,
                 )
                 self._phasor_lines.append(lines[0])
@@ -225,14 +232,14 @@ class LifetimePlots:
         phase_plot.set_xscale('log', base=10)
         phase_plot.set_xlabel('Frequency (MHz)')
         phase_plot.set_ylabel('Phase (°)', color='tab:blue')
-        phase_plot.set_yticks([0.0, 30.0, 60.0, 90.0])
-        phase_plot.plot([1, 1], [0.0, 90.0], alpha=0.0)  # set autoscale
+        phase_plot.set_yticks((0.0, 30.0, 60.0, 90.0))
+        phase_plot.plot((1, 1), (0.0, 90.0), alpha=0.0)  # set autoscale
         lines = phase_plot.plot(
-            [frequency, frequency],
-            [0, 90],
+            (frequency, frequency),
+            (0, 90),
             '--',
             color='gray',
-            lw=0.8,
+            linewidth=0.8,
             alpha=0.5,
         )
         self._frequency_line = lines[0]
@@ -241,7 +248,7 @@ class LifetimePlots:
         )
         self._phase_point = lines[0]
         lines = phase_plot.plot(
-            self._frequencies, phase_, color='tab:blue', lw=2, zorder=2
+            self._frequencies, phase_, color='tab:blue', linewidth=2, zorder=2
         )
         self._phase_lines.append(lines[0])
         if num_components > 1:
@@ -250,7 +257,7 @@ class LifetimePlots:
                     self._frequencies,
                     component_phase_[i],
                     color=self._component_colors[i],
-                    lw=0.5,
+                    linewidth=0.5,
                     alpha=0.5,
                 )
                 self._phase_lines.append(lines[0])
@@ -260,14 +267,18 @@ class LifetimePlots:
         # twinx modulation_plot is always plotted on top of phase_plot
         modulation_plot = phase_plot.twinx()
         modulation_plot.set_ylabel('Modulation (%)', color='tab:red')
-        modulation_plot.set_yticks([0.0, 25.0, 50.0, 75.0, 100.0])
-        modulation_plot.plot([1, 1], [0.0, 100.0], alpha=0.0)  # set autoscale
+        modulation_plot.set_yticks((0.0, 25.0, 50.0, 75.0, 100.0))
+        modulation_plot.plot((1, 1), (0.0, 100.0), alpha=0.0)  # set autoscale
         lines = modulation_plot.plot(
             frequency, modulation, 'o', color='tab:red', markersize=8, zorder=2
         )
         self._modulation_point = lines[0]
         lines = modulation_plot.plot(
-            self._frequencies, modulation_, color='tab:red', lw=2, zorder=2
+            self._frequencies,
+            modulation_,
+            color='tab:red',
+            linewidth=2,
+            zorder=2,
         )
         self._modulation_lines.append(lines[0])
         if num_components > 1:
@@ -276,7 +287,7 @@ class LifetimePlots:
                     self._frequencies,
                     component_modulation_[i],
                     color=self._component_colors[i],
-                    lw=0.5,
+                    linewidth=0.5,
                     alpha=0.5,
                 )
                 self._modulation_lines.append(lines[0])
@@ -520,8 +531,7 @@ class LifetimePlots:
                     [real, component_real[i]], [imag, component_imag[i]]
                 )
                 self._phasor_points[i + 1].set_data(
-                    [component_real[i]],
-                    [component_imag[i]],
+                    [component_real[i]], [component_imag[i]]
                 )
 
         # frequency domain plot