modusa 0.2.22__py3-none-any.whl → 0.3__py3-none-any.whl

modusa/signals/time_domain_signal.py

@@ -1,309 +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
-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-0.2.22.dist-info/RECORD

@@ -1,47 +0,0 @@
-modusa-0.2.22.dist-info/METADATA,sha256=0tgrUqyQsTextWxCHxNmuorCKRv96CZZ72OuCf3SOXg,1505
-modusa-0.2.22.dist-info/WHEEL,sha256=9P2ygRxDrTJz3gsagc0Z96ukrxjr-LFBGOgv3AuKlCA,90
-modusa-0.2.22.dist-info/entry_points.txt,sha256=fmKpleVXj6CdaBVL14WoEy6xx7JQCs85jvzwTi3lePM,73
-modusa-0.2.22.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=o_tAFZaGVm62z59Yinzf2z6Gp_lujRoSWk1GHCaeOlI,4903
-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=DvjQUjja9s3nrAHM7H_3z5DVC0nha0Az2D1025q5upk,15750
-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.22.dist-info/RECORD,,