modusa 0.3.41__tar.gz → 0.3.43__tar.gz

{modusa-0.3.41 → modusa-0.3.43}/PKG-INFO

@@ -1,15 +1,16 @@
 Metadata-Version: 2.1
 Name: modusa
-Version: 0.3.41
+Version: 0.3.43
 Summary: A modular signal analysis python library.
 Author-Email: Ankit Anand <ankit0.anand0@gmail.com>
 License: MIT
 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: yt-dlp>=2025.8.22
 Requires-Dist: librosa==0.11.0
 Requires-Dist: IPython>=8.0.0
+Requires-Dist: sounddevice>=0.5.2
 Description-Content-Type: text/markdown
 
 # modusa

{modusa-0.3.41 → modusa-0.3.43}/pyproject.toml

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

{modusa-0.3.41 → modusa-0.3.43}/src/modusa/__init__.py

@@ -1,9 +1,9 @@
 from modusa.utils import excp, config
 
 #=====Giving access to plot functions to plot multiple signals.=====
-from modusa.tools import plot1d, plot2d, plot_dist
+from modusa.tools import fig1d, fig2d, plot_dist
 #=====
 
-from modusa.tools import play, convert
+from modusa.tools import play, convert, record
 from modusa.tools import download
 from modusa.tools import load, load_ann

modusa-0.3.43/src/modusa/tools/__init__.py

@@ -0,0 +1,12 @@
+#!/usr/bin/env python3
+
+from .audio_player import play
+from .audio_converter import convert
+from .youtube_downloader import download
+from .audio_loader import load
+from .ann_loader import load_ann
+from .audio_recorder import record
+
+from .plotter import Figure1D as fig1d
+from .plotter import Figure2D as fig2d
+from .plotter import plot_dist

modusa-0.3.41/src/modusa/tools/plotter.py → modusa-0.3.43/src/modusa/tools/_plotter_old.py

@@ -46,7 +46,7 @@ def set_default_hindi_font():
 	# Set as default rcParam
 	mpl.rcParams['font.family'] = hindi_font.get_name()
 
-set_default_hindi_font()
+#set_default_hindi_font()
 
 #======== 1D ===========
 def plot1d(*args, ann=None, events=None, xlim=None, ylim=None, xlabel=None, ylabel=None, title=None, legend=None, fmt=None, show_grid=False, show_stem=False):
@@ -126,10 +126,11 @@ def plot1d(*args, ann=None, events=None, xlim=None, ylim=None, xlabel=None, ylab
 		colors = plt.get_cmap('tab10').colors
 
 		fig = plt.figure(figsize=(16, 2))
-		gs = gridspec.GridSpec(2, 1, height_ratios=[0.2, 1])
+		gs = gridspec.GridSpec(3, 1, height_ratios=[0.2, 0.2, 1])
 		
-		signal_ax = fig.add_subplot(gs[1, 0])
+		signal_ax = fig.add_subplot(gs[2, 0])
 		annotation_ax = fig.add_subplot(gs[0, 0], sharex=signal_ax)
+		events_ax = fig.add_subplot(gs[1, 0])
 		
 		# Set lim
 		if xlim is not None:
@@ -207,16 +208,18 @@ def plot1d(*args, ann=None, events=None, xlim=None, ylim=None, xlabel=None, ylab
 				# Clip boundaries to xlim
 				start = max(start, x_view_min)
 				end = min(end, x_view_max)
-					
-				color = colors[i % len(colors)]
+				
+				box_colors = ["gray", "lightgray"] # Alternates color between two
+				box_color = box_colors[i % 2]
+				
 				width = end - start
-				rect = Rectangle((start, 0), width, 1, color=color, alpha=0.7)
+				rect = Rectangle((start, 0), width, 1, color=box_color, alpha=0.7)
 				annotation_ax.add_patch(rect)
 				
 				text_obj = annotation_ax.text(
 					(start + end) / 2, 0.5, tag,
 					ha='center', va='center',
-					fontsize=10, color='white', fontweight='bold', zorder=10, clip_on=True
+					fontsize=10, color="black", fontweight='bold', zorder=10, clip_on=True
 				)
 				
 				text_obj.set_clip_path(rect)
@@ -224,12 +227,15 @@ def plot1d(*args, ann=None, events=None, xlim=None, ylim=None, xlabel=None, ylab
 				
 		# Add vlines
 		if events is not None:
+#			if not isinstance(events, tuple):
+#				raise TypeError(f"`events` should be tuple, got {type(events)}")
+			
 			for xpos in events:
 				if xlim is not None:
 					if xlim[0] <= xpos <= xlim[1]:
-						annotation_ax.axvline(x=xpos, color='black', linestyle='--', linewidth=1.5)
+						annotation_ax.axvline(x=xpos, color='red', linestyle='-', linewidth=1.5)
 				else:
-					annotation_ax.axvline(x=xpos, color='black', linestyle='--', linewidth=1.5)
+					annotation_ax.axvline(x=xpos, color='red', linestyle='-', linewidth=1.5)
 					
 		# Add legend
 		if legend is not None:
@@ -253,6 +259,11 @@ def plot1d(*args, ann=None, events=None, xlim=None, ylim=None, xlabel=None, ylab
 			annotation_ax.tick_params(left=False, bottom=False, labelleft=False, labelbottom=False)
 		else:
 			annotation_ax.axis("off")
+			
+		if events is not None:
+			events_ax.tick_params(left=False, bottom=False, labelleft=False, labelbottom=False)
+		else:
+			events_ax.axis("off")
 		
 		
 		fig.subplots_adjust(hspace=0.01, wspace=0.05)

modusa-0.3.43/src/modusa/tools/audio_recorder.py

@@ -0,0 +1,115 @@
+#!/usr/bin/env python3
+
+#---------------------------------
+# Author: Ankit Anand
+# Date: 22/08/25
+# Email: ankit0.anand0@gmail.com
+#---------------------------------
+
+
+import sounddevice as sd
+import numpy as np
+import ipywidgets as widgets
+from IPython.display import display, clear_output, Audio
+
+def record():
+	"""
+	Create a UI to record audio in jupyter notebook, the 
+	recorded signal is available as array.
+
+	.. code-block:: python
+		
+		import modusa as ms
+		result = ms.record()
+		y, sr, title = result() # Keep it in the next cell
+
+	Returns
+	-------
+	Callable
+		A lambda function that returns y(audio signal), sr(sampling rate), title(title set in the UI)
+	"""
+	devices = sd.query_devices()
+	device_options = [(d['name'][:30], i) for i, d in enumerate(devices) if d['max_input_channels'] > 0]
+	
+	# Controls
+	device_dropdown = widgets.Dropdown(
+		options=device_options,
+		description="Microphone:",
+		layout=widgets.Layout(width="300px")
+	)
+	
+	sr_dropdown = widgets.Dropdown(
+		options=[('16 Khz', 16000), ('22.05 Khz', 22050), ('44.1 Khz', 44100)],
+		value=22050,
+		description="Sample Rate:",
+		layout=widgets.Layout(width="300px")
+	)
+	
+	title_box = widgets.Text(
+		placeholder="Title",
+		description="Title:",
+		layout=widgets.Layout(width="300px")
+	)
+	
+	toggle_button = widgets.Button(
+		description="Record",
+		button_style="",
+	)
+	
+	status = widgets.HTML(value="")
+	out = widgets.Output()
+	
+	# State
+	recording = {"data": None, "sr": None, "title": None}
+	stream = {"obj": None, "frames": [], "recording": False}
+	
+	def callback(indata, frames, time, status):
+		if not status:
+			stream["frames"].append(indata.copy())
+			
+	def on_toggle(b):
+		if not stream["recording"]:
+			stream["frames"].clear()
+			sr = sr_dropdown.value
+			device_id = device_dropdown.value
+			
+			stream["obj"] = sd.InputStream(callback=callback, channels=1, samplerate=sr, device=device_id)
+			stream["obj"].start()
+			stream["recording"] = True
+			
+			toggle_button.description = "Stop"
+			toggle_button.button_style = "danger"
+			status.value = "Recording..."
+		else:
+			stream["obj"].stop()
+			stream["obj"].close()
+			
+			sr = sr_dropdown.value
+			y = np.concatenate(stream["frames"], axis=0).flatten()
+			title = title_box.value.strip() or "Recording"
+			
+			recording["data"], recording["sr"], recording["title"] = y, sr, title
+			record.result = (y, sr, title)
+			stream["recording"] = False
+			
+			toggle_button.description = "Record"
+			toggle_button.button_style = "success"
+			
+			with out:
+				clear_output()
+				display(Audio(y, rate=sr))
+				
+	toggle_button.on_click(on_toggle)
+	
+	# Layout
+	ui = widgets.VBox([
+		device_dropdown,
+		sr_dropdown,
+		title_box,
+		widgets.HBox([toggle_button]),
+		out
+	])
+	
+	display(ui)
+	record.result = None
+	return lambda: record.result