endoscopy-specular 0.1.0__tar.gz

endoscopy_specular-0.1.0/PKG-INFO

@@ -0,0 +1,31 @@
+Metadata-Version: 2.4
+Name: endoscopy_specular
+Version: 0.1.0
+Summary: Hessian-based specular reflection detection in endoscopy images
+Author: Khaled ELKarazle
+Project-URL: Homepage, https://github.com/KhaledELKarazle97/endoscopy-specular
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy
+Requires-Dist: opencv-python
+Dynamic: license-file
+
+## Overview
+
+This is a re-implementation of a Hessian-guided
+specular reflection detection method in HSV color space, originally
+described in IEEE JBHI (2024).
+
+## Method
+
+- HSV conversion
+- S-channel smoothing
+- Hessian eigenvalue analysis
+- Photometric constraints (S, V thresholds)
+- Binary mask output
+
+## Reference
+If you use this package, please cite:
+
+ElKarazle, K., Raman, V., Chua, C., Then, P. "A Hessian-Based Technique for Specular Reflection Detection and Inpainting in Colonoscopy Images" IEEE Journal of Biomedical and Health Informatics, 2024. DOI: 10.1109/JBHI.2024.3404955

endoscopy_specular-0.1.0/README.md

@@ -0,0 +1,18 @@
+## Overview
+
+This is a re-implementation of a Hessian-guided
+specular reflection detection method in HSV color space, originally
+described in IEEE JBHI (2024).
+
+## Method
+
+- HSV conversion
+- S-channel smoothing
+- Hessian eigenvalue analysis
+- Photometric constraints (S, V thresholds)
+- Binary mask output
+
+## Reference
+If you use this package, please cite:
+
+ElKarazle, K., Raman, V., Chua, C., Then, P. "A Hessian-Based Technique for Specular Reflection Detection and Inpainting in Colonoscopy Images" IEEE Journal of Biomedical and Health Informatics, 2024. DOI: 10.1109/JBHI.2024.3404955

endoscopy_specular-0.1.0/pyproject.toml

@@ -0,0 +1,22 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "endoscopy_specular"
+version = "0.1.0"
+description = "Hessian-based specular reflection detection in endoscopy images"
+readme = "README.md"
+requires-python = ">=3.8"
+
+dependencies = [
+    "numpy",
+    "opencv-python"
+]
+
+authors = [
+    {name = "Khaled ELKarazle"}
+]
+
+[project.urls]
+Homepage = "https://github.com/KhaledELKarazle97/endoscopy-specular"

endoscopy_specular-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

endoscopy_specular-0.1.0/src/endoscopy_specular/__init__.py

@@ -0,0 +1,2 @@
+from .core import detect_specular_reflection
+__all__ = ["detect_specular_reflection"]

endoscopy_specular-0.1.0/src/endoscopy_specular/core.py

@@ -0,0 +1,22 @@
+
+import numpy as np
+import cv2
+
+def detect_specular_reflection(image_bgr: np.ndarray) -> np.ndarray:
+    orig_h, orig_w = image_bgr.shape[:2]
+    img_resized = cv2.resize(image_bgr, (128, 128))
+    img_float = img_resized.astype(np.float32) / 255.0
+    img_hsv = cv2.cvtColor(img_float, cv2.COLOR_BGR2HSV)
+    _, S, V = img_hsv[..., 0], img_hsv[..., 1], img_hsv[..., 2]
+    S_smooth = cv2.GaussianBlur(S, (0, 0), sigmaX=5.0)
+    Sxx = cv2.Sobel(S_smooth, cv2.CV_32F, dx=2, dy=0, ksize=5) / 16.0
+    Syy = cv2.Sobel(S_smooth, cv2.CV_32F, dx=0, dy=2, ksize=5) / 16.0
+    Sxy = cv2.Sobel(S_smooth, cv2.CV_32F, dx=1, dy=1, ksize=5) / 16.0
+    trace = Sxx + Syy
+    disc = np.sqrt(np.maximum((Sxx - Syy) ** 2 + 4.0 * Sxy ** 2, 0.0))
+    lambda1 = (trace + disc) / 2.0
+    lambda2 = (trace - disc) / 2.0
+    hessian_gate = (lambda1 >= 0) & (lambda2 >= 0)
+    base_mask = hessian_gate & (V > 0.35) & (S < 0.25)
+    mask_rescaled = (base_mask.astype(np.uint8) * 255)
+    return cv2.resize(mask_rescaled, (orig_w, orig_h), interpolation=cv2.INTER_NEAREST)

endoscopy_specular-0.1.0/src/endoscopy_specular.egg-info/PKG-INFO

@@ -0,0 +1,31 @@
+Metadata-Version: 2.4
+Name: endoscopy_specular
+Version: 0.1.0
+Summary: Hessian-based specular reflection detection in endoscopy images
+Author: Khaled ELKarazle
+Project-URL: Homepage, https://github.com/KhaledELKarazle97/endoscopy-specular
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy
+Requires-Dist: opencv-python
+Dynamic: license-file
+
+## Overview
+
+This is a re-implementation of a Hessian-guided
+specular reflection detection method in HSV color space, originally
+described in IEEE JBHI (2024).
+
+## Method
+
+- HSV conversion
+- S-channel smoothing
+- Hessian eigenvalue analysis
+- Photometric constraints (S, V thresholds)
+- Binary mask output
+
+## Reference
+If you use this package, please cite:
+
+ElKarazle, K., Raman, V., Chua, C., Then, P. "A Hessian-Based Technique for Specular Reflection Detection and Inpainting in Colonoscopy Images" IEEE Journal of Biomedical and Health Informatics, 2024. DOI: 10.1109/JBHI.2024.3404955

endoscopy_specular-0.1.0/src/endoscopy_specular.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+LICENSE
+README.md
+pyproject.toml
+src/endoscopy_specular/__init__.py
+src/endoscopy_specular/core.py
+src/endoscopy_specular/utils.py
+src/endoscopy_specular.egg-info/PKG-INFO
+src/endoscopy_specular.egg-info/SOURCES.txt
+src/endoscopy_specular.egg-info/dependency_links.txt
+src/endoscopy_specular.egg-info/requires.txt
+src/endoscopy_specular.egg-info/top_level.txt
+test/test_core.py

endoscopy_specular-0.1.0/src/endoscopy_specular.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

endoscopy_specular-0.1.0/src/endoscopy_specular.egg-info/requires.txt

@@ -0,0 +1,2 @@
+numpy
+opencv-python

endoscopy_specular-0.1.0/src/endoscopy_specular.egg-info/top_level.txt

@@ -0,0 +1 @@
+endoscopy_specular

endoscopy_specular-0.1.0/test/test_core.py

@@ -0,0 +1,12 @@
+import numpy as np
+import cv2
+from endoscopy_specular import detect_specular_reflection
+
+def test_runs_without_crashing():
+    img = np.random.randint(0, 255, (256, 256, 3), dtype=np.uint8)
+
+    mask = detect_specular_reflection(img)
+
+    assert mask is not None
+    assert mask.shape == (256, 256)
+    assert mask.dtype == np.uint8