model-compare

Compare 3D CAD models using boolean operations (IoU, Dice, precision/recall). Use when evaluating generated models against gold references, diffing CAD revisions, or computing similarity metrics for ML training. Triggers on: model diff, compare models, IoU, intersection over union, model similarity, CAD comparison, STEP diff, 3D evaluation, gold reference, generated model, precision recall 3D.

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.