piel.visual.plot.signals.time.basic
===================================

.. py:module:: piel.visual.plot.signals.time.basic


Attributes
----------

.. autoapisummary::

   piel.visual.plot.signals.time.basic.logger


Functions
---------

.. autoapisummary::

   piel.visual.plot.signals.time.basic.plot_time_signal_data


Module Contents
---------------

.. py:data:: logger

.. py:function:: plot_time_signal_data(signal: piel.types.TimeSignalData, fig: Any = None, axs: Any = None, subplots_kwargs: dict = None, xlabel: str | piel.types.Unit = None, ylabel: str | piel.types.Unit = None, title: str | piel.types.Unit = None, **kwargs)

   Plots a single time signal on a figure.

   :param signal: The time signal to plot.
   :type signal: TimeSignalData
   :param fig: Existing figure to plot on. If None, a new figure is created.
   :type fig: matplotlib.figure.Figure, optional
   :param axs: Existing list of axes to plot on. If None, new axes are created. Plots on [0] by default.
   :type axs: list[matplotlib.axes.Axes, optional]
   :param subplots_kwargs: Keyword arguments to pass to create_axes_per_figure.
   :type subplots_kwargs: dict, optional
   :param xlabel: Label for the x-axis. If a Unit is provided, applies unit correction.
   :type xlabel: str | Unit, optional
   :param ylabel: Label for the y-axis. If a Unit is provided, applies unit correction.
   :type ylabel: str | Unit, optional
   :param title: Title for the plot.
   :type title: str | Unit, optional
   :param \*\*kwargs: Additional keyword arguments to pass to the save function.

   :returns: A tuple containing the figure and axes objects.
   :rtype: tuple