Annotation Review Tool

The review tool lets you audit annotated fingertip pairs quickly. Load the prediction/contact image sequences, pull in the annotation JSON, and mark each sequence as accepted or rejected with optional zoomed crops for verification.

1. Load the image sequences

1. Click Load Sequences and choose the directory that contains the paired images. Each sequence should have two files with a shared prefix (e.g. sequence_0006468.jpg and sequence_0006473.jpg).
2. The tool groups every valid pair and lists them at the top of the screen. Progress indicators show the current sequence index and the total count.
3. Loading a new folder clears any prior review decisions and resets the UI.

2. Import annotation data

1. Click Load Annotations and select a JSON file produced by the annotation tool or a previous review session.
2. The review page hydrates each sequence with its index/thumb points and the hard-sample flag. Sequences without matching images are skipped.
3. If the JSON already contains an accepted field, that decision is displayed immediately.

3. Inspect the current sequence

• The left canvas shows the Contact frame; the right canvas shows the Prediction frame.
• Annotated points are red (index) or green (thumb). Occluded points appear as colour-coded outlines.
• A yellow banner appears between the canvases when the sequence is marked as a hard sample.

4. Make review decisions

• Use the Accept and Reject buttons (or shortcuts) to record the verdict. Decisions are saved both in-memory and to localStorage so they persist if you navigate away or reload.
• Click Undo (or press U) to clear the decision for the current sequence.
• Move between sequences with the Previous/Next buttons or the left/right arrow keys.

5. Use the zoom overlay

• Once both frames contain an index and thumb point, the Zoom In button becomes available.
• Toggle it (button or Z) to render a magnified 220×220 crop in the top-left corner of each canvas, centered between the annotated fingertips.
• Toggle again to hide the overlay. The button disables automatically if a sequence lacks the required points.

6. Export decisions

1. When you finish reviewing, click Export Decisions.
2. The tool downloads review_decisions.json, which mirrors the loaded annotations and adds an accepted field per sequence (true/false/null).

Keyboard shortcuts

• ← / → — Navigate to the previous or next sequence.
• A — Accept the current sequence.
• R — Reject the current sequence.
• U — Undo the decision for the current sequence.
• Z — Toggle the zoom overlay (requires complete annotations).

Tips

• Decisions are cached in your browser. Loading a new image folder clears them so you always start fresh.
• If annotations change mid-session, toggle the zoom overlay off and on to refresh the crops.
• Use the hard-sample banner as a cue to double-check tricky sequences before accepting.