# Copyright 2026 the HuggingFace Team. All rights reserved. # # 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. """Testing suite for the PyTorch EoMT model.""" import unittest import requests from transformers import AutoImageProcessor, EomtDinov3Config, EomtDinov3ForUniversalSegmentation, pipeline from transformers.testing_utils import ( Expectations, require_deterministic_for_xpu, require_torch, require_torch_accelerator, slow, torch_device, ) from transformers.utils import is_torch_available, is_vision_available from ...test_configuration_common import ConfigTester from ...test_modeling_common import ModelTesterMixin, _config_zero_init, floats_tensor from ...test_pipeline_mixin import PipelineTesterMixin if is_torch_available(): import torch if is_vision_available(): from PIL import Image class EomtDinov3ForUniversalSegmentationTester: def __init__( self, parent, batch_size=2, is_training=True, image_size=40, patch_size=2, num_queries=5, num_register_tokens=19, num_labels=4, hidden_size=8, num_attention_heads=2, num_hidden_layers=2, ): self.parent = parent self.batch_size = batch_size self.is_training = is_training self.num_queries = num_queries self.image_size = image_size self.patch_size = patch_size self.num_labels = num_labels self.hidden_size = hidden_size self.num_attention_heads = num_attention_heads self.num_hidden_layers = num_hidden_layers self.num_register_tokens = num_register_tokens num_patches = (image_size // patch_size) ** 2 self.seq_length = num_patches + 1 + self.num_register_tokens def get_config(self): config = { "image_size": self.image_size, "patch_size": self.patch_size, "num_labels": self.num_labels, "hidden_size": self.hidden_size, "num_attention_heads": self.num_attention_heads, "num_hidden_layers": self.num_hidden_layers, "num_register_tokens": self.num_register_tokens, "num_queries": self.num_queries, "num_blocks": 1, "rope_parameters": {"rope_theta": 100.0}, } return EomtDinov3Config(**config) def prepare_config_and_inputs(self): pixel_values = floats_tensor([self.batch_size, 3, self.image_size, self.image_size]).to(torch_device) mask_labels = ( torch.rand([self.batch_size, self.num_labels, self.image_size, self.image_size], device=torch_device) > 0.5 ).float() class_labels = (torch.rand((self.batch_size, self.num_labels), device=torch_device) > 0.5).long() config = self.get_config() return config, pixel_values, mask_labels, class_labels def prepare_config_and_inputs_for_common(self): config, pixel_values, mask_labels, class_labels = self.prepare_config_and_inputs() inputs_dict = {"pixel_values": pixel_values} return config, inputs_dict def prepare_config_and_inputs_for_training(self): config, pixel_values, mask_labels, class_labels = self.prepare_config_and_inputs() inputs_dict = {"pixel_values": pixel_values, "mask_labels": mask_labels, "class_labels": class_labels} return config, inputs_dict @require_torch class EomtDinov3ForUniversalSegmentationTest(ModelTesterMixin, PipelineTesterMixin, unittest.TestCase): all_model_classes = (EomtDinov3ForUniversalSegmentation,) if is_torch_available() else () pipeline_model_mapping = {"image-segmentation": EomtDinov3ForUniversalSegmentation} if is_torch_available() else {} is_encoder_decoder = False test_missing_keys = False test_torch_exportable = False def setUp(self): self.model_tester = EomtDinov3ForUniversalSegmentationTester(self) self.config_tester = ConfigTester(self, config_class=EomtDinov3Config, has_text_modality=False) def test_config(self): self.config_tester.run_common_tests() def test_model_with_labels(self): size = (self.model_tester.image_size,) * 2 inputs = { "pixel_values": torch.randn((2, 3, *size), device=torch_device), "mask_labels": torch.randn((2, 10, *size), device=torch_device), "class_labels": torch.zeros(2, 10, device=torch_device).long(), } config = self.model_tester.get_config() model = EomtDinov3ForUniversalSegmentation(config).to(torch_device) outputs = model(**inputs) self.assertTrue(outputs.loss is not None) @unittest.skip(reason="Mask creation is forced") def test_sdpa_can_dispatch_on_flash(self): pass @unittest.skip(reason="EoMT does not use inputs_embeds") def test_inputs_embeds(self): pass @unittest.skip(reason="EoMT does not have a get_input_embeddings method") def test_model_get_set_embeddings(self): pass @unittest.skip(reason="EoMT is not a generative model") def test_generate_without_input_ids(self): pass @unittest.skip(reason="EoMT does not use token embeddings") def test_resize_tokens_embeddings(self): pass def test_training(self): # We override this test because EoMT requires `mask_labels` and `class_labels` for training, # which are not standard labels that `_prepare_for_class` can generate. We can't include # these labels in `prepare_config_and_inputs_for_common` because that would break determinism # tests (the Hungarian matching in the loss computation is non-deterministic). if not self.model_tester.is_training: self.skipTest(reason="ModelTester is not configured to run training tests") for model_class in self.all_model_classes: config, inputs_dict = self.model_tester.prepare_config_and_inputs_for_training() config.return_dict = True model = model_class(config) model.to(torch_device) model.train() inputs = self._prepare_for_class(inputs_dict, model_class, return_labels=True) loss = model(**inputs).loss loss.backward() def test_initialization(self): # Apart from the below params, all other parameters are initialized using kaiming uniform. non_uniform_init_parms = [ "layernorm.bias", "layernorm.weight", "norm1.bias", "norm1.weight", "norm2.bias", "norm2.weight", "layer_scale1.lambda1", "layer_scale2.lambda1", "register_tokens", "cls_token", ] config, inputs_dict = self.model_tester.prepare_config_and_inputs_for_common() configs_no_init = _config_zero_init(config) for model_class in self.all_model_classes: model = model_class(config=configs_no_init) for name, param in model.named_parameters(): if param.requires_grad: if any(x in name for x in non_uniform_init_parms): self.assertIn( ((param.data.mean() * 1e9).round() / 1e9).item(), [0.0, 1.0], msg=f"Parameter {name} of model {model_class} seems not properly initialized", ) else: self.assertTrue( -1.0 <= ((param.data.mean() * 1e9).round() / 1e9).item() <= 1.0, msg=f"Parameter {name} of model {model_class} seems not properly initialized", ) @slow @require_torch class EomtDinov3ForUniversalSegmentationIntegrationTest(unittest.TestCase): def setUp(self): self.model_id = "tue-mps/eomt-dinov3-coco-panoptic-large-640" def test_inference(self): model = EomtDinov3ForUniversalSegmentation.from_pretrained(self.model_id, device_map="auto") processor = AutoImageProcessor.from_pretrained(self.model_id) image = Image.open(requests.get("http://images.cocodataset.org/val2017/000000039769.jpg", stream=True).raw) inputs = processor(images=image, return_tensors="pt").to(model.device) with torch.inference_mode(): outputs = model(**inputs) self.assertEqual(outputs.class_queries_logits.shape, (1, 200, 134)) self.assertEqual(outputs.masks_queries_logits.shape, (1, 200, 160, 160)) self.assertTrue(torch.isfinite(outputs.masks_queries_logits).all()) self.assertTrue(torch.isfinite(outputs.class_queries_logits).all()) # fmt: off expected_class_logits_slice = torch.tensor([ [-0.3180, -5.6188, -0.7154], [ 0.0837, -6.8066, -2.1033], [-1.4065, -5.9924, -5.4660] ], device=model.device) expected_masks_logits_slice = torch.tensor([ [-1.6251, -1.1417, -1.0285], [ 2.5673, 5.3380, 6.2132], [ 3.7562, 7.1667, 8.1707] ], device=model.device) # fmt: on torch.testing.assert_close( outputs.class_queries_logits[0, :3, :3].float(), expected_class_logits_slice, rtol=1e-3, atol=1e-3 ) torch.testing.assert_close( outputs.masks_queries_logits[0, 0, :3, :3].float(), expected_masks_logits_slice, rtol=1e-3, atol=1e-3 ) @require_torch_accelerator @require_deterministic_for_xpu def test_inference_bf16(self): # NOTE: fp16 leads to overflows aka NaNs, since it's not important just checking bf16 instead model = EomtDinov3ForUniversalSegmentation.from_pretrained( self.model_id, dtype=torch.bfloat16, device_map="auto" ) processor = AutoImageProcessor.from_pretrained(self.model_id) image = Image.open(requests.get("http://images.cocodataset.org/val2017/000000039769.jpg", stream=True).raw) inputs = processor(images=image, return_tensors="pt").to(model.device) torch.manual_seed(42) with torch.inference_mode(): outputs = model(**inputs) self.assertTrue(outputs.class_queries_logits.shape == (1, 200, 134)) self.assertTrue(outputs.masks_queries_logits.shape == (1, 200, 160, 160)) # fmt: off class_expectations = Expectations( { ("xpu", 3): [ [-0.3125, -5.6562, -0.7148], [ 0.0693, -6.8125, -2.1562], [-1.4141, -6.0000, -5.4688] ], ("cuda", 8): [ [-0.3145, -5.6562, -0.7422], [ 0.0542, -6.8438, -2.1875], [-1.4062, -6.0000, -5.4688] ], } ) masks_expectations = Expectations( { ("xpu", 3): [ [-1.5859, -1.1406, -1.0156], [ 2.5938, 5.3125, 6.1875], [ 3.7812, 7.1250, 8.1250] ], ("cuda", 8): [ [-1.5859, -1.1406, -1.0234], [ 2.5625, 5.3438, 6.2188], [ 3.7500, 7.1562, 8.1875] ], } ) expected_class_logits_slice = torch.tensor(class_expectations.get_expectation(), device=model.device) expected_masks_logits_slice = torch.tensor(masks_expectations.get_expectation(), device=model.device) # fmt: on torch.testing.assert_close( outputs.class_queries_logits[0, :3, :3].float(), expected_class_logits_slice, rtol=1e-3, atol=1e-3 ) torch.testing.assert_close( outputs.masks_queries_logits[0, 0, :3, :3].float(), expected_masks_logits_slice, rtol=1e-3, atol=1e-3 ) def test_semantic_segmentation_inference(self): model_id = "tue-mps/eomt-dinov3-ade-semantic-large-512" model = EomtDinov3ForUniversalSegmentation.from_pretrained(model_id, device_map="auto") processor = AutoImageProcessor.from_pretrained(model_id) image = Image.open(requests.get("http://images.cocodataset.org/val2017/000000039769.jpg", stream=True).raw) inputs = processor(images=image, return_tensors="pt").to(model.device) with torch.inference_mode(): outputs = model(**inputs) self.assertEqual(outputs.class_queries_logits.shape, (1, 100, 151)) self.assertEqual(outputs.masks_queries_logits.shape, (1, 100, 128, 128)) # fmt: off expected_class_logits_slice = torch.tensor([ [-0.8774, -3.2156, -3.5122], [-0.8454, -4.5418, -4.2628], [ 2.5385, -4.1147, -3.1046] ], device=model.device) expected_masks_logits_slice = torch.tensor([ [-37.6081, -37.5875, -38.8876], [-38.2850, -51.4408, -51.4456], [-42.4620, -53.7380, -66.6535] ], device=model.device) # fmt: on torch.testing.assert_close( outputs.class_queries_logits[0, :3, :3].float(), expected_class_logits_slice, rtol=1e-3, atol=1e-3 ) torch.testing.assert_close( outputs.masks_queries_logits[0, 0, :3, :3].float(), expected_masks_logits_slice, rtol=1e-3, atol=1e-3 ) preds = processor.post_process_semantic_segmentation(outputs, target_sizes=[(image.size[1], image.size[0])])[0] self.assertEqual(preds.shape, (image.size[1], image.size[0])) # fmt: off expected_preds_slice = torch.tensor([ [0, 0, 0, 0, 0, 0, 0, 0, 0, 0], [0, 0, 0, 0, 0, 0, 0, 0, 0, 0], [0, 0, 0, 0, 0, 0, 0, 0, 0, 0], [0, 0, 0, 0, 0, 0, 0, 0, 0, 0], [0, 0, 0, 0, 0, 0, 0, 0, 0, 0], [0, 0, 0, 0, 0, 0, 0, 0, 0, 0], [0, 0, 0, 0, 0, 0, 0, 0, 0, 0], [0, 0, 0, 0, 0, 0, 0, 0, 0, 0], [0, 0, 0, 0, 0, 0, 0, 0, 0, 0], [0, 0, 0, 0, 0, 0, 0, 0, 0, 0] ], device=model.device) # fmt: on output_slice = preds[:10, :10] torch.testing.assert_close(output_slice, expected_preds_slice, rtol=1e-3, atol=1e-3) def test_panoptic_segmentation_inference(self): model = EomtDinov3ForUniversalSegmentation.from_pretrained(self.model_id, device_map="auto") processor = AutoImageProcessor.from_pretrained(self.model_id) image = Image.open(requests.get("http://images.cocodataset.org/val2017/000000039769.jpg", stream=True).raw) inputs = processor(images=image, return_tensors="pt").to(model.device) with torch.inference_mode(): outputs = model(**inputs) self.assertTrue(outputs.class_queries_logits.shape == (1, 200, 134)) self.assertTrue(outputs.masks_queries_logits.shape == (1, 200, 160, 160)) # fmt: off expected_class_logits_slice = torch.tensor([ [-0.3180, -5.6188, -0.7154], [ 0.0837, -6.8066, -2.1033], [-1.4065, -5.9924, -5.4660] ], device=model.device) expected_masks_logits_slice = torch.tensor([ [-1.6251, -1.1417, -1.0285], [ 2.5673, 5.3380, 6.2132], [ 3.7562, 7.1667, 8.1707] ], device=model.device) # fmt: on torch.testing.assert_close( outputs.class_queries_logits[0, :3, :3].float(), expected_class_logits_slice, rtol=1e-3, atol=1e-3 ) torch.testing.assert_close( outputs.masks_queries_logits[0, 0, :3, :3].float(), expected_masks_logits_slice, rtol=1e-3, atol=1e-3 ) preds = processor.post_process_panoptic_segmentation(outputs, target_sizes=[(image.size[1], image.size[0])])[0] segmentation, segments_info = preds["segmentation"], preds["segments_info"] output_slice = segmentation[:10, :10] self.assertGreaterEqual(output_slice.unique().numel(), 2) self.assertGreaterEqual(len(segments_info), 3) for info in segments_info: self.assertIn("label_id", info) self.assertIn("score", info) self.assertTrue(0.0 <= info["score"] <= 1.0) def test_instance_segmentation_inference(self): model_id = "tue-mps/eomt-dinov3-coco-instance-large-640" model = EomtDinov3ForUniversalSegmentation.from_pretrained(model_id, device_map="auto") processor = AutoImageProcessor.from_pretrained(model_id) image = Image.open(requests.get("http://images.cocodataset.org/val2017/000000039769.jpg", stream=True).raw) inputs = processor(images=image, return_tensors="pt").to(model.device) with torch.inference_mode(): outputs = model(**inputs) self.assertEqual(outputs.class_queries_logits.shape, (1, 200, 81)) self.assertEqual(outputs.masks_queries_logits.shape, (1, 200, 160, 160)) # fmt: off expected_class_logits_slice = torch.tensor([ [-1.3013, -6.0043, -2.2048], [ 1.9109, -2.3819, -3.3945], [-0.9235, -4.5945, -0.4908] ], device=model.device) expected_masks_logits_slice = torch.tensor([ [-11.2059, -11.1473, -10.5228], [-10.6254, -9.2761, -9.8643], [-10.3746, -11.5448, -10.9008] ], device=model.device) # fmt: on torch.testing.assert_close( outputs.class_queries_logits[0, :3, :3].float(), expected_class_logits_slice, rtol=1e-3, atol=1e-3 ) torch.testing.assert_close( outputs.masks_queries_logits[0, 0, :3, :3].float(), expected_masks_logits_slice, rtol=1e-3, atol=1e-3 ) preds = processor.post_process_instance_segmentation(outputs, target_sizes=[(image.size[1], image.size[0])])[0] segmentation, segments_info = preds["segmentation"], preds["segments_info"] output_slice = segmentation[:10, :10] self.assertGreaterEqual(output_slice.unique().numel(), 2) self.assertGreaterEqual(len(segments_info), 3) for info in segments_info: self.assertIn("label_id", info) self.assertIn("score", info) self.assertTrue(0.0 <= info["score"] <= 1.0) def test_segmentation_pipeline(self): image = Image.open(requests.get("http://images.cocodataset.org/val2017/000000039769.jpg", stream=True).raw) model = EomtDinov3ForUniversalSegmentation.from_pretrained(self.model_id, device_map="auto") processor = AutoImageProcessor.from_pretrained(self.model_id) inputs = processor(images=image, return_tensors="pt").to(model.device) with torch.inference_mode(): outputs = model(**inputs) # fmt: off expected_class_logits_slice = torch.tensor([ [-0.3180, -5.6188, -0.7154], [ 0.0837, -6.8066, -2.1033], [-1.4065, -5.9924, -5.4660] ], device=model.device) expected_masks_logits_slice = torch.tensor([ [-1.6251, -1.1417, -1.0285], [ 2.5673, 5.3380, 6.2132], [ 3.7562, 7.1667, 8.1707] ], device=model.device) # fmt: on torch.testing.assert_close( outputs.class_queries_logits[0, :3, :3].float(), expected_class_logits_slice, rtol=1e-3, atol=1e-3 ) torch.testing.assert_close( outputs.masks_queries_logits[0, 0, :3, :3].float(), expected_masks_logits_slice, rtol=1e-3, atol=1e-3 ) pipe = pipeline(model=self.model_id, subtask="panoptic", device=torch_device) output = pipe(image) self.assertTrue(len(output) > 0) for segment in output: self.assertIn("score", segment) self.assertIn("label", segment) self.assertTrue(0.0 <= segment["score"] <= 1.0)