modusa 0.4.27__py3-none-any.whl → 0.4.29__py3-none-any.whl

modusa/__init__.py

@@ -8,4 +8,6 @@ from modusa.tools import play, convert, record, save
 from modusa.tools import download
 from modusa.tools import load, load_ann
 
-__version__ = "0.4.27"
+from modusa.tools import synth_f0
+
+__version__ = "0.4.29"

modusa/tools/__init__.py

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

modusa/tools/synth.py

@@ -0,0 +1,55 @@
+#!/usr/bin/env python3
+
+#---------------------------------
+# Author: Ankit Anand
+# Date: 22/10/25
+# Email: ankit0.anand0@gmail.com
+#---------------------------------
+
+import numpy as np
+
+def synth_f0(f0, f0t, sr, nharm=0):
+	"""
+	Synthesize f0 contour so that you can
+	hear it back.
+
+	Parameters
+	----------
+	f0: ndarray
+		- Fundamental frequency (f0) contour in Hz.
+	f0t: ndarray
+		- Timestamps in seconds
+	sr: int
+		- Sampling rate in Hz for the synthesized audio.
+	nharm: int
+		- Number of harmonics
+		- Default: 0 => Only fundamental frequency (No harmonics)
+
+	Returns
+	-------
+	ndarray
+		- Syntesized audio.
+	sr
+		- Sampling rate of the synthesized audio
+	"""
+	
+	# Create new time axis
+	t = np.arange(0, f0t[-1], 1 / sr)
+	
+	# Interpolate the f0 to match the sampling time points
+	f0_interp = np.interp(t, f0t, f0)
+	
+	# Compute phase by integrating frequency over time
+	phase = 2 * np.pi * np.cumsum(f0_interp) / sr
+	
+	# Start with fundamental
+	y = np.sin(phase)
+	
+	# Add harmonics if requested
+	for n in range(2, nharm + 2):  # from 2nd to (nharm+1)th harmonic
+		y += np.sin(n * phase) / n**2  # dividing by n to reduce harmonic amplitude
+	
+	# Normalize output to avoid clipping
+	y /= np.max(np.abs(y))
+	
+	return y, sr

{modusa-0.4.27.dist-info → modusa-0.4.29.dist-info}/METADATA

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

{modusa-0.4.27.dist-info → modusa-0.4.29.dist-info}/RECORD

@@ -1,10 +1,10 @@
 LICENSE.md,sha256=JTaXAjx5awk76VArKCx5dUW8vmLEWsL_ZlR7-umaHbA,1078
 README.md,sha256=Ybe2rcDecfSCiUpec2n7btQvgyi4R9JG0bfdwSWijWk,981
-modusa-0.4.27.dist-info/METADATA,sha256=in1--mu4GEgZuM7EbaPi1y6VllJ5lFyYhTu1p2g1VBA,1442
-modusa-0.4.27.dist-info/WHEEL,sha256=9P2ygRxDrTJz3gsagc0Z96ukrxjr-LFBGOgv3AuKlCA,90
-modusa-0.4.27.dist-info/entry_points.txt,sha256=fmKpleVXj6CdaBVL14WoEy6xx7JQCs85jvzwTi3lePM,73
-modusa-0.4.27.dist-info/licenses/LICENSE.md,sha256=JTaXAjx5awk76VArKCx5dUW8vmLEWsL_ZlR7-umaHbA,1078
-modusa/__init__.py,sha256=JTwvzlog-zi87g4HYG1BD_gngzceaQJXeiR3h8pWg60,324
+modusa-0.4.29.dist-info/METADATA,sha256=w3Ounw63-5pcA2jlrzHptInjFOboEqvj1xDLy9GWSmk,1442
+modusa-0.4.29.dist-info/WHEEL,sha256=9P2ygRxDrTJz3gsagc0Z96ukrxjr-LFBGOgv3AuKlCA,90
+modusa-0.4.29.dist-info/entry_points.txt,sha256=fmKpleVXj6CdaBVL14WoEy6xx7JQCs85jvzwTi3lePM,73
+modusa-0.4.29.dist-info/licenses/LICENSE.md,sha256=JTaXAjx5awk76VArKCx5dUW8vmLEWsL_ZlR7-umaHbA,1078
+modusa/__init__.py,sha256=96xDqsDInWHPGL6zgax7NY_p0IVtEtReyKORnL97dlY,359
 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
@@ -42,7 +42,7 @@ 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=S7P1uYckyUdkha2UX9uj4P7mqpF6cc5SHqiW6NEupgs,342
+modusa/tools/__init__.py,sha256=YWbsQ40Pcu3Md2lNoKe4JnFtvpMGUVEwE92PoDkc6v4,371
 modusa/tools/_plotter_old.py,sha256=KGow7mihA2H1WNq7s5bpivhCgGo2qVIeDaO6iabpsrg,19294
 modusa/tools/ann_loader.py,sha256=m6Qu6jXnQ8LfUhKItoHSaHlGxUyzUJlGEyu4_50qJ8w,3099
 modusa/tools/audio_converter.py,sha256=415qBoPm2sBIuBSI7m1XBKm0AbmVmPydIPPr-uO8D3c,1778
@@ -53,6 +53,7 @@ modusa/tools/audio_saver.py,sha256=ldzfr_AydsHTnKbxmBLJblN-hLzTmOlppOm306xI4Ug,5
 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=QfF8kCi79nS-J5lQyEuH_BbAmTo-PdfjDbnK9yTAmRE,30863
+modusa/tools/synth.py,sha256=tfCjTAucTDwb0yOHHnrNO7EFsuH7tNb1PwvS2xwmhK0,1222
 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
@@ -60,5 +61,5 @@ 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
-pyproject.toml,sha256=19Ne5cd7ykQB99LyXBiJYV71N0yyySJPwejXBdc8WTk,1413
-modusa-0.4.27.dist-info/RECORD,,
+pyproject.toml,sha256=qtq7gqezVAXHCMMLYQbQGdIJT1g7A0CgavxR1RhHJFo,1413
+modusa-0.4.29.dist-info/RECORD,,

pyproject.toml

@@ -16,7 +16,7 @@ dependencies = [
 ]
 requires-python = ">=3.11"
 readme = "README.md"
-version = "0.4.27"
+version = "0.4.29"
 
 [project.license]
 text = "MIT"