modusa 0.2.23__tar.gz → 0.3.1__tar.gz

{modusa-0.2.23 → modusa-0.3.1}/PKG-INFO

@@ -1,30 +1,20 @@
 Metadata-Version: 2.1
 Name: modusa
-Version: 0.2.23
+Version: 0.3.1
 Summary: A modular signal analysis python library.
 Author-Email: Ankit Anand <ankit0.anand0@gmail.com>
 License: MIT
-Requires-Python: >=3.12
+Requires-Python: >=3.10
 Requires-Dist: numpy>=2.2.6
 Requires-Dist: matplotlib>=3.10.3
 Requires-Dist: yt-dlp>=2025.6.30
-Requires-Dist: librosa==0.10.1
+Requires-Dist: librosa==0.11.0
 Requires-Dist: IPython>=8.0.0
 Description-Content-Type: text/markdown
 
 # modusa
 
-[**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.
-
----
-
-## Core Components
-
-- ⚙️ **modusa Signals**
-- 🧩 **modusa Plugins**
-- 📊 **modusa Genetators**
-- 📥 **modusa I/O**
-- ♻️ **modusa Engines**
+[**modusa**](https://meluron-toolbox.github.io/modusa/) is a library with utility tools especially for audio signals.
 
 ---
 
@@ -32,17 +22,15 @@ Description-Content-Type: text/markdown
 
 > modusa is under active development. You can install the latest version via:
 
-```bash
-git clone https://github.com/meluron/modusa.git
-cd modusa
-pdm install
+```
+pip install modusa
 ```
 
 ---
 
 ## Tests
 
-```bash
+```
 pytest tests/
 ```
 
@@ -55,6 +43,23 @@ If you like the direction, consider ⭐ starring the repo and opening issues or
 
 ---
 
+## Few useful command
+
+To push doc changes
+```
+ghp-import -n -p -f docs/build/html
+```
+
+To create a dist
+```
+pdm build
+```
+
+To upload on pypi
+```
+twine upload dist/*
+```
+
 ## About
 
 **modusa** is developed and maintained by [meluron](https://www.github.com/meluron),

{modusa-0.2.23 → modusa-0.3.1}/README.md

@@ -1,16 +1,6 @@
 # modusa
 
-[**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.
-
----
-
-## Core Components
-
-- ⚙️ **modusa Signals**
-- 🧩 **modusa Plugins**
-- 📊 **modusa Genetators**
-- 📥 **modusa I/O**
-- ♻️ **modusa Engines**
+[**modusa**](https://meluron-toolbox.github.io/modusa/) is a library with utility tools especially for audio signals.
 
 ---
 
@@ -18,17 +8,15 @@
 
 > modusa is under active development. You can install the latest version via:
 
-```bash
-git clone https://github.com/meluron/modusa.git
-cd modusa
-pdm install
+```
+pip install modusa
 ```
 
 ---
 
 ## Tests
 
-```bash
+```
 pytest tests/
 ```
 
@@ -41,6 +29,23 @@ If you like the direction, consider ⭐ starring the repo and opening issues or
 
 ---
 
+## Few useful command
+
+To push doc changes
+```
+ghp-import -n -p -f docs/build/html
+```
+
+To create a dist
+```
+pdm build
+```
+
+To upload on pypi
+```
+twine upload dist/*
+```
+
 ## About
 
 **modusa** is developed and maintained by [meluron](https://www.github.com/meluron),

{modusa-0.2.23 → modusa-0.3.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "modusa"
-version = "0.2.23"
+version = "0.3.1"
 description = "A modular signal analysis python library."
 authors = [
     { name = "Ankit Anand", email = "ankit0.anand0@gmail.com" },
@@ -9,10 +9,10 @@ dependencies = [
     "numpy>=2.2.6",
     "matplotlib>=3.10.3",
     "yt-dlp>=2025.6.30",
-    "librosa==0.10.1",
+    "librosa==0.11.0",
     "IPython>=8.0.0",
 ]
-requires-python = ">=3.12"
+requires-python = ">=3.10"
 readme = "README.md"
 
 [project.license]

modusa-0.3.1/src/modusa/__init__.py

@@ -0,0 +1,8 @@
+from modusa.utils import excp, config
+
+#=====Giving access to plot functions to plot multiple signals.=====
+from modusa.tools import plot1d, plot2d
+from modusa.tools import play, convert
+from modusa.tools import download
+from modusa.tools import load
+#=====

modusa-0.2.23/src/modusa/devtools/generate_doc_source.py → modusa-0.3.1/src/modusa/devtools/generate_docs_source.py

@@ -9,17 +9,17 @@ from collections import defaultdict
 # === Configuration ===
 BASE_MODULES = [
     'modusa.tools',
-    'modusa.signals',
+    'modusa.models',
     'modusa.generators',
     'modusa.plugins',
-    'modusa.io'
+#   'modusa.io'
 ]
 OUTPUT_DIRS = [
     Path('docs/source/tools'),
-    Path('docs/source/signals'),
+    Path('docs/source/models'),
     Path('docs/source/generators'),
     Path('docs/source/plugins'),
-    Path('docs/source/io')
+#   Path('docs/source/io')
 ]
 
 # Ensure output directories exist
@@ -81,7 +81,7 @@ def write_index_rst_file(tools_by_module, output_dir, section_name="Tools"):
             f.write(f"   {name}\n")
 
 # === Main Script ===
-def generate_doc_source():
+def generate_docs_source():
     for base_module, output_dir in zip(BASE_MODULES, OUTPUT_DIRS):
         module_class_map = get_classes_grouped_by_module(base_module)
     

{modusa-0.2.23 → modusa-0.3.1}/src/modusa/devtools/generate_template.py

@@ -28,11 +28,11 @@ GENERATOR_INFO = {
 	"template_dump_dp": SRC_CODE_DIR / "generators",
 	"test_template_dump_dp": TESTS_DIR / "test_generators"
 }
-SIGNAL_INFO = {
-	"template_fp": TEMPLATES_DIR / "signal.py",
+MODEL_INFO = {
+	"template_fp": TEMPLATES_DIR / "model.py",
 	"test_template_fp": TEMPLATES_DIR / "test.py",
-	"template_dump_dp": SRC_CODE_DIR / "signals",
-	"test_template_dump_dp": TESTS_DIR / "test_signals"
+	"template_dump_dp": SRC_CODE_DIR / "models",
+	"test_template_dump_dp": TESTS_DIR / "test_models"
 }
 TOOL_INFO = {
 	"template_fp": TEMPLATES_DIR / "tool.py",
@@ -53,7 +53,7 @@ class TemplateGenerator():
 	def get_path_info(for_what: str):
 		if for_what == "plugin": return PLUGIN_INFO
 		if for_what == "io": return IO_INFO
-		if for_what == "signal": return SIGNAL_INFO
+		if for_what == "model": return MODEL_INFO
 		if for_what == "tool": return TOOL_INFO
 		if for_what == "generator": return GENERATOR_INFO
 	

{modusa-0.2.23 → modusa-0.3.1}/src/modusa/devtools/main.py

@@ -2,7 +2,7 @@
 
 
 from .generate_template import TemplateGenerator
-from .generate_doc_source import generate_doc_source
+from .generate_docs_source import generate_docs_source
 from .list_plugins import list_plugins
 from . import list_authors
 
@@ -23,10 +23,10 @@ def main():
 		
 		create_subparsers.add_parser("tool", help="Create a new tool class").set_defaults(func=lambda:TemplateGenerator.create_template("tool"))
 		create_subparsers.add_parser("plugin", help="Create a new plugin class").set_defaults(func=lambda:TemplateGenerator.create_template("plugin"))
-		create_subparsers.add_parser("signal", help="Create a new signal class").set_defaults(func=lambda:TemplateGenerator.create_template("signal"))
+		create_subparsers.add_parser("model", help="Create a new model class").set_defaults(func=lambda:TemplateGenerator.create_template("model"))
 		create_subparsers.add_parser("generator", help="Create a new signal generator class").set_defaults(func=lambda:TemplateGenerator.create_template("generator"))
 		create_subparsers.add_parser("io", help="Create a new IO class").set_defaults(func=lambda:TemplateGenerator.create_template("io"))
-		create_subparsers.add_parser("doc", help="Create a new IO class").set_defaults(func=lambda:generate_doc_source())
+		create_subparsers.add_parser("docs", help="Generate the docs").set_defaults(func=lambda:generate_docs_source())
 		
 		# --- LIST group ---
 		list_parser = subparsers.add_parser("list", help="List information about Modusa components")

{modusa-0.2.23 → modusa-0.3.1}/src/modusa/devtools/templates/generator.py

@@ -3,7 +3,7 @@
 
 from modusa import excp
 from modusa.decorators import validate_args_type
-from modusa.generators import ModusaGenerator
+from modusa.generators.base import ModusaGenerator
 
 
 class {class_name}(ModusaGenerator):

{modusa-0.2.23 → modusa-0.3.1}/src/modusa/devtools/templates/io.py

@@ -3,7 +3,7 @@
 
 from modusa import excp
 from modusa.decorators import validate_args_type
-from modusa.io import ModusaIO
+from modusa.io.base import ModusaIO
 
 
 class {class_name}(ModusaIO):

modusa-0.2.23/src/modusa/devtools/templates/signal.py → modusa-0.3.1/src/modusa/devtools/templates/model.py

@@ -3,17 +3,18 @@
 
 from modusa import excp
 from modusa.decorators import immutable_property, validate_args_type
-from modusa.signals.base import ModusaSignal
+from modusa.signals.base import ?
 from typing import Self, Any
 import numpy as np
 
-class {class_name}(ModusaSignal):
+class {class_name}():
 	"""
 
 	"""
 	
 	#--------Meta Information----------
 	_name = ""
+	_nickname = "" # This is to be used in repr/str methods
 	_description = ""
 	_author_name = "{author_name}"
 	_author_email = "{author_email}"
@@ -26,15 +27,21 @@ class {class_name}(ModusaSignal):
 	
 		self.title = "" # This title will be used as plot title by default
 		
-	#----------------------
+	#-----------------------------------
 	# Properties
-	#----------------------
+	#-----------------------------------
 		
-	
-	
-	
-	
-	
-	#----------------------
+		
+	#===================================
+		
+		
+		
+		
+		
+		
+	#-----------------------------------
 	# Tools
-	#----------------------
+	#-----------------------------------
+		
+		
+	#===================================

{modusa-0.2.23 → modusa-0.3.1}/src/modusa/devtools/templates/plugin.py

@@ -3,7 +3,7 @@
 
 from modusa import excp
 from modusa.decorators import immutable_property, validate_args_type, plugin_safety_check
-from modusa.plugins import ModusaPlugin
+from modusa.plugins.base import ModusaPlugin
 
 
 class {class_name}(ModusaPlugin):

modusa-0.3.1/src/modusa/generators/__init__.py

@@ -0,0 +1,13 @@
+#!/usr/bin/env python3
+
+from .base import ModusaGenerator
+
+from .s_ax import SAxGen
+from .t_ax import TAxGen
+
+from .s1d import S1DGen
+from .tds import TDSGen
+from .audio import AudioGen
+
+from .s2d import S2DGen
+from .ftds import FTDSGen

modusa-0.3.1/src/modusa/generators/audio.py

@@ -0,0 +1,188 @@
+#!/usr/bin/env python3
+
+
+from modusa import excp
+from modusa.decorators import validate_args_type
+from .base import ModusaGenerator
+from modusa.models.t_ax import TAx
+from modusa.models.audio import Audio
+from modusa.models.data import Data
+import numpy as np
+from pathlib import Path
+
+class AudioGen(ModusaGenerator):
+	"""
+	Provides user friendly APIs to generate instances of different 
+	`AudioSignal` instances.
+	"""
+	
+	#--------Meta Information----------
+	_name = ""
+	_description = ""
+	_author_name = "Ankit Anand"
+	_author_email = "ankit0.anand0@gmail.com"
+	_created_at = "2025-07-27"
+	#----------------------------------
+	
+	@staticmethod
+	def from_array(
+		y: np.ndarray,
+		sr: float | int = 1.0,
+		t0: float | int = 0.0,
+		y_label: str = "Amplitude",
+		t_label: str = "Time (sec)",
+		title: str = "Audio Signal"
+	) -> Audio:
+		"""
+		Create `AudioSignal` instance from basic data structures.
+
+		.. code-block:: python
+
+			import modusa as ms
+			t = ms.tds.from_array([1, 2, 3])
+			print(t)
+			t.print_info()
+		
+		Parameters
+		----------
+		y: np.ndarray
+			- Audio data array.
+		sr: float | int
+			- Sampling rate.
+		t0: float | int
+			- Start timestamp.
+		y_label: str
+			- Y label for the signal.
+			- Default: "Y"
+		t_label: str
+			- T label for the signal.
+			- Default: "Time (sec)"
+		title: str
+			- Title for the signal.
+			- Default: "1D Signal"
+		Returns
+		-------
+		Audio
+			An instance of Audio.
+		"""
+		assert isinstance(y, np.ndarray)
+		assert isinstance(sr, (int, float)) and isinstance(t0, (int, float))
+		assert isinstance(y_label, str) and isinstance(t_label, str) and isinstance(title, str)
+		
+		assert y.ndim == 1
+		
+		sr = float(sr)
+		t0 = float(t0)
+		
+		t = TAx(n_points=y.shape[0], sr=sr, t0=t0, label=t_label) # Creating a signal axis instance
+		y = Data(values=y, label=y_label)
+		
+		return Audio(y=y, t=t, title=title)
+	
+	@classmethod
+	def from_youtube(cls, url: str, sr: int | float = None):
+		"""
+		Loads audio from youtube at a given sr.
+		The audio is deleted from the device
+		after loading.
+		
+		.. code-block:: python
+			
+			import modusa as ms
+			audio = ms.audio.from_youtube(
+				url="https://www.youtube.com/watch?v=lIpw9-Y_N0g", 
+				sr=None
+			)
+
+		PARAMETERS
+		----------
+		url: str
+			Link to the YouTube video.
+		sr: int
+			Sampling rate to load the audio in.
+		
+		Returns
+		-------
+		Audio:
+			An `Audio` instance with loaded audio content from YouTube.
+		"""
+		
+		from modusa.tools.youtube_downloader import YoutubeDownloader
+		from modusa import convert
+		import soundfile as sf
+		from scipy.signal import resample
+		import tempfile
+		
+		# Download the audio in temp directory using tempfile module
+		with tempfile.TemporaryDirectory() as tmpdir:
+			audio_fp: Path = YoutubeDownloader.download(url=url, content_type="audio", output_dir=Path(tmpdir))
+			
+			# Convert the audio to ".wav" form for loading
+			wav_audio_fp: Path = convert(inp_audio_fp=audio_fp, output_audio_fp=audio_fp.with_suffix(".wav"))
+			
+			# Load the audio in memory
+			audio_data, audio_sr = sf.read(wav_audio_fp)
+			
+			# Convert to mono if it's multi-channel
+			if audio_data.ndim > 1:
+				audio_data = audio_data.mean(axis=1)
+				
+			# Resample if needed
+			if sr is not None:
+				if audio_sr != sr:
+					n_samples = int(len(audio_data) * sr / audio_sr)
+					audio_data = resample(audio_data, n_samples)
+					audio_sr = sr
+					
+		audio = cls.from_array(y=audio_data, sr=audio_sr, title=audio_fp.stem)
+		
+		return audio
+	
+	@classmethod
+	def from_filepath(cls, fp: str | Path, sr: int | float = None):
+		"""
+		Loads audio from filepath at a given sr.
+		
+		.. code-block:: python
+			
+			import modusa as ms
+			audio = ms.audio.from_filepath(
+				fp="path/to/audio.wav",
+				sr=None
+			)
+
+		PARAMETERS
+		----------
+		fp: str | Path
+			Audio file path.
+		sr: int
+			Sampling rate to load the audio in.
+		
+		Returns
+		-------
+		Audio:
+			An `Audio` instance with loaded audio content.
+		"""
+		import soundfile as sf
+		from scipy.signal import resample
+		from pathlib import Path
+		
+		fp = Path(fp)
+		# Load the audio in memory
+		audio_data, audio_sr = sf.read(fp)
+		
+		# Convert to mono if it's multi-channel
+		if audio_data.ndim > 1:
+			audio_data = audio_data.mean(axis=1)
+			
+		# Resample if needed
+		if sr is not None:
+			if audio_sr != sr:
+				n_samples = int(len(audio_data) * sr / audio_sr)
+				audio_data = resample(audio_data, n_samples)
+				audio_sr = sr
+				
+		audio = cls.from_array(y=audio_data, sr=audio_sr, title=fp.stem)
+		
+		return audio
+	

{modusa-0.2.23 → modusa-0.3.1}/src/modusa/generators/audio_waveforms.py

@@ -4,7 +4,7 @@
 from modusa import excp
 from modusa.decorators import validate_args_type
 from modusa.generators.base import ModusaGenerator
-from modusa.signals.audio_signal import AudioSignal
+from modusa.models.audio_signal import AudioSignal
 import numpy as np
 
 class AudioWaveformGenerator(ModusaGenerator):

{modusa-0.2.23 → modusa-0.3.1}/src/modusa/generators/base.py

@@ -2,7 +2,7 @@
 
 from modusa import excp
 from modusa.decorators import validate_args_type, immutable_property
-from modusa.signals.base import ModusaSignal
+from modusa.models.base import ModusaSignal
 from abc import ABC, abstractmethod
 from typing import Any