modusa 0.3.73__tar.gz → 0.3.75__tar.gz

{modusa-0.3.73 → modusa-0.3.75}/PKG-INFO

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

{modusa-0.3.73 → modusa-0.3.75}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "modusa"
-version = "0.3.73"
+version = "0.3.75"
 description = "A modular signal analysis python library."
 authors = [
     { name = "Ankit Anand", email = "ankit0.anand0@gmail.com" },

{modusa-0.3.73 → modusa-0.3.75}/src/modusa/tools/plotter.py

@@ -95,6 +95,14 @@ class Fig:
 		
 		return curr_row
 	
+	def _get_prev_row(self):
+		"""
+		Get the prev row where you can add arrows.
+		"""
+		prev_pow = self._axs[self._curr_row_idx - 1]
+		
+		return prev_pow
+	
 	def _get_new_color(self):
 		"""
 		Get a new color for different lines.
@@ -529,6 +537,67 @@ class Fig:
 		
 		if grid is True:
 			curr_row[0].grid(True, linestyle='--', linewidth=0.7, color="lightgray" ,alpha=0.6)
+	
+	from matplotlib.patches import Rectangle
+	import matplotlib.pyplot as plt
+	
+	def add_arrows(self, xys, labels, text_offset=(0, 0), c="r", fontsize=12, ax=None):
+		"""
+		Add multiple arrows pointing to specific points with boxed labels at the tails.
+	
+		Parameters
+		----------
+		xys : list[tuple[float, float]]
+			- List of target points (x, y) for the arrow heads.
+		labels : list[str] | str
+			- List of text labels at the arrow tails.
+			- If str, the same label is used for all points.
+		text_offset : tuple[float, float] | list[tuple[float, float]]
+			- Offset(s) (dx, dy) for label positions from arrow tails.
+			- If single tuple, same offset is applied to all.
+		c : str | list[str]
+			- Color(s) for arrow and text.
+			- If str, same color is applied to all.
+		fontsize : int | list[int]
+			- Font size(s) of the label text.
+			- If int, same size is applied to all.
+		ax : int | None
+			- Which specific axis to plot (1, 2, 3, ...).
+			- If None, uses the current row.
+	
+		Returns
+		-------
+		None
+		"""
+		curr_row = self._get_prev_row() if ax is None else self._axs[ax]
+		
+		# Normalize single values into lists
+		n = len(xys)
+		if isinstance(labels, str):
+			labels = [labels] * n
+		if isinstance(text_offset, tuple):
+			text_offset = [text_offset] * n
+		if isinstance(c, str):
+			c = [c] * n
+		if isinstance(fontsize, int):
+			fontsize = [fontsize] * n
+			
+		for (xy, label, offset, color, fs) in zip(xys, labels, text_offset, c, fontsize):
+			arrowprops = dict(arrowstyle="->", color=color, lw=2)
+			bbox = dict(boxstyle="round,pad=0.3", fc="white", ec=color, lw=1.2)
+			
+			text_x, text_y = xy[0] + offset[0], xy[1] + offset[1]
+			
+			curr_row[0].annotate(
+				label,
+				xy=xy, xycoords="data",
+				xytext=(text_x, text_y), textcoords="data",
+				arrowprops=arrowprops,
+				fontsize=fs,
+				color=color,
+				ha="center", va="center",
+				bbox=bbox
+			)
 			
 	def add_legend(self, ypos=1.0):
 		"""