Files
kornia--kornia/tests/enhance/test_equalization.py
T
wehub-resource-sync 3a2c66702c
Tests on CPU (scheduled) / check-skip (push) Has been cancelled
Tests on CPU (scheduled) / pre-tests (push) Has been cancelled
Tests on CPU (scheduled) / tests-cpu-ubuntu (float32) (push) Has been cancelled
Tests on CPU (scheduled) / tests-cpu-ubuntu (float64) (push) Has been cancelled
Tests on CPU (scheduled) / tests-cpu-windows (3.11, float32, 2.5.1) (push) Has been cancelled
Tests on CPU (scheduled) / tests-cpu-windows (3.11, float32, 2.9.1) (push) Has been cancelled
Tests on CPU (scheduled) / tests-cpu-windows (3.11, float64, 2.5.1) (push) Has been cancelled
Tests on CPU (scheduled) / tests-cpu-windows (3.11, float64, 2.9.1) (push) Has been cancelled
Tests on CPU (scheduled) / tests-cpu-windows (3.12, float32, 2.5.1) (push) Has been cancelled
Tests on CPU (scheduled) / tests-cpu-windows (3.12, float32, 2.9.1) (push) Has been cancelled
Tests on CPU (scheduled) / tests-cpu-windows (3.12, float64, 2.5.1) (push) Has been cancelled
Tests on CPU (scheduled) / tests-cpu-windows (3.12, float64, 2.9.1) (push) Has been cancelled
Tests on CPU (scheduled) / tests-cpu-windows (3.13, float32, 2.9.1) (push) Has been cancelled
Tests on CPU (scheduled) / tests-cpu-windows (3.13, float64, 2.9.1) (push) Has been cancelled
Tests on CPU (scheduled) / tests-cpu-mac (3.11, float32, 2.5.1) (push) Has been cancelled
Tests on CPU (scheduled) / tests-cpu-mac (3.11, float32, 2.9.1) (push) Has been cancelled
Tests on CPU (scheduled) / tests-cpu-mac (3.12, float32, 2.5.1) (push) Has been cancelled
Tests on CPU (scheduled) / tests-cpu-mac (3.12, float32, 2.9.1) (push) Has been cancelled
Tests on CPU (scheduled) / tests-cpu-mac (3.13, float32, 2.9.1) (push) Has been cancelled
Tests on CPU (scheduled) / coverage (push) Has been cancelled
Tests on CPU (scheduled) / typing (push) Has been cancelled
Tests on CPU (scheduled) / tutorials (push) Has been cancelled
Tests on CPU (scheduled) / docs (push) Has been cancelled
Lint / TOML Format (push) Has been cancelled
chore: import upstream snapshot with attribution
2026-07-13 12:49:27 +08:00

272 lines
9.6 KiB
Python

# LICENSE HEADER MANAGED BY add-license-header
#
# Copyright 2018 Kornia Team
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
#
from typing import Tuple
import pytest
import torch
from kornia import enhance
from kornia.geometry import rotate
from testing.base import BaseTester
class TestEqualization(BaseTester):
def test_smoke(self, device, dtype):
C, H, W = 1, 10, 20
img = torch.rand(C, H, W, device=device, dtype=dtype)
res = enhance.equalize_clahe(img)
assert isinstance(res, torch.Tensor)
assert res.shape == img.shape
assert res.device == img.device
assert res.dtype == img.dtype
@pytest.mark.parametrize("B, C", [(None, 1), (None, 3), (1, 1), (1, 3), (4, 1), (4, 3)])
def test_cardinality(self, B, C, device, dtype):
H, W = 10, 20
if B is None:
img = torch.rand(C, H, W, device=device, dtype=dtype)
else:
img = torch.rand(B, C, H, W, device=device, dtype=dtype)
res = enhance.equalize_clahe(img)
assert res.shape == img.shape
@pytest.mark.parametrize("clip, grid", [(0.0, None), (None, (2, 2)), (2.0, (2, 2))])
def test_optional_params(self, clip, grid, device, dtype):
C, H, W = 1, 10, 20
img = torch.rand(C, H, W, device=device, dtype=dtype)
if clip is None:
res = enhance.equalize_clahe(img, grid_size=grid)
elif grid is None:
res = enhance.equalize_clahe(img, clip_limit=clip)
else:
res = enhance.equalize_clahe(img, clip, grid)
assert isinstance(res, torch.Tensor)
assert res.shape == img.shape
@pytest.mark.parametrize(
"B, clip, grid, exception_type, expected_error_msg",
[
(0, 1.0, (2, 2), ValueError, "Invalid input tensor, it is empty."), # from perform_keep_shape_image
(1, 1, (2, 2), TypeError, "Input clip_limit type is not float. Got"),
(1, 2.0, 2, TypeError, "Input grid_size type is not Tuple. Got"),
(1, 2.0, (2, 2, 2), TypeError, "Input grid_size is not a Tuple with 2 elements. Got 3"),
(1, 2.0, (2, 2.0), TypeError, "Input grid_size type is not valid, must be a Tuple[int, int]"),
(1, 2.0, (2, 0), ValueError, "Input grid_size elements must be positive. Got"),
],
)
def test_exception(self, B, clip, grid, exception_type, expected_error_msg):
C, H, W = 1, 10, 20
img = torch.rand(B, C, H, W)
with pytest.raises(exception_type) as errinfo:
enhance.equalize_clahe(img, clip, grid)
assert expected_error_msg in str(errinfo)
@pytest.mark.parametrize("dims", [(1, 1, 1, 1, 1), (1, 1)])
def test_exception_tensor_dims(self, dims):
img = torch.rand(dims)
with pytest.raises(ValueError):
enhance.equalize_clahe(img)
def test_exception_tensor_type(self):
with pytest.raises(TypeError):
enhance.equalize_clahe([1, 2, 3])
def test_gradcheck(self, device):
torch.random.manual_seed(4)
bs, channels, height, width = 1, 1, 11, 11
inputs = torch.rand(bs, channels, height, width, device=device, dtype=torch.float64)
def grad_rot(data, a, b, c):
rot = rotate(data, torch.tensor(30.0, dtype=data.dtype, device=device))
return enhance.equalize_clahe(rot, a, b, c)
self.gradcheck(grad_rot, (inputs, 40.0, (2, 2), True), nondet_tol=1e-4)
@pytest.mark.skip(reason="args and kwargs in decorator")
def test_jit(self, device, dtype):
batch_size, channels, height, width = 1, 2, 10, 20
inp = torch.rand(batch_size, channels, height, width, device=device, dtype=dtype)
op = enhance.equalize_clahe
op_script = torch.jit.script(op)
self.assert_close(op(inp), op_script(inp))
def test_module(self):
# equalize_clahe is only a function
pass
@pytest.fixture()
def img(self, device, dtype):
height, width = 20, 20
# TODO: test with a more realistic pattern
img = torch.arange(width, device=device).div(float(width - 1))[None].expand(height, width)[None][None]
return img
def test_he(self, img):
# should be similar to enhance.equalize but slower. Similar because the lut is computed in a different way.
clip_limit: float = 0.0
grid_size: Tuple = (1, 1)
res = enhance.equalize_clahe(img, clip_limit=clip_limit, grid_size=grid_size)
# NOTE: for next versions we need to improve the computation of the LUT
# and test with a better image
self.assert_close(
res[..., 0, :],
torch.tensor(
[
[
[
0.0471,
0.0980,
0.1490,
0.2000,
0.2471,
0.2980,
0.3490,
0.3490,
0.4471,
0.4471,
0.5490,
0.5490,
0.6471,
0.6471,
0.6980,
0.7490,
0.8000,
0.8471,
0.8980,
1.0000,
]
]
],
dtype=res.dtype,
device=res.device,
),
low_tolerance=True,
)
def test_ahe(self, img):
clip_limit: float = 0.0
grid_size: Tuple = (8, 8)
res = enhance.equalize_clahe(img, clip_limit=clip_limit, grid_size=grid_size)
# NOTE: for next versions we need to improve the computation of the LUT
# and test with a better image
self.assert_close(
res[..., 0, :],
torch.tensor(
[
[
[
0.2471,
0.4980,
0.7490,
0.6667,
0.4980,
0.4980,
0.7490,
0.4993,
0.4980,
0.2471,
0.7490,
0.4993,
0.4980,
0.2471,
0.4980,
0.4993,
0.3333,
0.2471,
0.4980,
1.0000,
]
]
],
dtype=res.dtype,
device=res.device,
),
low_tolerance=True,
)
def test_clahe(self, img):
clip_limit: float = 2.0
grid_size: Tuple = (8, 8)
res = enhance.equalize_clahe(img, clip_limit=clip_limit, grid_size=grid_size)
res_diff = enhance.equalize_clahe(img, clip_limit=clip_limit, grid_size=grid_size, slow_and_differentiable=True)
# NOTE: for next versions we need to improve the computation of the LUT
# and test with a better image
expected = torch.tensor(
[
[
[
0.1216,
0.8745,
0.9373,
0.9163,
0.8745,
0.8745,
0.9373,
0.8745,
0.8745,
0.8118,
0.9373,
0.8745,
0.8745,
0.8118,
0.8745,
0.8745,
0.8327,
0.8118,
0.8745,
1.0000,
]
]
],
dtype=res.dtype,
device=res.device,
)
exp_diff = torch.tensor(
[
[
[
0.1250,
0.8752,
0.9042,
0.9167,
0.8401,
0.8852,
0.9302,
0.9120,
0.8750,
0.8370,
0.9620,
0.9077,
0.8750,
0.8754,
0.9204,
0.9167,
0.8370,
0.8806,
0.9096,
1.0000,
]
]
],
dtype=res.dtype,
device=res.device,
)
self.assert_close(res[..., 0, :], expected, low_tolerance=True)
self.assert_close(res_diff[..., 0, :], exp_diff, low_tolerance=True)