Files
kornia--kornia/tests/enhance/test_normalize.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

388 lines
15 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.
#
import pytest
import torch
import kornia
from testing.base import BaseTester
class TestNormalize(BaseTester):
def test_smoke(self, device, dtype):
mean = [0.5]
std = [0.1]
repr = "Normalize(mean=tensor([[0.5000]]), std=tensor([[0.1000]]))"
assert str(kornia.enhance.Normalize(mean, std)) == repr
def test_normalize(self, device, dtype):
# prepare input data
data = torch.ones(1, 2, 2, device=device, dtype=dtype)
mean = torch.tensor([0.5], device=device, dtype=dtype)
std = torch.tensor([2.0], device=device, dtype=dtype)
# expected output
expected = torch.tensor([0.25], device=device, dtype=dtype).repeat(1, 2, 2).view_as(data)
f = kornia.enhance.Normalize(mean, std)
self.assert_close(f(data), expected)
def test_broadcast_normalize(self, device, dtype):
# prepare input data
data = torch.ones(2, 3, 1, 1, device=device, dtype=dtype)
data += 2
mean = torch.tensor([2.0], device=device, dtype=dtype)
std = torch.tensor([0.5], device=device, dtype=dtype)
# expected output
expected = torch.ones_like(data) + 1
f = kornia.enhance.Normalize(mean, std)
self.assert_close(f(data), expected)
def test_int_input(self, device, dtype):
data = torch.ones(2, 3, 1, 1, device=device, dtype=dtype)
data += 2
mean: int = 2
std: int = 1
# expected output
expected = torch.ones_like(data)
f = kornia.enhance.Normalize(mean, std)
self.assert_close(f(data), expected)
def test_float_input(self, device, dtype):
data = torch.ones(2, 3, 1, 1, device=device, dtype=dtype)
data += 2
mean: float = 2.0
std: float = 0.5
# expected output
expected = torch.ones_like(data) + 1
f = kornia.enhance.Normalize(mean, std)
self.assert_close(f(data), expected)
def test_batch_normalize(self, device, dtype):
# prepare input data
data = torch.ones(2, 3, 1, 1, device=device, dtype=dtype)
data += 2
mean = torch.tensor([0.5, 1.0, 2.0], device=device, dtype=dtype).repeat(2, 1)
std = torch.tensor([2.0, 2.0, 2.0], device=device, dtype=dtype).repeat(2, 1)
# expected output
expected = torch.tensor([1.25, 1, 0.5], device=device, dtype=dtype).repeat(2, 1, 1).view_as(data)
f = kornia.enhance.Normalize(mean, std)
self.assert_close(f(data), expected)
@pytest.mark.skip(reason="union type not supported")
def test_jit(self, device, dtype):
data = torch.ones(2, 3, 1, 1, device=device, dtype=dtype)
mean = torch.tensor([0.5, 1.0, 2.0], device=device, dtype=dtype).repeat(2, 1)
std = torch.tensor([2.0, 2.0, 2.0], device=device, dtype=dtype).repeat(2, 1)
inputs = (data, mean, std)
op = kornia.enhance.normalize
op_script = torch.jit.script(op)
self.assert_close(op(*inputs), op_script(*inputs))
def test_gradcheck(self, device):
# prepare input data
data = torch.ones(2, 3, 1, 1, device=device, dtype=torch.float64)
mean = torch.tensor([0.5, 1.0, 2.0], device=device, dtype=torch.float64).repeat(2, 1)
std = torch.tensor([2.0, 2.0, 2.0], device=device, dtype=torch.float64).repeat(2, 1)
self.gradcheck(kornia.enhance.Normalize(mean, std), (data,))
def test_single_value(self, device, dtype):
# prepare input data
mean = torch.tensor(2, device=device, dtype=dtype)
std = torch.tensor(3, device=device, dtype=dtype)
data = torch.ones(2, 3, 256, 313, device=device, dtype=dtype)
# expected output
expected = (data - mean) / std
self.assert_close(kornia.enhance.normalize(data, mean, std), expected)
def test_module(self, device, dtype):
data = torch.ones(2, 3, 1, 1, device=device, dtype=dtype)
mean = torch.tensor([0.5, 1.0, 2.0], device=device, dtype=dtype).repeat(2, 1)
std = torch.tensor([2.0, 2.0, 2.0], device=device, dtype=dtype).repeat(2, 1)
inputs = (data, mean, std)
op = kornia.enhance.normalize
op_module = kornia.enhance.Normalize(mean, std)
self.assert_close(op(*inputs), op_module(data))
@pytest.mark.parametrize(
"mean, std", [((1.0, 1.0, 1.0), (0.5, 0.5, 0.5)), (1.0, 0.5), (torch.tensor([1.0]), torch.tensor([0.5]))]
)
def test_random_normalize_different_parameter_types(self, mean, std):
f = kornia.enhance.Normalize(mean=mean, std=std)
data = torch.ones(2, 3, 256, 313)
if isinstance(mean, float):
expected = (data - torch.as_tensor(mean)) / torch.as_tensor(std)
else:
expected = (data - torch.as_tensor(mean[0])) / torch.as_tensor(std[0])
self.assert_close(f(data), expected)
@pytest.mark.parametrize("mean, std", [((1.0, 1.0, 1.0, 1.0), (0.5, 0.5, 0.5, 0.5)), ((1.0, 1.0), (0.5, 0.5))])
def test_random_normalize_invalid_parameter_shape(self, mean, std):
f = kornia.enhance.Normalize(mean=mean, std=std)
inputs = torch.arange(0.0, 16.0, step=1).reshape(1, 4, 4).unsqueeze(0)
with pytest.raises((ValueError, RuntimeError)):
f(inputs)
@pytest.mark.skip(reason="not implemented yet")
def test_cardinality(self, device, dtype):
pass
@pytest.mark.skip(reason="not implemented yet")
def test_exception(self, device, dtype):
pass
class TestDenormalize(BaseTester):
def test_smoke(self, device, dtype):
mean = [0.5]
std = [0.1]
repr = "Denormalize(mean=[0.5], std=[0.1])"
assert str(kornia.enhance.Denormalize(mean, std)) == repr
def test_denormalize(self, device, dtype):
# prepare input data
data = torch.ones(1, 2, 2, device=device, dtype=dtype)
mean = torch.tensor([0.5])
std = torch.tensor([2.0])
# expected output
expected = torch.tensor([2.5], device=device, dtype=dtype).repeat(1, 2, 2).view_as(data)
f = kornia.enhance.Denormalize(mean, std)
self.assert_close(f(data), expected)
def test_broadcast_denormalize(self, device, dtype):
# prepare input data
data = torch.ones(2, 3, 1, 1, device=device, dtype=dtype)
data += 2
mean = torch.tensor([2.0], device=device, dtype=dtype)
std = torch.tensor([0.5], device=device, dtype=dtype)
# expected output
expected = torch.ones_like(data) + 2.5
f = kornia.enhance.Denormalize(mean, std)
self.assert_close(f(data), expected)
def test_float_input(self, device, dtype):
data = torch.ones(2, 3, 1, 1, device=device, dtype=dtype)
data += 2
mean: float = 2.0
std: float = 0.5
# expected output
expected = torch.ones_like(data) + 2.5
f = kornia.enhance.Denormalize(mean, std)
self.assert_close(f(data), expected)
def test_batch_denormalize(self, device, dtype):
# prepare input data
data = torch.ones(2, 3, 1, 1, device=device, dtype=dtype)
data += 2
mean = torch.tensor([0.5, 1.0, 2.0], device=device, dtype=dtype).repeat(2, 1)
std = torch.tensor([2.0, 2.0, 2.0], device=device, dtype=dtype).repeat(2, 1)
# expected output
expected = torch.tensor([6.5, 7, 8], device=device, dtype=dtype).repeat(2, 1, 1).view_as(data)
f = kornia.enhance.Denormalize(mean, std)
self.assert_close(f(data), expected)
@pytest.mark.skip(reason="union type not supported")
def test_jit(self, device, dtype):
data = torch.ones(2, 3, 1, 1, device=device, dtype=dtype)
mean = torch.tensor([0.5, 1.0, 2.0], device=device, dtype=dtype).repeat(2, 1)
std = torch.tensor([2.0, 2.0, 2.0], device=device, dtype=dtype).repeat(2, 1)
inputs = (data, mean, std)
op = kornia.enhance.denormalize
op_script = torch.jit.script(op)
self.assert_close(op(*inputs), op_script(*inputs))
def test_gradcheck(self, device):
# prepare input data
data = torch.ones(2, 3, 1, 1, device=device, dtype=torch.float64)
data += 2
mean = torch.tensor([0.5, 1.0, 2.0], device=device, dtype=torch.float64)
std = torch.tensor([2.0, 2.0, 2.0], device=device, dtype=torch.float64)
self.gradcheck(kornia.enhance.Denormalize(mean, std), (data,))
def test_single_value(self, device, dtype):
# prepare input data
mean = torch.tensor(2, device=device, dtype=dtype)
std = torch.tensor(3, device=device, dtype=dtype)
data = torch.ones(2, 3, 256, 313, device=device, dtype=dtype)
# expected output
expected = (data * std) + mean
self.assert_close(kornia.enhance.denormalize(data, mean, std), expected)
def test_module(self, device, dtype):
data = torch.ones(2, 3, 1, 1, device=device, dtype=dtype)
mean = torch.tensor([0.5, 1.0, 2.0], device=device, dtype=dtype).repeat(2, 1)
std = torch.tensor([2.0, 2.0, 2.0], device=device, dtype=dtype).repeat(2, 1)
inputs = (data, mean, std)
op = kornia.enhance.denormalize
op_module = kornia.enhance.Denormalize(mean, std)
self.assert_close(op(*inputs), op_module(data))
@pytest.mark.skip(reason="not implemented yet")
def test_cardinality(self, device, dtype):
pass
@pytest.mark.skip(reason="not implemented yet")
def test_exception(self, device, dtype):
pass
class TestNormalizeMinMax(BaseTester):
def test_smoke(self, device, dtype):
x = torch.ones(1, 1, 1, 1, device=device, dtype=dtype)
assert kornia.enhance.normalize_min_max(x) is not None
assert kornia.enhance.normalize_min_max(x) is not None
def test_exception(self, device, dtype):
x = torch.ones(1, 1, 3, 4, device=device, dtype=dtype)
with pytest.raises(TypeError):
assert kornia.enhance.normalize_min_max(0.0)
with pytest.raises(TypeError):
assert kornia.enhance.normalize_min_max(x, "", "")
with pytest.raises(TypeError):
assert kornia.enhance.normalize_min_max(x, 2.0, "")
@pytest.mark.parametrize("input_shape", [(1, 2, 3, 4), (2, 1, 4, 3), (1, 3, 2, 1)])
def test_cardinality(self, device, dtype, input_shape):
x = torch.rand(input_shape, device=device, dtype=dtype)
assert kornia.enhance.normalize_min_max(x).shape == input_shape
@pytest.mark.parametrize("min_val, max_val", [(1.0, 2.0), (2.0, 3.0), (5.0, 20.0), (40.0, 1000.0)])
def test_range(self, device, dtype, min_val, max_val):
x = torch.rand(1, 2, 4, 5, device=device, dtype=dtype)
out = kornia.enhance.normalize_min_max(x, min_val=min_val, max_val=max_val)
self.assert_close(out.min(), torch.tensor(min_val, device=device, dtype=dtype), low_tolerance=True)
self.assert_close(out.max(), torch.tensor(max_val, device=device, dtype=dtype), low_tolerance=True)
def test_values(self, device, dtype):
x = torch.tensor([[[[0.0, 1.0, 3.0], [-1.0, 4.0, 3.0], [9.0, 5.0, 2.0]]]], device=device, dtype=dtype)
expected = torch.tensor(
[[[[-0.8, -0.6, -0.2], [-1.0, 0.0, -0.2], [1.0, 0.2, -0.4]]]], device=device, dtype=dtype
)
actual = kornia.enhance.normalize_min_max(x, min_val=-1.0, max_val=1.0)
self.assert_close(actual, expected, low_tolerance=True)
@pytest.mark.skip(reason="args and kwargs in decorator")
def test_jit(self, device, dtype):
x = torch.ones(1, 1, 1, 1, device=device, dtype=dtype)
op = kornia.enhance.normalize_min_max
op_jit = torch.jit.script(op)
self.assert_close(op(x), op_jit(x))
@pytest.mark.grad()
def test_gradcheck(self, device):
x = torch.ones(1, 1, 1, 1, device=device, dtype=torch.float64, requires_grad=True)
self.gradcheck(kornia.enhance.normalize_min_max, (x,))
def test_3d_tensor(self, device, dtype):
# Test with 3D tensor (C, H, W) - the main bug fix
x = torch.tensor([[[0.0, 1.0, 3.0], [-1.0, 4.0, 3.0], [9.0, 5.0, 2.0]]], device=device, dtype=dtype)
# Expected: normalized to [-1, 1] range
expected = torch.tensor([[[-0.8, -0.6, -0.2], [-1.0, 0.0, -0.2], [1.0, 0.2, -0.4]]], device=device, dtype=dtype)
actual = kornia.enhance.normalize_min_max(x, min_val=-1.0, max_val=1.0)
# Verify shape is preserved
assert actual.shape == x.shape
self.assert_close(actual, expected, low_tolerance=True)
def test_3d_tensor_multiple_channels(self, device, dtype):
# Test with 3D tensor with multiple channels (C, H, W)
x = torch.rand(3, 4, 5, device=device, dtype=dtype)
out = kornia.enhance.normalize_min_max(x, min_val=0.0, max_val=1.0)
# Verify shape is preserved
assert out.shape == x.shape
# Verify per-channel normalization
for c in range(x.shape[0]):
channel_out = out[c]
self.assert_close(channel_out.min(), torch.tensor(0.0, device=device, dtype=dtype), low_tolerance=True)
self.assert_close(channel_out.max(), torch.tensor(1.0, device=device, dtype=dtype), low_tolerance=True)
def test_2d_tensor(self, device, dtype):
# Test with 2D tensor (H, W)
x = torch.tensor([[0.0, 5.0], [10.0, 15.0]], device=device, dtype=dtype)
out = kornia.enhance.normalize_min_max(x, min_val=0.0, max_val=1.0)
# Verify shape is preserved
assert out.shape == x.shape
# Verify normalization
expected = torch.tensor([[0.0, 1.0 / 3.0], [2.0 / 3.0, 1.0]], device=device, dtype=dtype)
self.assert_close(out, expected, low_tolerance=True)
@pytest.mark.parametrize("input_shape", [(3, 4, 5), (1, 32, 32), (4, 8, 8)])
def test_3d_shapes(self, device, dtype, input_shape):
# Test various 3D tensor shapes
x = torch.rand(input_shape, device=device, dtype=dtype)
out = kornia.enhance.normalize_min_max(x, min_val=-1.0, max_val=1.0)
# Verify shape is preserved
assert out.shape == input_shape
def test_keyword_argument(self, device, dtype):
# Regression test for #3745: the perform_keep_shape_image wrapper binds the
# first argument as `input`, so passing the image by keyword must use `input=`
# and match the documented signature.
x = torch.rand(1, 2, 4, 5, device=device, dtype=dtype)
out_kwarg = kornia.enhance.normalize_min_max(input=x, min_val=-1.0, max_val=1.0)
out_positional = kornia.enhance.normalize_min_max(x, min_val=-1.0, max_val=1.0)
self.assert_close(out_kwarg, out_positional)