Image Pipeline Playground
feat(backend/nodes): add LAB invert CLAHE and brightness contrast
Mohammad Rajaeidea408f73687
diff --git a/backend/app/nodes/__init__.py b/backend/app/nodes/__init__.pyindex 59926ac..9efff28 100644--- a/backend/app/nodes/__init__.py+++ b/backend/app/nodes/__init__.py@@ -1,7 +1,16 @@"""Register all built-in OpenCV nodes."""from app.engine.registry import registry-from app.nodes.color import MergeChannelsNode, SplitChannelsNode, ToGrayNode, ToHsvNode+from app.nodes.color import (+ BrightnessContrastNode,+ ClaheNode,+ InvertNode,+ MergeChannelsNode,+ SplitChannelsNode,+ ToGrayNode,+ ToHsvNode,+ ToLabNode,+)from app.nodes.filters import (BilateralFilterNode,CannyNode,@@ -29,6 +38,10 @@ def register_builtin_nodes() -> None:PreviewNode(),ToGrayNode(),ToHsvNode(),+ ToLabNode(),+ InvertNode(),+ ClaheNode(),+ BrightnessContrastNode(),SplitChannelsNode(),MergeChannelsNode(),GaussianBlurNode(),diff --git a/backend/app/nodes/color.py b/backend/app/nodes/color.pyindex f6fe140..ab43ded 100644--- a/backend/app/nodes/color.py+++ b/backend/app/nodes/color.py@@ -8,7 +8,13 @@ import cv2import numpy as npfrom app.engine.registry import BaseNode-from app.nodes.common import image_in, image_out, require_image+from app.nodes.common import (+ image_in,+ image_out,+ int_param,+ number_param,+ require_image,+)class ToGrayNode(BaseNode):@@ -155,3 +161,150 @@ class MergeChannelsNode(BaseNode):f"{output_vars['image']} = cv2.merge(["f"{input_vars['b']}, {input_vars['g']}, {input_vars['r']}])"]+++class ToLabNode(BaseNode):+ type = "to_lab"+ label = "To LAB"+ category = "color"+ description = "Convert BGR to CIELAB (perceptually uniform color space)."+ ports = [image_in(), image_out()]+ params = []++ 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)+ if len(image.shape) == 2:+ image = cv2.cvtColor(image, cv2.COLOR_GRAY2BGR)+ return {"image": cv2.cvtColor(image, cv2.COLOR_BGR2LAB)}++ def emit_python(+ self,+ node_id: str,+ params: dict[str, Any],+ input_vars: dict[str, str],+ output_vars: dict[str, str],+ ) -> list[str]:+ return [f"{output_vars['image']} = cv2.cvtColor({input_vars['image']}, cv2.COLOR_BGR2LAB)"]+++class InvertNode(BaseNode):+ type = "invert"+ label = "Invert"+ category = "color"+ description = "Invert pixel intensities (photographic negative)."+ ports = [image_in(), image_out()]+ params = []++ 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]]:+ return {"image": cv2.bitwise_not(require_image(inputs))}++ def emit_python(+ self,+ node_id: str,+ params: dict[str, Any],+ input_vars: dict[str, str],+ output_vars: dict[str, str],+ ) -> list[str]:+ return [f"{output_vars['image']} = cv2.bitwise_not({input_vars['image']})"]+++class ClaheNode(BaseNode):+ type = "clahe"+ label = "CLAHE"+ category = "color"+ description = "Contrast Limited Adaptive Histogram Equalization on luminance."+ ports = [image_in(), image_out()]+ params = [+ number_param("clip_limit", "Clip Limit", 2.0, minimum=0.1, maximum=40.0, step=0.1),+ int_param("tile_grid", "Tile Grid", 8, minimum=2, maximum=32),+ ]++ 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)+ clahe = cv2.createCLAHE(+ clipLimit=float(params["clip_limit"]),+ tileGridSize=(int(params["tile_grid"]), int(params["tile_grid"])),+ )+ if len(image.shape) == 2:+ return {"image": clahe.apply(image)}+ lab = cv2.cvtColor(image, cv2.COLOR_BGR2LAB)+ l_chan, a_chan, b_chan = cv2.split(lab)+ merged = cv2.merge([clahe.apply(l_chan), a_chan, b_chan])+ return {"image": cv2.cvtColor(merged, cv2.COLOR_LAB2BGR)}++ 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"]+ clip = float(params["clip_limit"])+ tile = int(params["tile_grid"])+ return [+ f"_clahe = cv2.createCLAHE(clipLimit={clip}, tileGridSize=({tile}, {tile}))",+ f"if len({src}.shape) == 2:",+ f" {dst} = _clahe.apply({src})",+ "else:",+ f" _lab = cv2.cvtColor({src}, cv2.COLOR_BGR2LAB)",+ " _l, _a, _b = cv2.split(_lab)",+ " _merged = cv2.merge([_clahe.apply(_l), _a, _b])",+ f" {dst} = cv2.cvtColor(_merged, cv2.COLOR_LAB2BGR)",+ ]+++class BrightnessContrastNode(BaseNode):+ type = "brightness_contrast"+ label = "Brightness / Contrast"+ category = "color"+ description = "Deterministic brightness and contrast adjustment (alpha/beta)."+ ports = [image_in(), image_out()]+ params = [+ number_param("alpha", "Contrast", 1.0, minimum=0.0, maximum=3.0, step=0.05),+ number_param("beta", "Brightness", 0.0, minimum=-100.0, maximum=100.0, step=1.0),+ ]++ 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)+ return {+ "image": cv2.convertScaleAbs(+ image,+ alpha=float(params["alpha"]),+ beta=float(params["beta"]),+ )+ }++ def emit_python(+ self,+ node_id: str,+ params: dict[str, Any],+ input_vars: dict[str, str],+ output_vars: dict[str, str],+ ) -> list[str]:+ return [+ f"{output_vars['image']} = cv2.convertScaleAbs("+ f"{input_vars['image']}, alpha={float(params['alpha'])}, "+ f"beta={float(params['beta'])})"+ ]diff --git a/backend/tests/test_color_research.py b/backend/tests/test_color_research.pynew file mode 100644index 0000000..7c5098f--- /dev/null+++ b/backend/tests/test_color_research.py@@ -0,0 +1,34 @@+"""Tests for color / contrast research nodes."""++from __future__ import annotations++import numpy as np++from app.engine.registry import registry+from app.nodes import register_builtin_nodes+++def test_color_research_nodes_registered() -> None:+ register_builtin_nodes()+ types = {meta.type for meta in registry.list_metadata()}+ assert {"to_lab", "invert", "clahe", "brightness_contrast"}.issubset(types)+++def test_invert_is_involution() -> None:+ register_builtin_nodes()+ image = np.arange(16, dtype=np.uint8).reshape(4, 4)+ inverted = registry.get("invert").execute({"image": image}, {}, seed=0)["image"]+ restored = registry.get("invert").execute({"image": inverted}, {}, seed=0)["image"]+ assert np.array_equal(restored, image)+++def test_clahe_on_gray_changes_histogram() -> None:+ register_builtin_nodes()+ image = np.linspace(40, 180, 64 * 64, dtype=np.float32).reshape(64, 64).astype(np.uint8)+ result = registry.get("clahe").execute(+ {"image": image},+ {"clip_limit": 2.0, "tile_grid": 8},+ seed=0,+ )["image"]+ assert result.shape == image.shape+ assert not np.array_equal(result, image)diff --git a/backend/tests/test_nodes.py b/backend/tests/test_nodes.pyindex 3a055f2..c2012b2 100644--- a/backend/tests/test_nodes.py+++ b/backend/tests/test_nodes.py@@ -16,6 +16,10 @@ def test_builtin_nodes_registered() -> None:"preview","to_gray","to_hsv",+ "to_lab",+ "invert",+ "clahe",+ "brightness_contrast","split_channels","merge_channels","gaussian_blur",