Skip to content

feat: adjustable radius API #18

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
EYH0602 merged 5 commits into from
Feb 10, 2026
Merged

feat: adjustable radius API #18

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
71e81db
fix: add radius parameter to FrameMonitor and threshold to FrameCoverage
EYH0602 Feb 9, 2026
e7af544
ignore fuzz link
EYH0602 Feb 9, 2026
4f9e8f6
radius API analysis
EYH0602 Feb 9, 2026
229285c
feat: change default RADIUS from 5 to 10
EYH0602 Feb 9, 2026
4febd0f
bump version
EYH0602 Feb 9, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions .gitignore
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -20,3 +20,5 @@ prof/
# Rust build artifacts
target/
Cargo.lock

fuzz
12 changes: 8 additions & 4 deletions AGENTS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -53,7 +53,9 @@ Future metrics (e.g., audio coverage, state-graph coverage) will follow the same
│ ├── videos/ # Small sample MP4s for integration tests
│ └── smb/ # Super Smash Bros recordings for stress tests
├── docs/
│ └── design.md # Architecture and design documentation
│ ├── api.md # API reference documentation
│ ├── frame_cov.md # Architecture and design documentation
│ └── tuning.md # Radius/threshold tuning guide with empirical results
├── rustfmt.toml # Rust formatting config
├── .pre-commit-config.yaml # Pre-commit hooks (Python + Rust)
├── .github/workflows/ # CI: pytest, mypy, ruff, pylint, rust (fmt/clippy/test)
Expand All @@ -74,7 +76,9 @@ Run Rust linting: `cargo clippy --all-targets --all-features -- -D warnings`

## Design

See [docs/design.md](docs/design.md) for the coverage framework architecture, frame coverage pipeline, BK-tree optimization, and loading strategies.
See [docs/frame_cov.md](docs/frame_cov.md) for the coverage framework architecture, frame coverage pipeline, BK-tree optimization, and loading strategies.

See [docs/api.md](docs/api.md) for detailed API reference documentation including configuration options.

## Key Modules (quick reference)

Expand All @@ -88,7 +92,7 @@ See [docs/design.md](docs/design.md) for the coverage framework architecture, fr
| `writer.py` | `write_mp4()`, `write_mp4_cv2()` |
| `stitch.py` | `stitch_images()` (panorama via AffineStitcher) |
| `generator.py` | Hypothesis strategies: `frames()`, `frames_lists` |
| `env.py` | `RADIUS` env var (Hamming distance threshold, default `5`) |
| `env.py` | `RADIUS` env var (default Hamming distance threshold, `10`); use constructor params to override |

## Environment and Dependencies

Expand Down Expand Up @@ -142,7 +146,7 @@ Some tests require assets in `assets/videos/` or `assets/smb/` and will skip if

### Environment variables for tests

- `RADIUS` — Hamming distance threshold (default `5`).
- `RADIUS` — Default Hamming distance threshold (default `10`). Prefer passing `radius=` to monitor constructors.
- `N_MAX` — Maximum number of recordings to process in monotonicity tests (default `100`).

## Benchmarks
Expand Down
Loading