modusa 0.1.0__py3-none-any.whl → 0.2.0__py3-none-any.whl

modusa/signals/time_domain_signal.py

@@ -0,0 +1,309 @@
+#!/usr/bin/env python3
+
+
+from modusa import excp
+from modusa.decorators import immutable_property, validate_args_type
+from modusa.signals.base import ModusaSignal
+from typing import Self, Any
+import numpy as np
+import matplotlib.pyplot as plt
+
+class TimeDomainSignal(ModusaSignal):
+	"""
+	Initialize a uniformly sampled 1D time-domain signal.
+	
+	This class is specifically designed to hold 1D signals that result
+	from slicing a 2D representation like a spectrogram. For example,
+	if you have a spectrogram `S` and you perform `S[10, :]`, the result
+	is a 1D signal over time, this class provides a clean and consistent
+	way to handle such slices.
+	
+	Parameters
+	----------
+	y : np.ndarray
+		The 1D signal values sampled uniformly over time.
+	sr : float
+		The sampling rate in Hz (samples per second).
+	t0 : float, optional
+		The starting time of the signal in seconds (default is 0.0).
+	title : str, optional
+		An optional title used for labeling or plotting purposes.
+	"""
+	
+	
+	#--------Meta Information----------
+	_name = "Time Domain Signal"
+	_description = ""
+	_author_name = "Ankit Anand"
+	_author_email = "ankit0.anand0@gmail.com"
+	_created_at = "2025-07-09"
+	#----------------------------------
+	
+	@validate_args_type()
+	def __init__(self, y: np.ndarray, sr: float, t0: float = 0.0, title: str | None = None):
+		super().__init__() # Instantiating `ModusaSignal` class
+	
+		self._y = y
+		self._sr = sr
+		self._t0 = t0
+		self.title = title or self._name # This title will be used as plot title by default
+	
+	
+	#----------------------
+	# Properties
+	#----------------------
+	
+	@immutable_property("Create a new object instead.")
+	def y(self) -> np.ndarray:
+		return self._y
+	
+	@immutable_property("Create a new object instead.")
+	def sr(self) -> np.ndarray:
+		return self._sr
+	
+	@immutable_property("Create a new object instead.")
+	def t0(self) -> np.ndarray:
+		""""""
+		return self._t0
+	
+	@immutable_property("Create a new object instead.")
+	def t(self) -> np.ndarray:
+		return self.t0 + np.arange(len(self._y)) / self.sr
+	
+	def __len__(self):
+		return len(self._y)
+	
+	#----------------------
+	# Tools
+	#----------------------
+	
+	def __getitem__(self, key: slice) -> Self:
+		sliced_y = self._y[key]
+		t0_new = self.t[key.start] if key.start is not None else self.t0
+		return TimeDomainSignal(y=sliced_y, sr=self.sr, t0=t0_new, title=self.title)
+		
+	@validate_args_type()
+	def plot(
+		self,
+		scale_y: tuple[float, float] | None = None,
+		ax: plt.Axes | None = None,
+		color: str = "b",
+		marker: str | None = None,
+		linestyle: str | None = None,
+		stem: bool | None = False,
+		legend_loc: str | None = None,
+		title: str | None = None,
+		ylabel: str | None = "Amplitude",
+		xlabel: str | None = "Time (sec)",
+		ylim: tuple[float, float] | None = None,
+		xlim: tuple[float, float] | None = None,
+		highlight: list[tuple[float, float]] | None = None,
+	) -> plt.Figure:
+		"""
+		Plot the time-domain signal.
+		
+		.. code-block:: python
+
+			signal.plot(color='g', marker='o', stem=True)
+		
+		Parameters
+		----------
+		scale_y : tuple[float, float], optional
+			Min-max values to scale the y-axis data.
+		ax : matplotlib.axes.Axes, optional
+			Axes to plot on; if None, creates a new figure.
+		color : str, default='b'
+			Line or stem color.
+		marker : str, optional
+			Marker style for each data point.
+		linestyle : str, optional
+			Line style to use if not using stem plot.
+		stem : bool, default=False
+			Whether to draw a stem plot instead of a line plot.
+		legend_loc : str, optional
+			If given, adds a legend at the specified location.
+		
+		Returns
+		-------
+		matplotlib.axes.Axes
+			The axes object containing the plot.
+		
+		Note
+		----
+		This is useful for visualizing 1D signals obtained from time slices of spectrograms.
+		"""
+		
+		from modusa.io import Plotter
+		
+		title = title or self.title
+		
+		fig: plt.Figure | None = Plotter.plot_signal(y=self.y, x=self.t, scale_y=scale_y, ax=ax, color=color, marker=marker, linestyle=linestyle, stem=stem, legend_loc=legend_loc, title=title, ylabel=ylabel, xlabel=xlabel, ylim=ylim, xlim=xlim, highlight=highlight)
+		
+		return fig
+	
+	#----------------------------
+	# Math ops
+	#----------------------------
+	
+	def __array__(self, dtype=None):
+		return np.asarray(self.y, dtype=dtype)
+	
+	def __add__(self, other):
+		other_data = other.y if isinstance(other, self.__class__) else other
+		result = np.add(self.y, other_data)
+		return self.__class__(y=result, sr=self.sr, t0=self.t0, title=self.title)
+	
+	def __radd__(self, other):
+		result = np.add(other, self.y)
+		return self.__class__(y=result, sr=self.sr, t0=self.t0, title=self.title)
+	
+	def __sub__(self, other):
+		other_data = other.y if isinstance(other, self.__class__) else other
+		result = np.subtract(self.y, other_data)
+		return self.__class__(y=result, sr=self.sr, t0=self.t0, title=self.title)
+	
+	def __rsub__(self, other):
+		result = np.subtract(other, self.y)
+		return self.__class__(y=result, sr=self.sr, t0=self.t0, title=self.title)
+	
+	def __mul__(self, other):
+		other_data = other.y if isinstance(other, self.__class__) else other
+		result = np.multiply(self.y, other_data)
+		return self.__class__(y=result, sr=self.sr, t0=self.t0, title=self.title)
+	
+	def __rmul__(self, other):
+		result = np.multiply(other, self.y)
+		return self.__class__(y=result, sr=self.sr, t0=self.t0, title=self.title)
+	
+	def __truediv__(self, other):
+		other_data = other.y if isinstance(other, self.__class__) else other
+		result = np.true_divide(self.y, other_data)
+		return self.__class__(y=result, sr=self.sr, t0=self.t0, title=self.title)
+	
+	def __rtruediv__(self, other):
+		result = np.true_divide(other, self.y)
+		return self.__class__(y=result, sr=self.sr, t0=self.t0, title=self.title)
+	
+	def __floordiv__(self, other):
+		other_data = other.y if isinstance(other, self.__class__) else other
+		result = np.floor_divide(self.y, other_data)
+		return self.__class__(y=result, sr=self.sr, t0=self.t0, title=self.title)
+	
+	def __rfloordiv__(self, other):
+		result = np.floor_divide(other, self.y)
+		return self.__class__(y=result, sr=self.sr, t0=self.t0, title=self.title)
+	
+	def __pow__(self, other):
+		other_data = other.y if isinstance(other, self.__class__) else other
+		result = np.power(self.y, other_data)
+		return self.__class__(y=result, sr=self.sr, t0=self.t0, title=self.title)
+	
+	def __rpow__(self, other):
+		result = np.power(other, self.y)
+		return self.__class__(y=result, sr=self.sr, t0=self.t0, title=self.title)
+	
+	def __abs__(self):
+		result = np.abs(self.y)
+		return self.__class__(y=result, sr=self.sr, t0=self.t0, title=self.title)
+	
+	
+	#--------------------------
+	# Other signal ops
+	#--------------------------
+	def sin(self) -> Self:
+		"""Compute the element-wise sine of the signal data."""
+		result = np.sin(self.y)
+		return self.__class__(y=result, sr=self.sr, t0=self.t0, title=self.title)
+	
+	def cos(self) -> Self:
+		"""Compute the element-wise cosine of the signal data."""
+		result = np.cos(self.y)
+		return self.__class__(y=result, sr=self.sr, t0=self.t0, title=self.title)
+	
+	def exp(self) -> Self:
+		"""Compute the element-wise exponential of the signal data."""
+		result = np.exp(self.y)
+		return self.__class__(y=result, sr=self.sr, t0=self.t0, title=self.title)
+	
+	def tanh(self) -> Self:
+		"""Compute the element-wise hyperbolic tangent of the signal data."""
+		result = np.tanh(self.y)
+		return self.__class__(y=result, sr=self.sr, t0=self.t0, title=self.title)
+	
+	def log(self) -> Self:
+		"""Compute the element-wise natural logarithm of the signal data."""
+		result = np.log(self.y)
+		return self.__class__(y=result, sr=self.sr, t0=self.t0, title=self.title)
+	
+	def log1p(self) -> Self:
+		"""Compute the element-wise natural logarithm of (1 + signal data)."""
+		result = np.log1p(self.y)
+		return self.__class__(y=result, sr=self.sr, t0=self.t0, title=self.title)
+	
+	def log10(self) -> Self:
+		"""Compute the element-wise base-10 logarithm of the signal data."""
+		result = np.log10(self.y)
+		return self.__class__(y=result, sr=self.sr, t0=self.t0, title=self.title)
+	
+	def log2(self) -> Self:
+		"""Compute the element-wise base-2 logarithm of the signal data."""
+		result = np.log2(self.y)
+		return self.__class__(y=result, sr=self.sr, t0=self.t0, title=self.title)
+	
+	
+	#--------------------------
+	# Aggregation signal ops
+	#--------------------------
+	def mean(self) -> float:
+		"""Compute the mean of the signal data."""
+		return float(np.mean(self.y))
+	
+	def std(self) -> float:
+		"""Compute the standard deviation of the signal data."""
+		return float(np.std(self.y))
+	
+	def min(self) -> float:
+		"""Compute the minimum value in the signal data."""
+		return float(np.min(self.y))
+	
+	def max(self) -> float:
+		"""Compute the maximum value in the signal data."""
+		return float(np.max(self.y))
+	
+	def sum(self) -> float:
+		"""Compute the sum of the signal data."""
+		return float(np.sum(self.y))
+	
+	#-----------------------------------
+	# Repr
+	#-----------------------------------
+	
+	def __str__(self):
+		cls = self.__class__.__name__
+		data = self.y
+		
+		arr_str = np.array2string(
+			data,
+			separator=", ",
+			threshold=50,       # limit number of elements shown
+			edgeitems=3,          # show first/last 3 rows and columns
+			max_line_width=120,   # avoid wrapping
+			formatter={'float_kind': lambda x: f"{x:.4g}"}
+		)
+		
+		return f"Signal({arr_str}, shape={data.shape}, kind={cls})"
+	
+	def __repr__(self):
+		cls = self.__class__.__name__
+		data = self.y
+		
+		arr_str = np.array2string(
+			data,
+			separator=", ",
+			threshold=50,       # limit number of elements shown
+			edgeitems=3,          # show first/last 3 rows and columns
+			max_line_width=120,   # avoid wrapping
+			formatter={'float_kind': lambda x: f"{x:.4g}"}
+		)
+		
+		return f"Signal({arr_str}, shape={data.shape}, kind={cls})"

modusa/utils/excp.py

@@ -43,6 +43,11 @@ class PluginInputError(MusaBaseError):
 class PluginOutputError(MusaBaseError):
 	pass
 	
+
+
+class SignalOpError(MusaBaseError):
+	pass
+	
 class AttributeNotFoundError(MusaBaseError):
 	pass
 	

{modusa-0.1.0.dist-info → modusa-0.2.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: modusa
-Version: 0.1.0
+Version: 0.2.0
 Summary: A modular signal analysis python library.
 Author-Email: Ankit Anand <ankit0.anand0@gmail.com>
 License: MIT
@@ -24,24 +24,29 @@ Requires-Dist: snakeviz>=2.2.2
 Requires-Dist: line-profiler>=4.2.0
 Requires-Dist: nbsphinx==0.9.7
 Requires-Dist: ghp-import>=2.1.0
+Requires-Dist: yt-dlp>=2025.6.30
+Requires-Dist: sphinx-book-theme>=1.1.4
+Requires-Dist: pydata-sphinx-theme>=0.15.4
+Requires-Dist: sphinx-material>=0.0.36
 Description-Content-Type: text/markdown
 
 # modusa
 
-**modusa**: **Mod**ular **U**nified **S**ignal **A**rchitecture* is a flexible, extensible Python framework for building, transforming, and analyzing different signal representations. It is a domain-agnostic core architecture for modern signal processing workflows.
+[**modusa**](https://meluron-toolbox.github.io/modusa/) is a modular framework for audio signal analysis and processing, designed to help audio researchers and developers build DSP chains with minimal code.
 
 ---
 
-## 🔧 Features
+## Core Components
 
 - ⚙️ **modusa Signals**
 - 🧩 **modusa Plugins**
 - 📊 **modusa Genetators**
-- ♻️ **modusa Engine**
+- 📥 **modusa I/O**
+- ♻️ **modusa Engines**
 
 ---
 
-## 🚀 Installation
+## Installation
 
 > modusa is under active development. You can install the latest version via:
 
@@ -53,7 +58,7 @@ pdm install
 
 ---
 
-## 🧪 Tests
+## Tests
 
 ```bash
 pytest tests/
@@ -61,26 +66,26 @@ pytest tests/
 
 ---
 
-## 🧊 Status
+## Status
 
 modusa is in **early alpha**. Expect rapid iteration, breaking changes, and big ideas.  
 If you like the direction, consider ⭐ starring the repo and opening issues or ideas.
 
 ---
 
-## 🧠 About
+## About
 
 **modusa** is developed and maintained by [meluron](https://www.github.com/meluron),
 
 ---
 
-## 📜 License
+## License
 
 MIT License. See `LICENSE` for details.
 
 ---
 
-## 🙌 Contributions
+## Contributions
 
 Pull requests, ideas, and discussions are welcome!  
 No matter which domain you are in, if you work with any signal, we'd love your input.

modusa-0.2.0.dist-info/RECORD

@@ -0,0 +1,47 @@
+modusa-0.2.0.dist-info/METADATA,sha256=bhV6z427mSpUjdrTjbKjyeVM8BI5IftcpGauCfTBxvE,2117
+modusa-0.2.0.dist-info/WHEEL,sha256=9P2ygRxDrTJz3gsagc0Z96ukrxjr-LFBGOgv3AuKlCA,90
+modusa-0.2.0.dist-info/entry_points.txt,sha256=fmKpleVXj6CdaBVL14WoEy6xx7JQCs85jvzwTi3lePM,73
+modusa-0.2.0.dist-info/licenses/LICENSE.md,sha256=JTaXAjx5awk76VArKCx5dUW8vmLEWsL_ZlR7-umaHbA,1078
+modusa/.DS_Store,sha256=Q0eG2RQNYtV4qa5BYj_GznvlEBpNdebi6ZTIR-a7AhU,6148
+modusa/__init__.py,sha256=bfQKVSpAXlKmKvMRIU6WSRQW2qoJsaZsdNJ8E69ghn0,37
+modusa/config.py,sha256=bTqK4t00FZqERVITrxW_q284aDDJAa9aMSfFknfR-oU,280
+modusa/decorators.py,sha256=kGadBm1UzAuWjc4tw9ycOkUm3xP6q-jebGo5yjk_Aqs,5909
+modusa/devtools/generate_template.py,sha256=1WTMIHvBoa42Ow3g2HvYKVNSBxLB6JLGXhs-7G7zi28,5225
+modusa/devtools/list_authors.py,sha256=FWBQKOLznVthvMYMASrx2Gw5lqKHEOccQpBisDZ53Dw,24
+modusa/devtools/list_plugins.py,sha256=g-R5hoaCzHfClY_Sfa788IQ9CAKzQGTfyqmthXDZQqw,1729
+modusa/devtools/main.py,sha256=Me7nkn-oaaxIVuj1aJ5dCq3CB8xODH6i2kqE_pAFmXQ,1836
+modusa/devtools/templates/engine.py,sha256=fmUhvgOpmNtJ5zbYDonyLVjRDzUnVCRzDWY6WeSeiVY,514
+modusa/devtools/templates/generator.py,sha256=tf2k2L9RF5S9iJmqPD5AFETJKvqL5XknqK3sR6n2ceQ,444
+modusa/devtools/templates/io.py,sha256=jcO4vAH8iiw6uvwy2aEbsBeNnQOj5VaU_VrQvhJflRA,383
+modusa/devtools/templates/plugin.py,sha256=HNoN0S63ahk83EPup_15pbfOY5_kFfnLF63U3vWOMp8,863
+modusa/devtools/templates/signal.py,sha256=Jqdq38W6ye2cf499oGXWlpCVH4Nmoo1jNfPYgdVLseA,775
+modusa/devtools/templates/test.py,sha256=OXEeIGW1D8g3a0jLyweNBpwfAQkkClhiIAEI6x0CooU,266
+modusa/engines/.DS_Store,sha256=1lFlJ5EFymdzGAUAaI30vcaaLHt3F1LwpG7xILf9jsM,6148
+modusa/engines/__init__.py,sha256=HtXuC9NWIo6faKTmbalxNvw2CTtiGrsPly7i08GlHVg,54
+modusa/engines/base.py,sha256=gHeGTbvcPhTxwUwt16OLpepMkbG40rv19vs8tN8xqgA,297
+modusa/generators/__init__.py,sha256=vcu5uk1hP637bmPTAiyb0LQ_vkFwgp4r-A1hAHR4zfo,110
+modusa/generators/audio_waveforms.py,sha256=qWg9TUVux8Abxmxa7EjCB_Pt88UFC6bJBqvYRWz8MTg,5868
+modusa/generators/base.py,sha256=QTb-8F19DmoCwLS7Mn9MdugOMZ_22suuTBFrmpyE7LM,934
+modusa/io/__init__.py,sha256=2Jg44klIAjbgLCn4faXXug_4nW-UiMsOH4Z3g0VGxWw,250
+modusa/io/audio_converter.py,sha256=CjsuvdjpHAuwJFjFNCHSzge-i07zW6U-cnb0EIYhMC0,1877
+modusa/io/audio_loader.py,sha256=G2q7wVDGtjWzZ_mlsu2uv5C4TnJynpuqMyBeVLDlw_o,4793
+modusa/io/audio_player.py,sha256=5BrYx1YyTYUybroJSNaZ5n7ABgKWeP4zBCLfhyQYPBE,1626
+modusa/io/base.py,sha256=GOMvpicWWLWXoxm4nLwqq_0hWmXWzYAPLVx-CbthCsQ,1291
+modusa/io/plotter.py,sha256=VViXHuIugAQDcTkSWjbrymrMrQOKVw97jqsd4-kWl_8,11920
+modusa/io/youtube_downloader.py,sha256=7Ah3JCHZTdL47v3m6KthYt80QOm40dDp2qAT2fChgFA,3444
+modusa/main.py,sha256=YeNg_GX3pzP4qNNU7CItCkWt5eOCHhnWLENFcQFlgfc,538
+modusa/plugins/__init__.py,sha256=OB-b_GnUnTkECn1fwxl844UBmiui3mSWIvhBqMZY7Tc,22
+modusa/plugins/base.py,sha256=Bh_1Bja7fOymFsCgwhXDbV6ys3D8muNrPwrfDrG_G_A,2382
+modusa/signals/__init__.py,sha256=TZujCd50gGnO-r27Tv6hrzNl8zBsMIMFwYCeIwszMjc,237
+modusa/signals/audio_signal.py,sha256=WzlMcxWGk3a9X2qkaQFjh3smoUJqkko_8C7WVtYOtnQ,15454
+modusa/signals/base.py,sha256=UdwOTlIHvXjpuCBwE-IcCQBL0F-wuhQpD6aOvI8FvXE,795
+modusa/signals/frequency_domain_signal.py,sha256=wS7MN6y56BDInNgtnkIB3XNsxDS_TNmewqS-A31MJmY,11192
+modusa/signals/signal_ops.py,sha256=tpbZs10NVkT4Y7nsIhqGEP4Y6T8JZ07PiKxF34fYu-I,4685
+modusa/signals/spectrogram.py,sha256=Rbt7AVHuRjRLjHXaoUtaT_uG-CCK6Tc9_P9apH2Oczk,14443
+modusa/signals/time_domain_signal.py,sha256=SOiBVhvsZcctYOGLLtnXXK5IT9wOTO-S4_K0DPWPr-Y,9751
+modusa/utils/.DS_Store,sha256=nLXMwF7QJNuglLI_Gk74F7vl5Dyus2Wd74Mgowijmdo,6148
+modusa/utils/__init__.py,sha256=1oLL20yLB1GL9IbFiZD8OReDqiCpFr-yetIR6x1cNkI,23
+modusa/utils/config.py,sha256=cuGbqbovx5WDQq5rw3hIKcv3CnE5NttjacSOWnP1yu4,576
+modusa/utils/excp.py,sha256=_NLfR1AKU4dOpK-OF0NaChYjaVBCcq1VmSd_dkOexi4,1235
+modusa/utils/logger.py,sha256=K0rsnObeNKCxlNeSnVnJeRhgfmob6riB2uyU7h3dDmA,571
+modusa-0.2.0.dist-info/RECORD,,

modusa/devtools/templates/signals.py

@@ -1,63 +0,0 @@
-#!/usr/bin/env python3
-
-
-from modusa import excp
-from modusa.decorators import immutable_property, validate_args_type
-from modusa.signals.base import ModusaSignal
-from typing import Self, Any
-import numpy as np
-
-class {class_name}(ModusaSignal):
-	"""
-
-	"""
-	
-	#--------Meta Information----------
-	name = ""
-	description = ""
-	author_name = "{author_name}"
-	author_email = "{author_email}"
-	created_at = "{date_created}"
-	#----------------------------------
-	
-	def __init__(self):
-		super().__init__() # Instantiating `ModusaSignal` class
-	
-	
-	def _with_data(self, new_data: np.ndarray) -> Self:
-		"""Subclasses must override this to return a copy with new data."""
-		raise NotImplementedError("Subclasses must implement _with_data")
-		
-	
-	#----------------------
-	# From methods
-	#----------------------
-	@classmethod
-	def from_array(cls) -> Self:
-		pass
-		
-	
-	#----------------------
-	# Setters
-	#----------------------
-	
-	
-	
-	
-	#----------------------
-	# Properties
-	#----------------------
-	@immutable_property("Create a new object instead.")
-	def data(self) -> np.ndarray:
-		""""""
-		pass
-	
-	#----------------------
-	# Plugins Access
-	#----------------------
-	def plot(self) -> Any:
-		"""
-		
-		"""
-		pass
-	

modusa/engines/plot_1dsignal.py

@@ -1,130 +0,0 @@
-#!/usr/bin/env python3
-
-
-from modusa import excp
-from modusa.decorators import validate_args_type
-from modusa.engines.base import ModusaEngine
-from typing import Any
-import numpy as np
-import matplotlib.pyplot as plt
-from matplotlib.patches import Rectangle
-
-
-class Plot1DSignalEngine(ModusaEngine):
-	"""
-
-	"""
-	
-	#--------Meta Information----------
-	name = "Plot 1D Signal"
-	description = ""
-	author_name = "Ankit Anand"
-	author_email = "ankit0.anand0@gmail.com"
-	created_at = "2025-07-02"
-	#----------------------------------
-	
-	def __init__(self):
-		super().__init__()
-	
-	
-	@validate_args_type()
-	def run(
-		self,
-		y: np.ndarray,
-		x: np.ndarray | None,
-		scale_y: tuple[float, float] | None,
-		scale_x: tuple[float, float] | None ,
-		ax: plt.Axes | None,
-		color: str,
-		marker: str | None,
-		linestyle: str | None,
-		stem: bool | None,
-		labels: tuple[str, str, str] | None,
-		legend_loc: str | None,
-		zoom: tuple | None,
-		highlight: list[tuple[float, float], ...] | None,
-	) -> plt.Figure | None:
-				
-		
-		# Validate the important args and get the signal that needs to be plotted
-		if y.ndim != 1:
-			raise excp.InputValueError(f"`y` must be of dimension 1 not {y.ndim}.")
-		if y.shape[0] < 1:
-			raise excp.InputValueError(f"`y` must not be empty.")
-			
-		if x is None:
-			x = np.arange(y.shape[0])
-		elif x.ndim != 1:
-			raise excp.InputValueError(f"`x` must be of dimension 1 not {x.ndim}.")
-		elif x.shape[0] < 1:
-			raise excp.InputValueError(f"`x` must not be empty.")
-		
-		if x.shape[0] != y.shape[0]:
-			raise excp.InputValueError(f"`y` and `x` must be of same shape")
-		
-		# Scale the signal if needed
-		if scale_y is not None:
-			if len(scale_y) != 2:
-				raise excp.InputValueError(f"`scale_y` must be tuple of two values (1, 2) => 1y+2")
-			a, b = scale_y
-			y = a * y + b
-		
-		if scale_x is not None:
-			if len(scale_x) != 2:
-				raise excp.InputValueError(f"`scale_x` must be tuple of two values (1, 2) => 1x+2")
-			a, b = scale_x
-			x = a * x + b
-			
-		# Create a figure
-		if ax is None:
-			fig, ax = plt.subplots(figsize=(15, 2))
-			created_fig = True
-		else:
-			fig = ax.get_figure()
-			created_fig = False 
-		
-		# Plot the signal with right configurations
-		plot_label = labels[0] if labels is not None and len(labels) > 0 else None
-		if stem:
-			ax.stem(x, y, linefmt=color, markerfmt='o', label=plot_label)
-		elif marker is not None:
-			ax.plot(x, y, c=color, linestyle=linestyle, lw=1.5, marker=marker, label=plot_label)
-		else:
-			ax.plot(x, y, c=color, linestyle=linestyle, lw=1.5, label=plot_label)
-			
-		# Add legend
-		if plot_label is not None:
-			legend_loc = "upper right" if legend_loc is None else legend_loc
-			ax.legend(loc=legend_loc)
-		
-		# Set the labels
-		if labels is not None:
-			if len(labels) > 0:
-				ax.set_title(labels[0])
-			if len(labels) > 1:
-				ax.set_ylabel(labels[1])
-			if len(labels) > 2:
-				ax.set_xlabel(labels[2])
-	
-		# Zoom into a region
-		if zoom is not None:
-			ax.set_xlim(zoom)
-		
-		# Highlight a list of regions
-		if highlight is not None:
-			for highlight_region in highlight:
-				if len(highlight_region) != 2:
-					raise excp.InputValueError(f"`highlight should be a list of tuple of 2 values (left, right) => (1, 10.5)")
-				l, r = highlight_region
-				ax.add_patch(Rectangle((l, np.min(y)), r - l, np.max(y) - np.min(y), color='red', alpha=0.2, zorder=10))
-		
-		# Show/Return the figure as per needed
-		if created_fig:
-			fig.tight_layout()
-			try:
-				get_ipython
-				plt.close(fig) # Without this, you will see two plots in the jupyter notebook
-				return fig
-			except NameError:
-				plt.show()
-				return fig