modusa 0.4.14__py3-none-any.whl → 0.4.16__py3-none-any.whl

modusa/__init__.py

@@ -1,11 +1,11 @@
 from modusa.utils import excp, config
 
 #=====Giving access to plot functions to plot multiple signals.=====
-from modusa.tools import dist_plot, hill_plot, fig
+from modusa.tools import dist_plot, hill_plot, plot, fig
 #=====
 
 from modusa.tools import play, convert, record, save
 from modusa.tools import download
 from modusa.tools import load, load_ann
 
-__version__ = "0.4.14"
+__version__ = "0.4.16"

modusa/tools/__init__.py

@@ -9,4 +9,4 @@ from .ann_loader import load_ann
 from .audio_recorder import record
 
 from .plotter import Fig as fig
-from .plotter import dist_plot, hill_plot
+from .plotter import dist_plot, hill_plot, plot

modusa/tools/audio_player.py

@@ -1,88 +1,60 @@
 #!/usr/bin/env python3
 
+from IPython.display import Audio, HTML, display
 import numpy as np
-from IPython.display import display, HTML, Audio
 
-def play(y: np.ndarray, sr: float, title = None, t0: float = 0.0, regions = None) -> None:
+def play(y: np.ndarray, sr: float, clip: tuple[float, float] | None = None, label: str | None = None) -> None:
 		"""
-		Plays audio clips for given regions in Jupyter Notebooks.
+		Simple audio player with optional clip selection and label, 
+		displayed neatly in a small table.
 
 		Parameters
 		----------
 		y : np.ndarray
-			- Audio data.
-			- Mono (1D) numpy array.
-		sr: float
-			- Sampling rate of the audio.
-		title : str | None
-			- Title to display above audio players.
-		t0: float
-			- Starting timestamp, incase the audio is cropped
-			- Default: 0.0 → Starts from 0.0 sec
-		regions : list[tuple[float, float, str]] | tuple[float, float, str] | None
-			- Regions to extract and play (in sec), e.g. [(0, 10.2, "tag")]
-			- If there is only one region, a tuple should also work. e.g. (0, 10.2, "tag")
-			- Default: None → The entire song is selected.
+				Mono audio data (1D numpy array).
+		sr : float
+				Sampling rate.
+		clip : tuple[float, float] | None
+				(start_time, end_time) in seconds. Plays whole audio if None.
+		label : str | None
+				Optional label to describe the clip (e.g. "Chorus", "Intro").
 
 		Returns
 		-------
 		None
 		"""
-		if title:
-			display(HTML(f"<p style='font-size:15px; font-weight:600; text-decoration: underline; margin-left:10px'>{title}</p>"))
-			
-		clip_tags = []
-		timings = []
-		players = []
-	
-		if isinstance(regions, tuple): regions = [regions] # (10, 20, "Region 1") -> [(10, 20, "Region 1")]
+		start_time, end_time = 0.0, len(y) / sr
 	
-		if regions is not None:
-			for region in regions:
-				assert len(region) == 3
-				
-				start_sec = region[0] - t0
-				end_sec = region[1] - t0
-				tag = region[2]
-				
-				start_sample, end_sample = int(start_sec * sr), int(end_sec * sr)
-				clip = y[start_sample: end_sample]
-				audio_player = Audio(data=clip, rate=sr)._repr_html_()
-				
-				clip_tags.append(f"<td style='text-align:center; border-right:1px solid #ccc; padding:6px;'>{tag}</td>")
-				timings.append(f"<td style='text-align:center; border-right:1px solid #ccc; padding:6px;'>{start_sec:.2f}s → {end_sec:.2f}s</td>")
-				players.append(f"<td style='padding:6px;'>{audio_player}</td>")
-		else:
-			audio_player = Audio(data=y, rate=sr)._repr_html_()
-			
-			start_sec = t0
-			end_sec = t0 + y.shape[0] / sr
+		if clip is not None:
+				if not isinstance(clip, tuple) or len(clip) != 2:
+						raise ValueError("`clip` must be a tuple of (start_time, end_time)")
+				start_sample = int(clip[0] * sr)
+				end_sample = int(clip[1] * sr)
+				y = y[start_sample:end_sample]
+				start_time, end_time = clip
 			
-			clip_tags.append(f"<td style='text-align:center; border-right:1px solid #ccc; padding:6px;'>1</td>")
-			timings.append(f"<td style='text-align:center; border-right:1px solid #ccc; padding:6px;'>{start_sec:.2f}s → {end_sec:.2f}s</td>")
-			players.append(f"<td style='padding:6px;'>{audio_player}</td>")
-			
-		# Wrap rows in a table with border
+		# Build the HTML table
+		audio_html = Audio(data=y, rate=sr)._repr_html_()
+		label_html = label if label is not None else "-"
+	
 		table_html = f"""
 		<div style="display:inline-block; border:1px solid #ccc; border-radius:6px; overflow:hidden;">
-			<table style="border-collapse:collapse;">
-				<tr style="background-color:#f2f2f2;">
-					<th style="text-align:left; padding:6px 12px;">Clip</th>
-					{''.join(clip_tags)}
-				</tr>
-				<tr style="background-color:#fcfcfc;">
-					<th style="text-align:left; padding:6px 12px;">Timing</th>
-					{''.join(timings)}
+			<table style="border-collapse:collapse; font-family:sans-serif; font-size:14px;">
+				<tr style="background-color:#f8f8f8;">
+					<th style="padding:6px 12px; text-align:left;">Timing</th>
+					<th style="padding:6px 12px; text-align:left;">Label</th>
+					<th style="padding:6px 12px; text-align:left;">Audio</th>
 				</tr>
 				<tr>
-					<th style="text-align:left; padding:6px 12px;">Player</th>
-					{''.join(players)}
+					<td style="padding:6px 12px; border-top:1px solid #ddd;">{start_time:.2f}s → {end_time:.2f}s</td>
+					<td style="padding:6px 12px; border-top:1px solid #ddd;">{label_html}</td>
+					<td style="padding:6px 12px; border-top:1px solid #ddd;">{audio_html}</td>
 				</tr>
 			</table>
 		</div>
 		"""
 	
-		return HTML(table_html)
+		display(HTML(table_html))
 
 		
 		

modusa/tools/plotter.py

@@ -1013,6 +1013,43 @@ def dist_plot(*args, ann=None, xlim=None, ylim=None, ylabel=None, xlabel=None, t
 		return fig
 	
 
+# ======== Single Plot ===========
+def plot(*args):
+	"""
+	To create 1D/2D plot for immediate
+	inspection.
+
+	Parameters
+	----------
+	*args: ndarray
+		- Arrays to be plotted.
+	"""
+	n = len(args)
+	
+	if n < 1:
+		raise ValueError("Need atleast 1 positional argument")
+	
+	## 1D Array
+	if args[0].ndim == 1:
+		if n > 1: # User also passed the xs
+			fig = Fig("s").add_signal(args[0], args[1])
+		else:
+			fig = Fig("s").add_signal(args[0])
+	
+	## 2D Array
+	if args[0].ndim == 2:
+		if n == 1:
+			fig = Fig("m").add_matrix(args[0])
+		elif n == 2: # User also passed the xs
+			fig = Fig("m").add_matrix(args[0], args[1])
+		elif n == 3:
+			fig = Fig("m").add_matrix(args[0], args[1], args[2])
+	
+	return fig
+	
+	
+		
+	
 	
 		
 	

{modusa-0.4.14.dist-info → modusa-0.4.16.dist-info}/METADATA

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

{modusa-0.4.14.dist-info → modusa-0.4.16.dist-info}/RECORD

@@ -1,8 +1,8 @@
-modusa-0.4.14.dist-info/METADATA,sha256=gJaGKYsCoAxosv4vpYRpt1Tdr7wTy2QOJQKxeP6FBgA,1467
-modusa-0.4.14.dist-info/WHEEL,sha256=9P2ygRxDrTJz3gsagc0Z96ukrxjr-LFBGOgv3AuKlCA,90
-modusa-0.4.14.dist-info/entry_points.txt,sha256=fmKpleVXj6CdaBVL14WoEy6xx7JQCs85jvzwTi3lePM,73
-modusa-0.4.14.dist-info/licenses/LICENSE.md,sha256=JTaXAjx5awk76VArKCx5dUW8vmLEWsL_ZlR7-umaHbA,1078
-modusa/__init__.py,sha256=P4CZ1GPciZKNs8QpunHHECc2FocdtbYMk3WAQBHXOt4,318
+modusa-0.4.16.dist-info/METADATA,sha256=pLWuRj0GcmfeniEEcjwUbsShuSxYnPqFIGVLXqdX3KQ,1467
+modusa-0.4.16.dist-info/WHEEL,sha256=9P2ygRxDrTJz3gsagc0Z96ukrxjr-LFBGOgv3AuKlCA,90
+modusa-0.4.16.dist-info/entry_points.txt,sha256=fmKpleVXj6CdaBVL14WoEy6xx7JQCs85jvzwTi3lePM,73
+modusa-0.4.16.dist-info/licenses/LICENSE.md,sha256=JTaXAjx5awk76VArKCx5dUW8vmLEWsL_ZlR7-umaHbA,1078
+modusa/__init__.py,sha256=YzOOf42ipGf7nXgrkH0VFvL9WGLAuqIFIft8VuCKgXo,324
 modusa/config.py,sha256=bTqK4t00FZqERVITrxW_q284aDDJAa9aMSfFknfR-oU,280
 modusa/decorators.py,sha256=8zeNX_wE37O6Vp0ysR4-WCZaEL8mq8dyCF_I5DHOzks,5905
 modusa/devtools/generate_docs_source.py,sha256=UDflHsk-Yh9-3YJTVBzKL32y8hcxiRgAlFEBTMiDqwM,3301
@@ -39,17 +39,17 @@ modusa/models/t_ax.py,sha256=ZUhvZPUW1TkdZYuUd6Ucm-vsv0JqtZ9yEe3ab67Ma6w,8022
 modusa/models/tds.py,sha256=FAGfibjyyE_lkEuQp-vSCuqQnopOjmy_IXqUjRlg9kc,11677
 modusa/plugins/__init__.py,sha256=r1Bf5mnrVKRIwxboutY1iGzDy4EPQhqpk1kSW7iJj_Q,54
 modusa/plugins/base.py,sha256=Bh_1Bja7fOymFsCgwhXDbV6ys3D8muNrPwrfDrG_G_A,2382
-modusa/tools/__init__.py,sha256=q4d7J4xGraVLVLsk4h1OcWvi19FXd7DbJrGdUAOn5Es,336
+modusa/tools/__init__.py,sha256=S7P1uYckyUdkha2UX9uj4P7mqpF6cc5SHqiW6NEupgs,342
 modusa/tools/_plotter_old.py,sha256=KGow7mihA2H1WNq7s5bpivhCgGo2qVIeDaO6iabpsrg,19294
 modusa/tools/ann_loader.py,sha256=BEdwAh_lccx_SnAO3bNMeY3O5zGiJlH2o4snWmXj8eQ,3034
 modusa/tools/audio_converter.py,sha256=415qBoPm2sBIuBSI7m1XBKm0AbmVmPydIPPr-uO8D3c,1778
 modusa/tools/audio_loader.py,sha256=n9Q9t_GmlE8AtioVwRcXX3rnd6PkbGTx-hAoNgUnNOQ,2780
-modusa/tools/audio_player.py,sha256=pXKaNsDbqhCVbrMx5QRv7aC2IPMJFY5POAG60f-1LmU,2901
+modusa/tools/audio_player.py,sha256=NQv7sAGhJerju5_JKkvtVW9IcbjDv_mj7cDdxwK-blw,1911
 modusa/tools/audio_recorder.py,sha256=K_LGqsPdjTdf3figEZTSQLmgMzYWgz18HTO8C1j5fE4,2788
 modusa/tools/audio_saver.py,sha256=ldzfr_AydsHTnKbxmBLJblN-hLzTmOlppOm306xI4Ug,510
 modusa/tools/base.py,sha256=C0ESJ0mIfjjRlAkRbSetNtMoOfS6IrHBjexRp3l_Mh4,1293
 modusa/tools/math_ops.py,sha256=ZZ7U4DgqT7cOeE7_Lzi_Qq-48WYfwR9_osbZwTmE9eg,8690
-modusa/tools/plotter.py,sha256=VwHWxQ9t5oP20cHaALMwFsE_fqSUhl_9KDufucTCodw,29964
+modusa/tools/plotter.py,sha256=V0CcRnXkE4tkTZQe6v0LI0ucEagqeudOZ-xoQw2clTc,30667
 modusa/tools/youtube_downloader.py,sha256=hB_X8-7nOHXOlxg6vv3wyhBLoAsWyomrULP6_uCQL7s,1698
 modusa/utils/__init__.py,sha256=1oLL20yLB1GL9IbFiZD8OReDqiCpFr-yetIR6x1cNkI,23
 modusa/utils/config.py,sha256=cuGbqbovx5WDQq5rw3hIKcv3CnE5NttjacSOWnP1yu4,576
@@ -57,4 +57,4 @@ modusa/utils/excp.py,sha256=L9vhaGjKpv9viJYdmC9n5ndmk2GVbUBuFyZyhAQZmWY,906
 modusa/utils/logger.py,sha256=K0rsnObeNKCxlNeSnVnJeRhgfmob6riB2uyU7h3dDmA,571
 modusa/utils/np_func_cat.py,sha256=TyIFgRc6bARRMDnZxlVURO5Z0I-GWhxRONYyIv-Vwxs,1007
 modusa/utils/plot.py,sha256=s_vNdxvKfwxEngvJPgrF1PcmxZNnNaaXPViHWjyjJ-c,5335
-modusa-0.4.14.dist-info/RECORD,,
+modusa-0.4.16.dist-info/RECORD,,