modusa 0.4.10__tar.gz → 0.4.12__tar.gz

{modusa-0.4.10 → modusa-0.4.12}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: modusa
-Version: 0.4.10
+Version: 0.4.12
 Summary: A modular signal analysis python library.
 Author-Email: Ankit Anand <ankit0.anand0@gmail.com>
 License: MIT

{modusa-0.4.10 → modusa-0.4.12}/pyproject.toml

@@ -16,7 +16,7 @@ dependencies = [
 ]
 requires-python = ">=3.10"
 readme = "README.md"
-version = "0.4.10"
+version = "0.4.12"
 
 [project.license]
 text = "MIT"

{modusa-0.4.10 → modusa-0.4.12}/src/modusa/__init__.py

@@ -8,4 +8,4 @@ from modusa.tools import play, convert, record, save
 from modusa.tools import download
 from modusa.tools import load, load_ann
 
-__version__ = "0.4.10"
+__version__ = "0.4.12"

modusa-0.4.12/src/modusa/tools/ann_loader.py

@@ -0,0 +1,105 @@
+#!/usr/bin/env python3
+
+#---------------------------------
+# Author: Ankit Anand
+# Date: 12/08/25
+# Email: ankit0.anand0@gmail.com
+#---------------------------------
+
+def load_ann(path, clip=None):
+	"""
+	Load annotation from audatity label
+	text file and also ctm file.
+
+	Parameters
+	----------
+	path: str
+		- label text/ctm file path.
+	clip: tuple[number, number] | number | None
+		- Incase you clipped the audio signal, this parameter will help clip the annotation.
+		- If you clip the audio, say from (10, 20), set the clip to (10, 20).
+		- Default: None
+
+	Returns
+	-------
+	list[tuple, ...]
+		- annotation data structure
+		- [(start, end, label), ...]
+	"""
+	from pathlib import Path
+	
+	if not isinstance(path, (str, Path)):
+		raise ValueError(f"`path` must be one of (str, Path), got {type(path)}")
+	
+	# Convert to Path object
+	path = Path(path)
+	
+	# Check if the path exists
+	if not path.exists():
+		raise FileExistsError(f"{path} does not exist")
+		
+	ann = [] # This will store the annotation
+	
+	# Clipping the annotation to match with the clipped audio
+	if clip is not None:
+		# Map clip input to the right format
+		if isinstance(clip, int or float):
+			clip = (0, clip)
+		elif isinstance(clip, tuple) and len(clip) > 1:
+			clip = (clip[0], clip[1])
+		else:
+			raise ValueError(f"Invalid clip type or length: {type(clip)}, len={len(clip)}")
+	
+	if path.suffix == ".txt":
+		with open(str(path), "r") as f:
+			lines = [line.rstrip("\n") for line in f]
+			for line in lines:
+				start, end, label = line.split("\t")
+				start, end = float(start), float(end)
+				
+				# Incase user has clipped the audio signal, we adjust the annotation
+				# to match the clipped audio
+				if clip is not None:
+					offset = clip[0]
+					# Clamp annotation to clip boundaries
+					new_start = max(start, clip[0]) - offset
+					new_end   = min(end, clip[1]) - offset
+					
+					# only keep if there's still overlap
+					if new_start < new_end:
+						ann.append((new_start, new_end, label))
+				else:
+					ann.append((start, end, label))
+					
+	elif path.suffix == ".ctm":
+		with open(str(path), "r") as f:
+			content = f.read().split("\n")
+			
+		for c in content:
+			c = c.strip()
+			if c == "": # Handle empty line usually at the end of the ctm file
+				continue
+			elif len(c.split(" ")) != 5:
+				warnings.warn(f" '{c}' is not a standard ctm line.")
+			if len(c.split(" ")) == 5:
+				_, _, start, dur, label = c.split(" ")
+				start, dur = float(start), float(dur)
+				end = start + dur
+				
+				# Incase user has clipped the audio signal, we adjust the annotation
+				# to match the clipped audio
+				if clip is not None:
+					offset = clip[0]
+					# Clamp annotation to clip boundaries
+					new_start = max(start, clip[0]) - offset
+					new_end   = min(end, clip[1]) - offset
+					
+					# only keep if there's still overlap
+					if new_start < new_end:
+						ann.append((new_start, new_end, label))
+				else:
+					ann.append((start, end, label))
+				
+	else:
+		raise Exception(f"Unsupported file type {path.suffix}")
+	return ann

modusa-0.4.10/src/modusa/tools/ann_loader.py

@@ -1,65 +0,0 @@
-#!/usr/bin/env python3
-
-#---------------------------------
-# Author: Ankit Anand
-# Date: 12/08/25
-# Email: ankit0.anand0@gmail.com
-#---------------------------------
-
-from pathlib import Path
-
-def load_ann(path, clip=None):
-	"""
-	Load annotation from audatity label text file.
-
-	Parameters
-	----------
-	path: str
-		- label text file path.
-	clip: tuple[number, number] | number | None
-		- Incase you clipped the audio signal, this parameter will help clip the annotation.
-		- If you clip the audio, say from (10, 20), set the clip to (10, 20).
-		- Default: None
-
-	Returns
-	-------
-	list[tuple, ...]
-		- annotation data structure
-		- [(start, end, tag), ...]
-	"""
-	
-	if not isinstance(path, (str, Path)):
-		raise ValueError(f"`path` must be one of (str, Path), got {type(path)}")
-	
-	if clip is not None:
-		# Map clip input to the right format
-		if isinstance(clip, int or float):
-			clip = (0, clip)
-		elif isinstance(clip, tuple) and len(clip) > 1:
-			clip = (clip[0], clip[1])
-		else:
-			raise ValueError(f"Invalid clip type or length: {type(clip)}, len={len(clip)}")
-	
-	ann = []
-	
-	with open(str(path), "r") as f:
-		lines = [line.rstrip("\n") for line in f]
-		for line in lines:
-			start, end, tag = line.split("\t")
-			start, end = float(start), float(end)
-			
-			# Incase user has clipped the audio signal, we adjust the annotation
-			# to match the clipped audio
-			if clip is not None:
-				offset = clip[0]
-				# Clamp annotation to clip boundaries
-				new_start = max(start, clip[0]) - offset
-				new_end   = min(end, clip[1]) - offset
-				
-				# only keep if there's still overlap
-				if new_start < new_end:
-					ann.append((new_start, new_end, tag))
-			else:
-				ann.append((start, end, tag))
-				
-	return ann

modusa-0.4.10/tests/test_generators/audio_waveform.py

@@ -1,11 +0,0 @@
-#!/usr/bin/env python3
-
-
-#--------Meta Information----------
-_class_name = "AudioWaveformGenerator"
-_author_name = "Ankit Anand"
-_author_email = "ankit0.anand0@gmail.com"
-_created_at = "2025-07-07"
-#----------------------------------
-	
-from modusa.generators import AudioWaveformGenerator

modusa-0.4.10/tests/test_generators/test_audio.py

@@ -1,10 +0,0 @@
-#!/usr/bin/env python3
-
-from modusa import excp
-
-#--------Meta Information----------
-_class_name = "AudioGen"
-_author_name = "Ankit Anand"
-_author_email = "ankit0.anand0@gmail.com"
-_created_at = "2025-07-27"
-#----------------------------------

modusa-0.4.10/tests/test_generators/test_ftds.py

@@ -1,10 +0,0 @@
-#!/usr/bin/env python3
-
-from modusa import excp
-
-#--------Meta Information----------
-_class_name = "FTDSGen"
-_author_name = "Ankit Anand"
-_author_email = "ankit0.anand0@gmail.com"
-_created_at = "2025-07-27"
-#----------------------------------

modusa-0.4.10/tests/test_generators/test_s1d.py

@@ -1,10 +0,0 @@
-#!/usr/bin/env python3
-
-from modusa import excp
-
-#--------Meta Information----------
-_class_name = "S1DGen"
-_author_name = "Ankit Anand"
-_author_email = "ankit0.anand0@gmail.com"
-_created_at = "2025-07-27"
-#----------------------------------

modusa-0.4.10/tests/test_generators/test_s2d.py

@@ -1,10 +0,0 @@
-#!/usr/bin/env python3
-
-from modusa import excp
-
-#--------Meta Information----------
-_class_name = "S2DGen"
-_author_name = "Ankit Anand"
-_author_email = "ankit0.anand0@gmail.com"
-_created_at = "2025-07-27"
-#----------------------------------

modusa-0.4.10/tests/test_generators/test_s_ax.py

@@ -1,10 +0,0 @@
-#!/usr/bin/env python3
-
-from modusa import excp
-
-#--------Meta Information----------
-_class_name = "SAx"
-_author_name = "Ankit Anand"
-_author_email = "ankit0.anand0@gmail.com"
-_created_at = "2025-07-25"
-#----------------------------------

modusa-0.4.10/tests/test_generators/test_signal.py

@@ -1,10 +0,0 @@
-#!/usr/bin/env python3
-
-from modusa import excp
-
-#--------Meta Information----------
-_class_name = "Signal"
-_author_name = "Ankit Anand"
-_author_email = "ankit0.anand0@gmail.com"
-_created_at = "2025-07-25"
-#----------------------------------

modusa-0.4.10/tests/test_generators/test_signal_generator.py

@@ -1,10 +0,0 @@
-#!/usr/bin/env python3
-
-from modusa import excp
-
-#--------Meta Information----------
-_class_name = "SignalGenerator"
-_author_name = "Ankit Anand"
-_author_email = "ankit0.anand0@gmail.com"
-_created_at = "2025-07-25"
-#----------------------------------

modusa-0.4.10/tests/test_generators/test_t_ax.py

@@ -1,10 +0,0 @@
-#!/usr/bin/env python3
-
-from modusa import excp
-
-#--------Meta Information----------
-_class_name = "TAxGenerator"
-_author_name = "Ankit Anand"
-_author_email = "ankit0.anand0@gmail.com"
-_created_at = "2025-07-26"
-#----------------------------------

modusa-0.4.10/tests/test_generators/test_tds.py

@@ -1,10 +0,0 @@
-#!/usr/bin/env python3
-
-from modusa import excp
-
-#--------Meta Information----------
-_class_name = "TDSGen"
-_author_name = "Ankit Anand"
-_author_email = "ankit0.anand0@gmail.com"
-_created_at = "2025-07-27"
-#----------------------------------

modusa-0.4.10/tests/test_io/audio_player.py

@@ -1,11 +0,0 @@
-#!/usr/bin/env python3
-
-
-#--------Meta Information----------
-_class_name = "AudioPlayer"
-_author_name = "Ankit Anand"
-_author_email = "ankit0.anand0@gmail.com"
-_created_at = "2025-07-08"
-#----------------------------------
-	
-from modusa.ios import AudioPlayer

modusa-0.4.10/tests/test_io/plotter.py

@@ -1,11 +0,0 @@
-#!/usr/bin/env python3
-
-
-#--------Meta Information----------
-class_name = "Plotter"
-author_name = "Ankit Anand"
-author_email = "ankit0.anand0@gmail.com"
-created_at = "2025-07-06"
-#----------------------------------
-	
-from modusa.ios import Plotter

modusa-0.4.10/tests/test_models/test_data.py

@@ -1,10 +0,0 @@
-#!/usr/bin/env python3
-
-from modusa import excp
-
-#--------Meta Information----------
-_class_name = "Data"
-_author_name = "Ankit Anand"
-_author_email = "ankit0.anand0@gmail.com"
-_created_at = "2025-07-27"
-#----------------------------------

modusa-0.4.10/tests/test_models/test_t_ax.py

@@ -1,10 +0,0 @@
-#!/usr/bin/env python3
-
-from modusa import excp
-
-#--------Meta Information----------
-_class_name = "TAx"
-_author_name = "Ankit Anand"
-_author_email = "ankit0.anand0@gmail.com"
-_created_at = "2025-07-26"
-#----------------------------------

modusa-0.4.10/tests/test_plugins/youtube_audio_loader.py

@@ -1,11 +0,0 @@
-#!/usr/bin/env python3
-
-
-#--------Meta Information----------
-class_name = "YoutubeAudioLoaderPlugin"
-author_name = "Ankit Anand"
-author_email = "ankit0.anand0@gmail.com"
-created_at = "2025-07-05"
-#----------------------------------
-	
-from modusa.plugins import YoutubeAudioLoaderPlugin

modusa-0.4.10/tests/test_signals/frequency_domain_signal.py

@@ -1,11 +0,0 @@
-#!/usr/bin/env python3
-
-
-#--------Meta Information----------
-_class_name = "FrequencyDomainSignal"
-_author_name = "Ankit Anand"
-_author_email = "ankit0.anand0@gmail.com"
-_created_at = "2025-07-09"
-#----------------------------------
-	
-from modusa.signals import FrequencyDomainSignal

modusa-0.4.10/tests/test_signals/spectrogram.py

@@ -1,11 +0,0 @@
-#!/usr/bin/env python3
-
-
-#--------Meta Information----------
-_class_name = "Spectrogram"
-_author_name = "Ankit Anand"
-_author_email = "ankit0.anand0@gmail.com"
-_created_at = "2025-07-07"
-#----------------------------------
-	
-from modusa.signals import Spectrogram

modusa-0.4.10/tests/test_signals/test_axis.py

@@ -1,10 +0,0 @@
-#!/usr/bin/env python3
-
-from modusa import excp
-
-#--------Meta Information----------
-_class_name = "Axis"
-_author_name = "Ankit Anand"
-_author_email = "ankit0.anand0@gmail.com"
-_created_at = "2025-07-20"
-#----------------------------------

modusa-0.4.10/tests/test_signals/test_feature_time_domain_signal.py

@@ -1,10 +0,0 @@
-#!/usr/bin/env python3
-
-from modusa import excp
-
-#--------Meta Information----------
-_class_name = "FeatureTimeDomainSignal"
-_author_name = "Ankit Anand"
-_author_email = "ankit0.anand0@gmail.com"
-_created_at = "2025-07-21"
-#----------------------------------

modusa-0.4.10/tests/test_signals/test_frequency_time_domain_signal.py

@@ -1,10 +0,0 @@
-#!/usr/bin/env python3
-
-from modusa import excp
-
-#--------Meta Information----------
-_class_name = "FrequencyTimeDomainSignal"
-_author_name = "Ankit Anand"
-_author_email = "ankit0.anand0@gmail.com"
-_created_at = "2025-07-20"
-#----------------------------------

modusa-0.4.10/tests/test_signals/test_signal1D.py

@@ -1,10 +0,0 @@
-#!/usr/bin/env python3
-
-from modusa import excp
-
-#--------Meta Information----------
-_class_name = "Signal1D"
-_author_name = "Ankit Anand"
-_author_email = "ankit0.anand0@gmail.com"
-_created_at = "2025-07-20"
-#----------------------------------

modusa-0.4.10/tests/test_signals/test_signal2D.py

@@ -1,10 +0,0 @@
-#!/usr/bin/env python3
-
-from modusa import excp
-
-#--------Meta Information----------
-_class_name = "Signal2D"
-_author_name = "Ankit Anand"
-_author_email = "ankit0.anand0@gmail.com"
-_created_at = "2025-07-20"
-#----------------------------------

modusa-0.4.10/tests/test_signals/test_time_domain_signal.py

@@ -1,10 +0,0 @@
-#!/usr/bin/env python3
-
-from modusa import excp
-
-#--------Meta Information----------
-_class_name = "TimeDomainSignal"
-_author_name = "Ankit Anand"
-_author_email = "ankit0.anand0@gmail.com"
-_created_at = "2025-07-20"
-#----------------------------------

modusa-0.4.10/tests/test_signals/test_u_ax.py

@@ -1,10 +0,0 @@
-#!/usr/bin/env python3
-
-from modusa import excp
-
-#--------Meta Information----------
-_class_name = "UAx"
-_author_name = "Ankit Anand"
-_author_email = "ankit0.anand0@gmail.com"
-_created_at = "2025-07-24"
-#----------------------------------

modusa-0.4.10/tests/test_signals/test_window_signal.py

@@ -1,10 +0,0 @@
-#!/usr/bin/env python3
-
-from modusa import excp
-
-#--------Meta Information----------
-_class_name = "WindowSignal"
-_author_name = "Ankit Anand"
-_author_email = "ankit0.anand0@gmail.com"
-_created_at = "2025-07-19"
-#----------------------------------

modusa-0.4.10/tests/test_signals/time_domain_signal.py

@@ -1,11 +0,0 @@
-#!/usr/bin/env python3
-
-
-#--------Meta Information----------
-_class_name = "TimeDomainSignal"
-_author_name = "Ankit Anand"
-_author_email = "ankit0.anand0@gmail.com"
-_created_at = "2025-07-09"
-#----------------------------------
-	
-from modusa.signals import TimeDomainSignal

modusa-0.4.10/tests/test_tools/test_audio_converter.py

@@ -1,48 +0,0 @@
-#!/usr/bin/env python3
-
-
-#--------Meta Information----------
-_class_name = "AudioConverter"
-_author_name = "Ankit Anand"
-_author_email = "ankit0.anand0@gmail.com"
-_created_at = "2025-07-11"
-#----------------------------------
-
-
-from modusa import excp
-from modusa.tools.audio_converter import AudioConverter
-import pytest
-from pathlib import Path
-import shutil
-
-TEST_DP = Path(__file__).parents[1].resolve()
-TMP_DP = TEST_DP / "tmp" # To store exported files
-
-@pytest.fixture(scope="module", autouse=True)
-def cleanup_dne_dir():
-	"""
-	This makes sure that the directory after the test
-	is automatically deleted.
-	"""
-	yield
-	dne_dir = TEST_DP / "tmp"
-	if dne_dir.exists():
-		shutil.rmtree(dne_dir)
-
-def test_convert_non_exixiting_file():
-	with pytest.raises(excp.FileNotFoundError):
-		AudioConverter.convert("../dne.wav", "./dne.mp3")
-
-def test_convert_non_existing_output_dir():
-	AudioConverter.convert(TEST_DP / "data" / "song1.mp3", TEST_DP / "tmp" / "song1.wav")
-
-def test_convert_to_same_format():
-	AudioConverter.convert(TEST_DP / "data" / "song1.mp3", TEST_DP / "tmp" / "song1.mp3")
-	
-def test_when_input_fp_same_output_fp():
-	with pytest.raises(excp.InputValueError):
-		AudioConverter.convert(TEST_DP / "data" / "song1.mp3", TEST_DP / "data" / "song1.mp3")
-		
-def test_with_none():
-	with pytest.raises(excp.InputTypeError):
-		AudioConverter.convert(None, None)

modusa-0.4.10/tests/test_tools/test_fourier_tranform.py

@@ -1,10 +0,0 @@
-#!/usr/bin/env python3
-
-
-#--------Meta Information----------
-_class_name = "FourierTransform"
-_author_name = "Ankit Anand"
-_author_email = "ankit0.anand0@gmail.com"
-_created_at = "2025-07-11"
-#----------------------------------
-