stouputils 1.13.2__tar.gz → 1.14.0__tar.gz

{stouputils-1.13.2 → stouputils-1.14.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: stouputils
-Version: 1.13.2
+Version: 1.14.0
 Summary: Stouputils is a collection of utility modules designed to simplify and enhance the development process. It includes a range of tools for tasks such as execution of doctests, display utilities, decorators, as well as context managers, and many more.
 Keywords: utilities,tools,helpers,development,python
 Author: Stoupy51

{stouputils-1.13.2 → stouputils-1.14.0}/pyproject.toml

@@ -1,102 +1,102 @@
-
-[build-system]
-requires = ["uv_build"]
-build-backend = "uv_build"
-
-[tool.uv.build-backend]
-module-root = ""
-
-[project]
-name = "stouputils"
-version = "1.13.2"
-description = "Stouputils is a collection of utility modules designed to simplify and enhance the development process. It includes a range of tools for tasks such as execution of doctests, display utilities, decorators, as well as context managers, and many more."
-readme = "README.md"
-keywords = ["utilities", "tools", "helpers", "development", "python"]
-requires-python = ">=3.12"
-classifiers = [
-    "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.12",
-    "Programming Language :: Python :: 3.13",
-    "Programming Language :: Python :: 3.14",
-    "License :: OSI Approved :: MIT License",
-    "Operating System :: OS Independent",
-]
-dependencies = [
-    "tqdm>=4.0.0",
-    "requests>=2.20.0",
-    "msgspec[toml,yaml]>=0.20.0",
-    "pillow>=12.0.0",
-    "python-box>=7.0.0",
-    "argcomplete>=3.0.0",
-    "numpy",
-]
-authors = [
-    { name = "Stoupy51", email = "stoupy51@gmail.com" },
-]
-
-[project.optional-dependencies]
-docs = [
-    "m2r2",
-    "myst_parser",
-    "sphinx_copybutton",
-    "sphinx_design",
-    "sphinx_treeview",
-    "sphinx_breeze_theme",
-    "pydata_sphinx_theme",
-]
-data_science = [
-    "opencv-python",
-    "scikit-image",
-    "simpleitk",
-    "mlflow",
-    "tensorflow",
-    "scikit-learn",
-    "PyWavelets",
-]
-
-[project.urls]
-Homepage = "https://stoupy51.github.io/stouputils"
-Issues = "https://github.com/Stoupy51/stouputils/issues"
-Source = "https://github.com/Stoupy51/stouputils"
-
-[project.scripts]
-stouputils = "stouputils.__main__:main"
-
-[tool.pyright]
-typeCheckingMode = "strict"
-
-[tool.ruff]
-exclude = [
-    ".git",
-    ".ruff_cache",
-    ".venv",
-    ".vscode",
-    ".cursor",
-    "build",
-    "dist",
-    "*.pyi",
-]
-line-length = 200
-
-[tool.ruff.lint]
-select = [
-    "E",
-    "W",
-    "F",
-    "I",
-    "N",
-    "UP",
-    "B",
-    "C4",
-    "T20",
-    "RUF",
-]
-ignore = [
-    "T201",
-    "W191",
-    "N803",
-    "N806",
-    "F403",
-    "F405",
-]
-
+
+[build-system]
+requires = ["uv_build"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+module-root = ""
+
+[project]
+name = "stouputils"
+version = "1.14.0"
+description = "Stouputils is a collection of utility modules designed to simplify and enhance the development process. It includes a range of tools for tasks such as execution of doctests, display utilities, decorators, as well as context managers, and many more."
+readme = "README.md"
+keywords = ["utilities", "tools", "helpers", "development", "python"]
+requires-python = ">=3.12"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]
+dependencies = [
+    "tqdm>=4.0.0",
+    "requests>=2.20.0",
+    "msgspec[toml,yaml]>=0.20.0",
+    "pillow>=12.0.0",
+    "python-box>=7.0.0",
+    "argcomplete>=3.0.0",
+    "numpy",
+]
+authors = [
+    { name = "Stoupy51", email = "stoupy51@gmail.com" },
+]
+
+[project.optional-dependencies]
+docs = [
+    "m2r2",
+    "myst_parser",
+    "sphinx_copybutton",
+    "sphinx_design",
+    "sphinx_treeview",
+    "sphinx_breeze_theme",
+    "pydata_sphinx_theme",
+]
+data_science = [
+    "opencv-python",
+    "scikit-image",
+    "simpleitk",
+    "mlflow",
+    "tensorflow",
+    "scikit-learn",
+    "PyWavelets",
+]
+
+[project.urls]
+Homepage = "https://stoupy51.github.io/stouputils"
+Issues = "https://github.com/Stoupy51/stouputils/issues"
+Source = "https://github.com/Stoupy51/stouputils"
+
+[project.scripts]
+stouputils = "stouputils.__main__:main"
+
+[tool.pyright]
+typeCheckingMode = "strict"
+
+[tool.ruff]
+exclude = [
+    ".git",
+    ".ruff_cache",
+    ".venv",
+    ".vscode",
+    ".cursor",
+    "build",
+    "dist",
+    "*.pyi",
+]
+line-length = 200
+
+[tool.ruff.lint]
+select = [
+    "E",
+    "W",
+    "F",
+    "I",
+    "N",
+    "UP",
+    "B",
+    "C4",
+    "T20",
+    "RUF",
+]
+ignore = [
+    "T201",
+    "W191",
+    "N803",
+    "N806",
+    "F403",
+    "F405",
+]
+

{stouputils-1.13.2 → stouputils-1.14.0}/stouputils/data_science/config/get.py

@@ -1,51 +1,51 @@
-""" Load configuration from the set.py file and handle some special cases.
-
-Proper way to get the configuration is by importing this module, not the set.py file directly.
-"""
-
-# pyright: reportUnknownMemberType=false
-# pyright: reportUnknownVariableType=false
-# pyright: reportMissingTypeStubs=false
-
-# Imports
-import os
-from typing import Any
-
-from .set import DataScienceConfig
-
-# Special cases
-# Hide GPU when using CPU
-if DataScienceConfig.TENSORFLOW_DEVICE.lower().startswith("/cpu"):
-	os.environ["CUDA_VISIBLE_DEVICES"] = "-1"
-
-# Precise which GPU we use
-elif DataScienceConfig.TENSORFLOW_DEVICE.lower().startswith("/gpu"):
-	os.environ["CUDA_VISIBLE_DEVICES"] = DataScienceConfig.TENSORFLOW_DEVICE.split(":")[-1]
-
-	# Configure TensorFlow (if available)
-	try:
-		from tensorflow import config as tf_config
-
-		# Get the physical devices
-		physical_devices: list[Any] = tf_config.list_physical_devices("GPU")
-
-		# Configure TensorFlow GPU memory management to allocate memory dynamically
-		# This prevents TensorFlow from allocating all GPU memory upfront
-		# Instead, memory will grow as needed, allowing better resource sharing
-		for device in physical_devices:
-			tf_config.experimental.set_memory_growth(device, True)
-
-		# Disable eager execution mode in TensorFlow
-		# This improves performance by allowing TensorFlow to create an optimized graph
-		# of operations instead of executing operations one by one (at the cost of debugging difficulty)
-		tf_config.run_functions_eagerly(False)
-	except ImportError:
-		pass
-
-	# Enable mixed precision training (if available)
-	try:
-		from keras import mixed_precision
-		mixed_precision.set_global_policy(DataScienceConfig.MIXED_PRECISION_POLICY)
-	except ImportError:
-		pass
-
+""" Load configuration from the set.py file and handle some special cases.
+
+Proper way to get the configuration is by importing this module, not the set.py file directly.
+"""
+
+# pyright: reportUnknownMemberType=false
+# pyright: reportUnknownVariableType=false
+# pyright: reportMissingTypeStubs=false
+
+# Imports
+import os
+from typing import Any
+
+from .set import DataScienceConfig
+
+# Special cases
+# Hide GPU when using CPU
+if DataScienceConfig.TENSORFLOW_DEVICE.lower().startswith("/cpu"):
+	os.environ["CUDA_VISIBLE_DEVICES"] = "-1"
+
+# Precise which GPU we use
+elif DataScienceConfig.TENSORFLOW_DEVICE.lower().startswith("/gpu"):
+	os.environ["CUDA_VISIBLE_DEVICES"] = DataScienceConfig.TENSORFLOW_DEVICE.split(":")[-1]
+
+	# Configure TensorFlow (if available)
+	try:
+		from tensorflow import config as tf_config
+
+		# Get the physical devices
+		physical_devices: list[Any] = tf_config.list_physical_devices("GPU")
+
+		# Configure TensorFlow GPU memory management to allocate memory dynamically
+		# This prevents TensorFlow from allocating all GPU memory upfront
+		# Instead, memory will grow as needed, allowing better resource sharing
+		for device in physical_devices:
+			tf_config.experimental.set_memory_growth(device, True)
+
+		# Disable eager execution mode in TensorFlow
+		# This improves performance by allowing TensorFlow to create an optimized graph
+		# of operations instead of executing operations one by one (at the cost of debugging difficulty)
+		tf_config.run_functions_eagerly(False)
+	except ImportError:
+		pass
+
+	# Enable mixed precision training (if available)
+	try:
+		from keras import mixed_precision
+		mixed_precision.set_global_policy(DataScienceConfig.MIXED_PRECISION_POLICY)
+	except ImportError:
+		pass
+

{stouputils-1.13.2 → stouputils-1.14.0}/stouputils/data_science/data_processing/image/__init__.py

@@ -1,66 +1,66 @@
-
-# Imports
-from .auto_contrast import auto_contrast_image
-from .axis_flip import flip_image
-from .bias_field_correction import bias_field_correction_image
-from .binary_threshold import binary_threshold_image
-from .blur import blur_image
-from .brightness import brightness_image
-from .canny import canny_image
-from .clahe import clahe_image
-from .contrast import contrast_image
-from .curvature_flow_filter import curvature_flow_filter_image
-from .denoise import (
-    adaptive_denoise_image,
-    bilateral_denoise_image,
-    nlm_denoise_image,
-    tv_denoise_image,
-    wavelet_denoise_image,
-)
-from .invert import invert_image
-from .laplacian import laplacian_image
-from .median_blur import median_blur_image
-from .noise import noise_image
-from .normalize import normalize_image
-from .random_erase import random_erase_image
-from .resize import resize_image
-from .rotation import rotate_image
-from .salt_pepper import salt_pepper_image
-from .sharpening import sharpen_image
-from .shearing import shear_image
-from .threshold import threshold_image
-from .translation import translate_image
-from .zoom import zoom_image
-
-__all__ = [
-    "adaptive_denoise_image",
-    "auto_contrast_image",
-    "bias_field_correction_image",
-    "bilateral_denoise_image",
-    "binary_threshold_image",
-    "blur_image",
-    "brightness_image",
-    "canny_image",
-    "clahe_image",
-    "contrast_image",
-    "curvature_flow_filter_image",
-    "flip_image",
-    "invert_image",
-    "laplacian_image",
-    "median_blur_image",
-    "nlm_denoise_image",
-    "noise_image",
-    "normalize_image",
-    "random_erase_image",
-    "resize_image",
-    "rotate_image",
-    "salt_pepper_image",
-    "sharpen_image",
-    "shear_image",
-    "threshold_image",
-    "translate_image",
-    "tv_denoise_image",
-    "wavelet_denoise_image",
-    "zoom_image",
-]
-
+
+# Imports
+from .auto_contrast import auto_contrast_image
+from .axis_flip import flip_image
+from .bias_field_correction import bias_field_correction_image
+from .binary_threshold import binary_threshold_image
+from .blur import blur_image
+from .brightness import brightness_image
+from .canny import canny_image
+from .clahe import clahe_image
+from .contrast import contrast_image
+from .curvature_flow_filter import curvature_flow_filter_image
+from .denoise import (
+    adaptive_denoise_image,
+    bilateral_denoise_image,
+    nlm_denoise_image,
+    tv_denoise_image,
+    wavelet_denoise_image,
+)
+from .invert import invert_image
+from .laplacian import laplacian_image
+from .median_blur import median_blur_image
+from .noise import noise_image
+from .normalize import normalize_image
+from .random_erase import random_erase_image
+from .resize import resize_image
+from .rotation import rotate_image
+from .salt_pepper import salt_pepper_image
+from .sharpening import sharpen_image
+from .shearing import shear_image
+from .threshold import threshold_image
+from .translation import translate_image
+from .zoom import zoom_image
+
+__all__ = [
+    "adaptive_denoise_image",
+    "auto_contrast_image",
+    "bias_field_correction_image",
+    "bilateral_denoise_image",
+    "binary_threshold_image",
+    "blur_image",
+    "brightness_image",
+    "canny_image",
+    "clahe_image",
+    "contrast_image",
+    "curvature_flow_filter_image",
+    "flip_image",
+    "invert_image",
+    "laplacian_image",
+    "median_blur_image",
+    "nlm_denoise_image",
+    "noise_image",
+    "normalize_image",
+    "random_erase_image",
+    "resize_image",
+    "rotate_image",
+    "salt_pepper_image",
+    "sharpen_image",
+    "shear_image",
+    "threshold_image",
+    "translate_image",
+    "tv_denoise_image",
+    "wavelet_denoise_image",
+    "zoom_image",
+]
+

{stouputils-1.13.2 → stouputils-1.14.0}/stouputils/data_science/data_processing/image/auto_contrast.py

@@ -1,79 +1,79 @@
-
-# pyright: reportUnusedImport=false
-# ruff: noqa: F401
-
-# Imports
-from .common import Any, NDArray, check_image, cv2, np
-
-
-# Functions
-def auto_contrast_image(image: NDArray[Any], ignore_dtype: bool = False) -> NDArray[Any]:
-	""" Adjust the contrast of an image.
-
-	Args:
-		image         (NDArray[Any]):  Image to adjust contrast
-		ignore_dtype  (bool):        Ignore the dtype check
-	Returns:
-		NDArray[Any]: Image with adjusted contrast
-
-	>>> ## Basic tests
-	>>> image = np.array([[1, 2, 3], [4, 5, 6], [7, 8, 9]], dtype=np.uint8)
-	>>> adjusted = auto_contrast_image(image)
-	>>> adjusted.tolist()
-	[[0, 36, 73], [109, 146, 182], [219, 255, 255]]
-	>>> adjusted.shape == image.shape
-	True
-	>>> adjusted.dtype == image.dtype
-	True
-
-	>>> ## Test invalid inputs
-	>>> auto_contrast_image("not an image")
-	Traceback (most recent call last):
-		...
-	AssertionError: Image must be a numpy array
-	"""
-	# Check input data
-	check_image(image, ignore_dtype=ignore_dtype)
-
-	# Perform histogram clipping
-	clip_hist_percent: float = 1.0
-
-	# Calculate the histogram of the image
-	hist: NDArray[Any] = cv2.calcHist([image], [0], None, [256], [0, 256])
-
-	# Create an accumulator list to store the cumulative histogram
-	accumulator: list[float] = []
-	accumulator.append(hist[0])
-	for i in range(1, 256):
-		accumulator.append(accumulator[i - 1] + hist[i])
-
-	# Find the maximum value in the accumulator
-	max_value: float = accumulator[-1]
-
-	# Calculate the clipping threshold
-	clip_hist_percent = clip_hist_percent * (max_value / 100.0)
-	clip_hist_percent = clip_hist_percent / 2.0
-
-	# Find the minimum and maximum gray levels after clipping
-	min_gray: int = 0
-	while accumulator[min_gray] < clip_hist_percent:
-		min_gray = min_gray + 1
-	max_gray: int = 256 - 1
-	while (max_gray >= 0 and accumulator[max_gray] >= (max_value - clip_hist_percent)):
-		max_gray = max_gray - 1
-
-	# Calculate the input range after clipping
-	input_range: int = max_gray - min_gray
-
-	# If the input range is 0, return the original image
-	if input_range == 0:
-		return image
-
-	# Calculate the scaling factors for contrast adjustment
-	alpha: float = (256 - 1) / input_range
-	beta: float = -min_gray * alpha
-
-	# Apply the contrast adjustment
-	adjusted: NDArray[Any] = cv2.convertScaleAbs(image, alpha=alpha, beta=beta)
-	return adjusted
-
+
+# pyright: reportUnusedImport=false
+# ruff: noqa: F401
+
+# Imports
+from .common import Any, NDArray, check_image, cv2, np
+
+
+# Functions
+def auto_contrast_image(image: NDArray[Any], ignore_dtype: bool = False) -> NDArray[Any]:
+	""" Adjust the contrast of an image.
+
+	Args:
+		image         (NDArray[Any]):  Image to adjust contrast
+		ignore_dtype  (bool):        Ignore the dtype check
+	Returns:
+		NDArray[Any]: Image with adjusted contrast
+
+	>>> ## Basic tests
+	>>> image = np.array([[1, 2, 3], [4, 5, 6], [7, 8, 9]], dtype=np.uint8)
+	>>> adjusted = auto_contrast_image(image)
+	>>> adjusted.tolist()
+	[[0, 36, 73], [109, 146, 182], [219, 255, 255]]
+	>>> adjusted.shape == image.shape
+	True
+	>>> adjusted.dtype == image.dtype
+	True
+
+	>>> ## Test invalid inputs
+	>>> auto_contrast_image("not an image")
+	Traceback (most recent call last):
+		...
+	AssertionError: Image must be a numpy array
+	"""
+	# Check input data
+	check_image(image, ignore_dtype=ignore_dtype)
+
+	# Perform histogram clipping
+	clip_hist_percent: float = 1.0
+
+	# Calculate the histogram of the image
+	hist: NDArray[Any] = cv2.calcHist([image], [0], None, [256], [0, 256])
+
+	# Create an accumulator list to store the cumulative histogram
+	accumulator: list[float] = []
+	accumulator.append(hist[0])
+	for i in range(1, 256):
+		accumulator.append(accumulator[i - 1] + hist[i])
+
+	# Find the maximum value in the accumulator
+	max_value: float = accumulator[-1]
+
+	# Calculate the clipping threshold
+	clip_hist_percent = clip_hist_percent * (max_value / 100.0)
+	clip_hist_percent = clip_hist_percent / 2.0
+
+	# Find the minimum and maximum gray levels after clipping
+	min_gray: int = 0
+	while accumulator[min_gray] < clip_hist_percent:
+		min_gray = min_gray + 1
+	max_gray: int = 256 - 1
+	while (max_gray >= 0 and accumulator[max_gray] >= (max_value - clip_hist_percent)):
+		max_gray = max_gray - 1
+
+	# Calculate the input range after clipping
+	input_range: int = max_gray - min_gray
+
+	# If the input range is 0, return the original image
+	if input_range == 0:
+		return image
+
+	# Calculate the scaling factors for contrast adjustment
+	alpha: float = (256 - 1) / input_range
+	beta: float = -min_gray * alpha
+
+	# Apply the contrast adjustment
+	adjusted: NDArray[Any] = cv2.convertScaleAbs(image, alpha=alpha, beta=beta)
+	return adjusted
+