ReturnGuard / Dataset /README.md
RajTheBuilder's picture
Deploy ReturnGuard
ef19228 verified
|
Raw History Blame Contribute Delete
2.45 kB

A newer version of the Gradio SDK is available: 6.32.0

Upgrade

Dataset

Raw photos live in items/; the paired evaluation set (same/, different/, pairs.csv) is generated from them by python scripts/build_dataset.py and is not committed.

Raw photos: items/

items/<item>/front.jpeg, back.jpeg, side.jpeg          photo set 1
items/<item>/set2/front.jpeg, back.jpeg, side.jpeg     photo set 2, taken separately (only some items)
Item What it is Photo sets
speaker_A clean blue Portronics speaker with a batch label on the base 1
speaker_B same model, worn black unit, label gone 1
shaker_A / shaker_B two different shaker bottles 1
bottle_A / bottle_B same steel bottle model; B has a strap and small dents 1
headphones_blue blue Sony over-ear headphones 2
headphones_black black, worn Sony headphones of the same design 2 (set 2 has a new front photo only; back and side reuse set 1)

Angles: front = the main view (earcups facing the camera, product upright), back = the reverse / underside view, side = the side profile (for headphones: the slider arm with the SONY logo).

Pairs: same/ and different/

<same|different>/delivery_images/<front|back|side>/<pair_id>.jpeg
<same|different>/return_images/<front|back|side>/<pair_id>.jpeg

Pair IDs are numbered separately in each folder. same/.../25.jpeg and different/.../25.jpeg are unrelated pairs. Within one pair, the delivery and return files share the same number. pairs.csv lists every pair: label, pair_id, delivery_item, return_item, pair_type, delivery_set, return_set.

Folder IDs Contents
same 1–18 the first 6 items, 3 pairs each: return photo = the delivery photo, digitally re-captured (rotation, zoom, exposure, white balance, blur, JPEG)
same 19–24 the headphones, the same way
same 25–28 real re-photographs: delivery from one photo set, return from the other (25 & 27: set 1 → set 2; 26 & 28: set 2 → set 1). They look different on purpose
different 1–30 every ordered pair of the first 6 items
different 31–56 every new ordered pair involving the headphones

Return images in different/ get the same simulated re-capture as in same/, so the two classes differ only by the item. Seeds are fixed: rebuilding produces byte-identical files, and adding items never changes existing pairs.