Flexible annotation/image filename matches

[iurisilvio]

Description

Fix annotation imports with inconsistent image file names or with images in subfolders.

Type of change

• Bug fix (non-breaking change which fixes an issue)

How has this change been tested, please provide a testcase or example of how you tested the change?

Added a test to validate the scenario.

---

Note

Improves folder parsing to reliably match annotations to images (including COCO with subdirectory file_names), and adds tests for these cases.

• Util: roboflow/util/folderparser.py
  • Annotation→Image mapping overhaul:
    • Matches using image relative path, basename, or stem; falls back to all annotation files when needed.
    • Adds _build_image_to_annotationfile_index supporting coco, createml, csv, multilabel_csv, and jsonl.
    • Enhances COCO handling by normalizing paths and indexing by full path/basename/stem; fixes root-annotation ↔ subdir-image mismatches.
    • Updates _filterIndividualAnnotations to try multiple keys (rel path → basename → stem) and corrects annotation map lookup keys.
• Tests: tests/util/test_folderparser.py
  • Adds tests verifying COCO annotations at root match images in subdirectories and images referenced with subdir file_name match root-level images.
• Version: bump __version__ to 1.2.11.

^{Written by Cursor Bugbot for commit 76ae33f. This will update automatically on new commits. Configure here.}

[cursor]

Bug: Fallback Annotation Mapping Causes Inefficiency

The _map_annotations_to_images_1tomany function includes a fallback to annotationFiles that causes images to be checked against all annotation files if the index yields no specific matches. This can lead to inefficient processing and potentially incorrect annotation assignments, as images might be matched to unrelated files.

 

[CLAassistant]

Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you all sign our Contributor License Agreement before we can accept your contribution.
1 out of 2 committers have signed the CLA.

✅ iurisilvio
❌ pre-commit-ci[bot]
_{You have signed the CLA already but the status is still pending? Let us recheck it.}