Image Pipeline Playground
feat(backend/nodes): add find contours analysis node
Mohammad Rajaeidc71fde67aba
diff --git a/backend/app/nodes/__init__.py b/backend/app/nodes/__init__.pyindex 11c1c98..ef09db5 100644--- a/backend/app/nodes/__init__.py+++ b/backend/app/nodes/__init__.py@@ -29,6 +29,7 @@ from app.nodes.geometry import CropNode, FlipNode, ResizeNode, RotateNodefrom app.nodes.io import LoadImageNode, PreviewNode, SaveImageNodefrom app.nodes.morphology import DilateNode, ErodeNode, MorphologyExNodefrom app.nodes.stochastic import GaussianNoiseNode, RandomBrightnessContrastNode+from app.nodes.structure import FindContoursNode_REGISTERED = False@@ -59,6 +60,7 @@ def register_builtin_nodes() -> None:AdaptiveThresholdNode(),DistanceTransformNode(),HistogramEqualizeNode(),+ FindContoursNode(),ErodeNode(),DilateNode(),MorphologyExNode(),diff --git a/backend/app/nodes/structure.py b/backend/app/nodes/structure.pynew file mode 100644index 0000000..cfeab41--- /dev/null+++ b/backend/app/nodes/structure.py@@ -0,0 +1,137 @@+"""Contour and shape-structure nodes for imaging research."""++from __future__ import annotations++from typing import Any++import cv2+import numpy as np++from app.engine.registry import BaseNode+from app.nodes.common import image_in, image_out, int_param, require_image, select_param+++def _as_gray(image: np.ndarray) -> np.ndarray:+ if len(image.shape) == 2:+ return image+ if image.shape[2] == 4:+ return cv2.cvtColor(image, cv2.COLOR_BGRA2GRAY)+ return cv2.cvtColor(image, cv2.COLOR_BGR2GRAY)+++def _as_bgr(image: np.ndarray) -> np.ndarray:+ if len(image.shape) == 2:+ return cv2.cvtColor(image, cv2.COLOR_GRAY2BGR)+ if image.shape[2] == 4:+ return cv2.cvtColor(image, cv2.COLOR_BGRA2BGR)+ return image.copy()+++def _binary(image: np.ndarray) -> np.ndarray:+ gray = _as_gray(image)+ if set(np.unique(gray)).issubset({0, 255}):+ return gray+ _, binary = cv2.threshold(gray, 0, 255, cv2.THRESH_BINARY | cv2.THRESH_OTSU)+ return binary+++def _contour_mode(name: str) -> int:+ return {+ "external": cv2.RETR_EXTERNAL,+ "list": cv2.RETR_LIST,+ "tree": cv2.RETR_TREE,+ "ccomp": cv2.RETR_CCOMP,+ }.get(name, cv2.RETR_EXTERNAL)+++def _contour_method(name: str) -> int:+ return {+ "none": cv2.CHAIN_APPROX_NONE,+ "simple": cv2.CHAIN_APPROX_SIMPLE,+ "tc89_l1": cv2.CHAIN_APPROX_TC89_L1,+ "tc89_kcos": cv2.CHAIN_APPROX_TC89_KCOS,+ }.get(name, cv2.CHAIN_APPROX_SIMPLE)+++class FindContoursNode(BaseNode):+ type = "find_contours"+ label = "Find Contours"+ category = "analysis"+ description = "Detect contours on a binary/gray image and draw them for inspection."+ ports = [image_in(), image_out()]+ params = [+ select_param("mode", "Retrieval", "external", ["external", "list", "tree", "ccomp"]),+ select_param(+ "method",+ "Approx",+ "simple",+ ["none", "simple", "tc89_l1", "tc89_kcos"],+ ),+ int_param("thickness", "Thickness", 2, minimum=1, maximum=10),+ select_param("overlay", "Overlay", "on_input", ["on_input", "blank"]),+ ]++ def execute(+ self,+ inputs: dict[str, np.ndarray | list[np.ndarray] | None],+ params: dict[str, Any],+ seed: int = 0,+ ) -> dict[str, np.ndarray | list[np.ndarray]]:+ image = require_image(inputs)+ binary = _binary(image)+ contours, _ = cv2.findContours(+ binary,+ _contour_mode(str(params["mode"])),+ _contour_method(str(params["method"])),+ )+ if str(params["overlay"]) == "blank":+ canvas = np.zeros_like(_as_bgr(image))+ else:+ canvas = _as_bgr(image)+ cv2.drawContours(+ canvas,+ contours,+ -1,+ (0, 255, 128),+ int(params["thickness"]),+ )+ return {"image": canvas}++ def emit_python(+ self,+ node_id: str,+ params: dict[str, Any],+ input_vars: dict[str, str],+ output_vars: dict[str, str],+ ) -> list[str]:+ src = input_vars["image"]+ dst = output_vars["image"]+ mode = {+ "external": "cv2.RETR_EXTERNAL",+ "list": "cv2.RETR_LIST",+ "tree": "cv2.RETR_TREE",+ "ccomp": "cv2.RETR_CCOMP",+ }.get(str(params["mode"]), "cv2.RETR_EXTERNAL")+ method = {+ "none": "cv2.CHAIN_APPROX_NONE",+ "simple": "cv2.CHAIN_APPROX_SIMPLE",+ "tc89_l1": "cv2.CHAIN_APPROX_TC89_L1",+ "tc89_kcos": "cv2.CHAIN_APPROX_TC89_KCOS",+ }.get(str(params["method"]), "cv2.CHAIN_APPROX_SIMPLE")+ blank = str(params["overlay"]) == "blank"+ return [+ f"_gray = {src} if len({src}.shape) == 2 else cv2.cvtColor({src}, cv2.COLOR_BGR2GRAY)",+ "_uniq = set(np.unique(_gray).tolist())",+ "_bin = _gray if _uniq <= {0, 255} else "+ "cv2.threshold(_gray, 0, 255, cv2.THRESH_BINARY | cv2.THRESH_OTSU)[1]",+ f"_cnts, _ = cv2.findContours(_bin, {mode}, {method})",+ (+ f"{dst} = np.zeros((_gray.shape[0], _gray.shape[1], 3), dtype='uint8')"+ if blank+ else (+ f"{dst} = {src}.copy() if len({src}.shape) == 3 else "+ f"cv2.cvtColor({src}, cv2.COLOR_GRAY2BGR)"+ )+ ),+ f"cv2.drawContours({dst}, _cnts, -1, (0, 255, 128), {int(params['thickness'])})",+ ]diff --git a/backend/tests/test_nodes.py b/backend/tests/test_nodes.pyindex 92b253b..64c39d4 100644--- a/backend/tests/test_nodes.py+++ b/backend/tests/test_nodes.py@@ -32,6 +32,7 @@ def test_builtin_nodes_registered() -> None:"adaptive_threshold","distance_transform","histogram_equalize",+ "find_contours","erode","dilate","morphology_ex",diff --git a/backend/tests/test_structure_contours.py b/backend/tests/test_structure_contours.pynew file mode 100644index 0000000..8a33a7d--- /dev/null+++ b/backend/tests/test_structure_contours.py@@ -0,0 +1,27 @@+"""Tests for find-contours structure node."""++from __future__ import annotations++import numpy as np++from app.engine.registry import registry+from app.nodes import register_builtin_nodes+++def test_find_contours_registered() -> None:+ register_builtin_nodes()+ types = {meta.type for meta in registry.list_metadata()}+ assert "find_contours" in types+++def test_find_contours_draws_on_blob() -> None:+ register_builtin_nodes()+ image = np.zeros((48, 48), dtype=np.uint8)+ image[12:36, 12:36] = 255+ result = registry.get("find_contours").execute(+ {"image": image},+ {"mode": "external", "method": "simple", "thickness": 2, "overlay": "blank"},+ seed=0,+ )["image"]+ assert result.ndim == 3+ assert int(result.sum()) > 0