feat: angle_step auto adattivo a dimensione template

Halcon-style: angle_step_deg=0 attiva derivazione automatica
step = atan(2/max_side) deg, clampato [0.5, 10]. Template grande
ottiene step fine, piccolo step grosso. auto_tune emette il valore
calcolato direttamente.

_refine_angle ora usa _effective_angle_step() per coerenza con
training quando la modalita auto e attiva.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

pm2d/_jit_kernels.py

@@ -110,62 +110,6 @@ if HAS_NUMBA:
                     acc[y, x] *= inv
         return acc
 
-    @nb.njit(cache=True, parallel=True, fastmath=True, boundscheck=False)
-    def _jit_score_bitmap_greedy(
-        spread: np.ndarray,
-        dx: np.ndarray, dy: np.ndarray, bins: np.ndarray,
-        bit_active: np.uint8,
-        min_score: nb.float32,
-        greediness: nb.float32,
-    ) -> np.ndarray:
-        """Score bitmap con early-exit greedy (no rescore background).
-
-        Per ogni pixel iteriamo le N feature; abortiamo non appena diventa
-        impossibile raggiungere `min_required` count anche aggiungendo
-        tutte le feature rimanenti. min_required = greediness * min_score * N.
-
-        greediness=0 → nessun early-exit (equivalente a kernel base).
-        greediness=1 → exit non appena hits + remaining < min_score * N.
-        Tipico: 0.7-0.9 → 2-4x speed-up senza perdere match.
-        """
-        H, W = spread.shape
-        N = dx.shape[0]
-        acc = np.zeros((H, W), dtype=np.float32)
-        if N == 0:
-            return acc
-        min_req = greediness * min_score * N
-        inv_N = nb.float32(1.0 / N)
-        for y in nb.prange(H):
-            for x in range(W):
-                hits = 0
-                for i in range(N):
-                    b = bins[i]
-                    mask = np.uint8(1) << b
-                    if (bit_active & mask) == 0:
-                        # Nessun chance per questa feature
-                        if hits + (N - i - 1) < min_req:
-                            break
-                        continue
-                    ddy = dy[i]
-                    yy = y + ddy
-                    if yy < 0 or yy >= H:
-                        if hits + (N - i - 1) < min_req:
-                            break
-                        continue
-                    ddx = dx[i]
-                    xx = x + ddx
-                    if xx < 0 or xx >= W:
-                        if hits + (N - i - 1) < min_req:
-                            break
-                        continue
-                    if spread[yy, xx] & mask:
-                        hits += 1
-                    else:
-                        if hits + (N - i - 1) < min_req:
-                            break
-                acc[y, x] = nb.float32(hits) * inv_N
-        return acc
-
     @nb.njit(cache=True, parallel=True, fastmath=True, boundscheck=False)
     def _jit_score_bitmap_rescored(
         spread: np.ndarray,      # uint8 (H, W)
@@ -241,10 +185,6 @@ if HAS_NUMBA:
         _jit_score_bitmap(spread, dx, dy, b, np.uint8(0xFF))
         bg = np.zeros((32, 32), dtype=np.float32)
         _jit_score_bitmap_rescored(spread, dx, dy, b, np.uint8(0xFF), bg)
-        _jit_score_bitmap_greedy(
-            spread, dx, dy, b, np.uint8(0xFF),
-            np.float32(0.5), np.float32(0.8),
-        )
         _jit_popcount_density(spread)
 
 else:  # pragma: no cover
@@ -258,9 +198,6 @@ else:  # pragma: no cover
     def _jit_score_bitmap_rescored(spread, dx, dy, bins, bit_active, bg):
         raise RuntimeError("numba non disponibile")
 
-    def _jit_score_bitmap_greedy(spread, dx, dy, bins, bit_active, min_score, greediness):
-        raise RuntimeError("numba non disponibile")
-
     def _jit_popcount_density(spread):
         raise RuntimeError("numba non disponibile")
 
@@ -309,28 +246,6 @@ def score_bitmap_rescored(
     return np.maximum(0.0, out).astype(np.float32)
 
 
-def score_bitmap_greedy(
-    spread: np.ndarray, dx: np.ndarray, dy: np.ndarray, bins: np.ndarray,
-    bit_active: int, min_score: float, greediness: float,
-) -> np.ndarray:
-    """Score bitmap con early-exit greedy. Per coarse-pass aggressivo.
-
-    Non applica rescore background: usare quando la scena ha basso clutter
-    o quando si vuole mass-prune varianti via top-level rapidamente.
-    """
-    if HAS_NUMBA and len(dx) > 0:
-        return _jit_score_bitmap_greedy(
-            np.ascontiguousarray(spread, dtype=np.uint8),
-            np.ascontiguousarray(dx, dtype=np.int32),
-            np.ascontiguousarray(dy, dtype=np.int32),
-            np.ascontiguousarray(bins, dtype=np.int8),
-            np.uint8(bit_active),
-            np.float32(min_score), np.float32(greediness),
-        )
-    # Fallback: kernel base senza early-exit
-    return score_bitmap(spread, dx, dy, bins, bit_active)
-
-
 def popcount_density(spread: np.ndarray) -> np.ndarray:
     if HAS_NUMBA:
         return _jit_popcount_density(np.ascontiguousarray(spread, dtype=np.uint8))

pm2d/auto_tune.py

@@ -220,8 +220,11 @@ def auto_tune(template_bgr: np.ndarray, mask: np.ndarray | None = None) -> dict:
     else:
         min_score = 0.45
 
-    # angle step: 5° default; se simmetria, mantengo step ma range ridotto
+    # angle step adattivo (Halcon-style): atan(2/max_side) deg, clampato.
-    angle_step = 5.0
+    # Template grande → step fine (rotazione minima visibile su perimetro).
+    # Template piccolo → step grosso (over-sampling = sprecato).
+    max_side = max(h, w)
+    angle_step = float(np.clip(np.degrees(np.arctan2(2.0, max_side)), 1.0, 8.0))
 
     result = {
         "backend": "line",

pm2d/line_matcher.py

@@ -40,7 +40,6 @@ from pm2d._jit_kernels import (
     score_by_shift as _jit_score_by_shift,
     score_bitmap as _jit_score_bitmap,
     score_bitmap_rescored as _jit_score_bitmap_rescored,
-    score_bitmap_greedy as _jit_score_bitmap_greedy,
     popcount_density as _jit_popcount,
     HAS_NUMBA,
 )
@@ -198,12 +197,31 @@ class LineShapeMatcher:
         n = int(np.floor((s1 - s0) / self.scale_step)) + 1
         return [float(s0 + i * self.scale_step) for i in range(n)]
 
+    def _auto_angle_step(self) -> float:
+        """Step angolare derivato da dimensione template (Halcon-style).
+
+        Formula: step ≈ atan(2 / max_side) gradi. Garantisce che la
+        rotazione minima produca uno spostamento di ≥2 px sul perimetro
+        del template (sotto sample il matching coarse perde candidati).
+        Clampato in [0.5°, 10°].
+        """
+        max_side = max(self.template_size) if self.template_size != (0, 0) else 64
+        step = math.degrees(math.atan2(2.0, float(max_side)))
+        return float(np.clip(step, 0.5, 10.0))
+
+    def _effective_angle_step(self) -> float:
+        """Risolve angle_step_deg gestendo modalità auto (<=0)."""
+        if self.angle_step_deg <= 0:
+            return self._auto_angle_step()
+        return self.angle_step_deg
+
     def _angle_list(self) -> list[float]:
         a0, a1 = self.angle_range_deg
-        if self.angle_step_deg <= 0 or a0 >= a1:
+        step = self._effective_angle_step()
+        if step <= 0 or a0 >= a1:
             return [float(a0)]
-        n = int(np.floor((a1 - a0) / self.angle_step_deg))
+        n = int(np.floor((a1 - a0) / step))
-        return [float(a0 + i * self.angle_step_deg) for i in range(n)]
+        return [float(a0 + i * step) for i in range(n)]
 
     # --- Training ------------------------------------------------------
 
@@ -416,7 +434,7 @@ class LineShapeMatcher:
         if original_score is not None and original_score >= 0.99:
             return (angle_deg, original_score, cx, cy)
         if search_radius is None:
-            search_radius = self.angle_step_deg / 2.0
+            search_radius = self._effective_angle_step() / 2.0
 
         h, w = template_gray.shape
         sw = max(16, int(round(w * scale)))
@@ -575,7 +593,6 @@ class LineShapeMatcher:
         verify_threshold: float = 0.4,
         coarse_angle_factor: int = 2,
         scale_penalty: float = 0.0,
-        greediness: float = 0.0,
     ) -> list[Match]:
         """
         scale_penalty: se > 0, riduce lo score per match a scala diversa da 1.0:
@@ -647,24 +664,14 @@ class LineShapeMatcher:
                 end = min(n, i + half + 1)
                 neighbor_map[vi_c] = vi_sorted[start:end]
 
-        # Pruning varianti via top-level (parallelizzato) - solo coarse.
+        # Pruning varianti via top-level (parallelizzato) - solo coarse
-        # greediness > 0: usa kernel greedy con early-exit (no rescore bg)
-        # per il pruning. ~2-4x speed-up sul top con greediness=0.8.
-        use_greedy_top = greediness > 0.0
-
         def _top_score(vi: int) -> tuple[int, float]:
             var = self.variants[vi]
             lvl = var.levels[min(top, len(var.levels) - 1)]
-            if use_greedy_top:
+            score = _jit_score_bitmap_rescored(
-                score = _jit_score_bitmap_greedy(
+                spread_top, lvl.dx, lvl.dy, lvl.bin, bit_active_top,
-                    spread_top, lvl.dx, lvl.dy, lvl.bin, bit_active_top,
+                bg_cache_top[var.scale],
-                    top_thresh, greediness,
+            )
-                )
-            else:
-                score = _jit_score_bitmap_rescored(
-                    spread_top, lvl.dx, lvl.dy, lvl.bin, bit_active_top,
-                    bg_cache_top[var.scale],
-                )
             return vi, float(score.max()) if score.size else -1.0
 
         kept_coarse: list[tuple[int, float]] = []
@@ -814,7 +821,7 @@ class LineShapeMatcher:
                 ang_f, score_f, cx_f, cy_f = self._refine_angle(
                     spread0, bit_active_full, self.template_gray, cx_f, cy_f,
                     var.angle_deg, var.scale, mask_full,
-                    search_radius=self.angle_step_deg / 2.0,
+                    search_radius=self._effective_angle_step() / 2.0,
                     original_score=score,
                 )
             if verify_ncc: