model-compare

Narzędzie do porównywania trójwymiarowych modeli CAD przy użyciu operacji boolowskich. Oblicza metryki podobieństwa takie jak IoU (Intersection over Union), Dice, precyzję i czułość – idealne do oceny modeli wygenerowanych przez sztuczną inteligencję względem wzorców referencyjnych, porównywania wersji projektów oraz przygotowania danych treningowych dla modeli generatywnych. Obsługuje formaty STEP, BREP i STL. Zwraca zarówno wizualizacje różnic geometrycznych, jak i wyniki w formacie JSON do automatycznych potoków przetwarzania.

1. Zainstaluj narzędzie, uruchamiając polecenie uvx z pakietem build123d – nie wymaga ręcznej instalacji zależności. 2. Przygotuj dwa pliki modeli CAD w formacie STEP (zalecane dla pełnej wierności), BREP lub STL – plik referencyjny i plik do porównania. 3. Uruchom porównanie, podając ścieżki do obu plików: uvx --from build123d python scripts/model_diff.py reference.step generated.step – narzędzie automatycznie obliczy metryki i wygeneruje wizualizację różnic. 4. Jeśli potrzebujesz wyników w formacie JSON do pipelinów treningowych, dodaj flagi --json --no-export, aby otrzymać dane strukturyzowane bez eksportu plików graficznych. 5. Przejrzyj wyniki: IoU pokazuje ogólne podobieństwo (0–1), Dice jest bardziej czułe na małe pokrycia, precyzja mówi ile z modelu wygenerowanego jest poprawne, a czułość pokazuje ile z referencji zostało przechwycone. 6. Opcjonalnie uruchom tryb demo (uvx --from build123d python scripts/model_diff.py --demo) aby przetestować narzędzie bez własnych plików.