corrmatch 0.1.0

CPU-first template matching with ZNCC/SSD and coarse-to-fine pyramid search
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63

# Synthetic validation

CorrMatch ships a synthetic validation suite under `synthetic_cases/` plus an
integration test runner (`tests/synthetic_validation.rs`). The goal is to
validate end-to-end correctness (coarse search + refinement) against known
ground truth.

## How to run

```bash
cargo test -p corrmatch --test synthetic_validation --all-features -- --nocapture
```

Notes:
- Requires feature `image-io` (enabled by `--all-features`) to load PNGs.
- The test reads `synthetic_cases/manifest.json` and validates all listed cases.

## Acceptance criteria (current)

- Position tolerance: ±3 px
- Angle tolerance: ±2°
- For ZNCC: minimum score threshold 0.80 (0.77 for `occluded_25pct`)
- For SSD: score is negative SSE (higher is better); acceptance is based on
  position/angle tolerances.

## Latest recorded run (2026-01-31)

Environment:
- OS: Darwin 25.2.0 (arm64)
- CPU: Apple M4 Pro
- Rust: rustc 1.91.0, cargo 1.91.0
- Python: 3.14.2

Command:

```bash
cargo test -p corrmatch --test synthetic_validation --all-features -- --nocapture
```

Result:

```text
Passed: 15/15
Failed: 0/15
```

Cases (all PASS):
- clean_translation
- clean_translation_large
- rotation_coarse_30deg
- rotation_fine_22_5deg
- rotation_wrap_172_5deg
- noise_gaussian
- blur_sigma_1_5
- illumination_shift
- occluded_25pct
- distractors_topk
- near_border
- negative_no_match
- pyramid_stress
- pyramid_stress_single_level
- rotation_fine_single_level