Skip to content

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__.py
index 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.py
index f6fe140..ab43ded 100644
--- a/backend/app/nodes/color.py
+++ b/backend/app/nodes/color.py
@@ -8,7 +8,13 @@ import cv2
import numpy as np
from 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.py
new file mode 100644
index 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.py
index 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",