Full Code of xthan/polyvore-dataset for AI

Repository: xthan/polyvore-dataset
Branch: master
Commit: ba8aa71b6589
Files: 3
Total size: 23.0 KB

Directory structure:
gitextract__p4_xoev/

├── LICENSE
├── README.md
└── category_id.txt

================================================
FILE CONTENTS
================================================

================================================
FILE: LICENSE
================================================
                                 Apache License
                           Version 2.0, January 2004
                        http://www.apache.org/licenses/

   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION

   1. Definitions.

      "License" shall mean the terms and conditions for use, reproduction,
      and distribution as defined by Sections 1 through 9 of this document.

      "Licensor" shall mean the copyright owner or entity authorized by
      the copyright owner that is granting the License.

      "Legal Entity" shall mean the union of the acting entity and all
      other entities that control, are controlled by, or are under common
      control with that entity. For the purposes of this definition,
      "control" means (i) the power, direct or indirect, to cause the
      direction or management of such entity, whether by contract or
      otherwise, or (ii) ownership of fifty percent (50%) or more of the
      outstanding shares, or (iii) beneficial ownership of such entity.

      "You" (or "Your") shall mean an individual or Legal Entity
      exercising permissions granted by this License.

      "Source" form shall mean the preferred form for making modifications,
      including but not limited to software source code, documentation
      source, and configuration files.

      "Object" form shall mean any form resulting from mechanical
      transformation or translation of a Source form, including but
      not limited to compiled object code, generated documentation,
      and conversions to other media types.

      "Work" shall mean the work of authorship, whether in Source or
      Object form, made available under the License, as indicated by a
      copyright notice that is included in or attached to the work
      (an example is provided in the Appendix below).

      "Derivative Works" shall mean any work, whether in Source or Object
      form, that is based on (or derived from) the Work and for which the
      editorial revisions, annotations, elaborations, or other modifications
      represent, as a whole, an original work of authorship. For the purposes
      of this License, Derivative Works shall not include works that remain
      separable from, or merely link (or bind by name) to the interfaces of,
      the Work and Derivative Works thereof.

      "Contribution" shall mean any work of authorship, including
      the original version of the Work and any modifications or additions
      to that Work or Derivative Works thereof, that is intentionally
      submitted to Licensor for inclusion in the Work by the copyright owner
      or by an individual or Legal Entity authorized to submit on behalf of
      the copyright owner. For the purposes of this definition, "submitted"
      means any form of electronic, verbal, or written communication sent
      to the Licensor or its representatives, including but not limited to
      communication on electronic mailing lists, source code control systems,
      and issue tracking systems that are managed by, or on behalf of, the
      Licensor for the purpose of discussing and improving the Work, but
      excluding communication that is conspicuously marked or otherwise
      designated in writing by the copyright owner as "Not a Contribution."

      "Contributor" shall mean Licensor and any individual or Legal Entity
      on behalf of whom a Contribution has been received by Licensor and
      subsequently incorporated within the Work.

   2. Grant of Copyright License. Subject to the terms and conditions of
      this License, each Contributor hereby grants to You a perpetual,
      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
      copyright license to reproduce, prepare Derivative Works of,
      publicly display, publicly perform, sublicense, and distribute the
      Work and such Derivative Works in Source or Object form.

   3. Grant of Patent License. Subject to the terms and conditions of
      this License, each Contributor hereby grants to You a perpetual,
      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
      (except as stated in this section) patent license to make, have made,
      use, offer to sell, sell, import, and otherwise transfer the Work,
      where such license applies only to those patent claims licensable
      by such Contributor that are necessarily infringed by their
      Contribution(s) alone or by combination of their Contribution(s)
      with the Work to which such Contribution(s) was submitted. If You
      institute patent litigation against any entity (including a
      cross-claim or counterclaim in a lawsuit) alleging that the Work
      or a Contribution incorporated within the Work constitutes direct
      or contributory patent infringement, then any patent licenses
      granted to You under this License for that Work shall terminate
      as of the date such litigation is filed.

   4. Redistribution. You may reproduce and distribute copies of the
      Work or Derivative Works thereof in any medium, with or without
      modifications, and in Source or Object form, provided that You
      meet the following conditions:

      (a) You must give any other recipients of the Work or
          Derivative Works a copy of this License; and

      (b) You must cause any modified files to carry prominent notices
          stating that You changed the files; and

      (c) You must retain, in the Source form of any Derivative Works
          that You distribute, all copyright, patent, trademark, and
          attribution notices from the Source form of the Work,
          excluding those notices that do not pertain to any part of
          the Derivative Works; and

      (d) If the Work includes a "NOTICE" text file as part of its
          distribution, then any Derivative Works that You distribute must
          include a readable copy of the attribution notices contained
          within such NOTICE file, excluding those notices that do not
          pertain to any part of the Derivative Works, in at least one
          of the following places: within a NOTICE text file distributed
          as part of the Derivative Works; within the Source form or
          documentation, if provided along with the Derivative Works; or,
          within a display generated by the Derivative Works, if and
          wherever such third-party notices normally appear. The contents
          of the NOTICE file are for informational purposes only and
          do not modify the License. You may add Your own attribution
          notices within Derivative Works that You distribute, alongside
          or as an addendum to the NOTICE text from the Work, provided
          that such additional attribution notices cannot be construed
          as modifying the License.

      You may add Your own copyright statement to Your modifications and
      may provide additional or different license terms and conditions
      for use, reproduction, or distribution of Your modifications, or
      for any such Derivative Works as a whole, provided Your use,
      reproduction, and distribution of the Work otherwise complies with
      the conditions stated in this License.

   5. Submission of Contributions. Unless You explicitly state otherwise,
      any Contribution intentionally submitted for inclusion in the Work
      by You to the Licensor shall be under the terms and conditions of
      this License, without any additional terms or conditions.
      Notwithstanding the above, nothing herein shall supersede or modify
      the terms of any separate license agreement you may have executed
      with Licensor regarding such Contributions.

   6. Trademarks. This License does not grant permission to use the trade
      names, trademarks, service marks, or product names of the Licensor,
      except as required for reasonable and customary use in describing the
      origin of the Work and reproducing the content of the NOTICE file.

   7. Disclaimer of Warranty. Unless required by applicable law or
      agreed to in writing, Licensor provides the Work (and each
      Contributor provides its Contributions) on an "AS IS" BASIS,
      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
      implied, including, without limitation, any warranties or conditions
      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
      PARTICULAR PURPOSE. You are solely responsible for determining the
      appropriateness of using or redistributing the Work and assume any
      risks associated with Your exercise of permissions under this License.

   8. Limitation of Liability. In no event and under no legal theory,
      whether in tort (including negligence), contract, or otherwise,
      unless required by applicable law (such as deliberate and grossly
      negligent acts) or agreed to in writing, shall any Contributor be
      liable to You for damages, including any direct, indirect, special,
      incidental, or consequential damages of any character arising as a
      result of this License or out of the use or inability to use the
      Work (including but not limited to damages for loss of goodwill,
      work stoppage, computer failure or malfunction, or any and all
      other commercial damages or losses), even if such Contributor
      has been advised of the possibility of such damages.

   9. Accepting Warranty or Additional Liability. While redistributing
      the Work or Derivative Works thereof, You may choose to offer,
      and charge a fee for, acceptance of support, warranty, indemnity,
      or other liability obligations and/or rights consistent with this
      License. However, in accepting such obligations, You may act only
      on Your own behalf and on Your sole responsibility, not on behalf
      of any other Contributor, and only if You agree to indemnify,
      defend, and hold each Contributor harmless for any liability
      incurred by, or claims asserted against, such Contributor by reason
      of your accepting any such warranty or additional liability.

   END OF TERMS AND CONDITIONS

   APPENDIX: How to apply the Apache License to your work.

      To apply the Apache License to your work, attach the following
      boilerplate notice, with the fields enclosed by brackets "{}"
      replaced with your own identifying information. (Don't include
      the brackets!)  The text should be enclosed in the appropriate
      comment syntax for the file format. We also recommend that a
      file or class name and description of purpose be included on the
      same "printed page" as the copyright notice for easier
      identification within third-party archives.

   Copyright 2017 Xintong Han

   Licensed under the Apache License, Version 2.0 (the "License");
   you may not use this file except in compliance with the License.
   You may obtain a copy of the License at

       http://www.apache.org/licenses/LICENSE-2.0

   Unless required by applicable law or agreed to in writing, software
   distributed under the License is distributed on an "AS IS" BASIS,
   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   See the License for the specific language governing permissions and
   limitations under the License.


================================================
FILE: README.md
================================================
## Polyvore Dataset
Dataset used in ACM MM'17 paper "Learning Fashion Compatibility with Bidirectional LSTMs" [[paper]](https://arxiv.org/pdf/1707.05691.pdf) [[code]](https://github.com/xthan/polyvore)

This dataset is also available on [Google Drive](https://drive.google.com/drive/folders/0B4Eo9mft9jwoVDNEWlhEbUNUSE0?resourcekey=0-vQg9TMSLKnmPCuuWwl5Ebw&usp=sharing).
Original Images can be downloaded on [Kaggle]( https://www.kaggle.com/datasets/dnepozitek/maryland-polyvore-images/data).

**A clean version of this dataset can be found:** [**Cleaned Maryland**](https://github.com/AemikaChow/AiDLab-fAshIon-Data/blob/main/Datasets/cleaned-maryland.md)

You may be interested in a new dataset [A100 dataset](https://github.com/AemikaChow/AiDLab-fAshIon-Data/blob/main/Datasets/A100.md), which measures the aesthetic ability of an AI model.

### Contact
Author: Xintong Han

Contact: xintong@umd.edu

### Polyvore.com

Polyvore.com is a popular fashion website, where users can create and upload outfit data. This website has been acquired by SSense, and the URLs in the dataset are no longer available.

### Dataset

Download and decompress polyvore.tar.gz.

#### Polyvore outfits

This dataset contains 21,889 outfits from polyvore.com, of which 17,316 are for training, 1,497 for validation, and 3,076 for testing. The train, validation, and test outfits are in {train,valid,test}_no_dup.json, respectively.

Each JSON item has the following information:

    {
        "name": Name of the outfit, 
        "views": Number of views of the outfit,
        "items": [
            Fashion items in the outfit.
            {
                "index": Index of the fashion item in this outfit on Polyvore,
                "name": Description of the fashion item,
                "price": Price of the fashion item (usually in US dollars),
                "likes": Number of likes of the item,
                "image": Image url of the item,
                "categoryid": Category ID of the item,
            }, 
            {
                ...
            }, 
            ...
        ], 
        "image": Outfit image url,
        "likes": Number of likes of the outfit,
        "date": Upload date of the outfit,
        "set_url": Outfit url,
        "set_id": Outfit ID,
        "desc": Outfit description.
    }
    

The image URLs are no longer available and they can be accessed on an unofficial [Kaggle page]( https://www.kaggle.com/datasets/dnepozitek/maryland-polyvore-images/data). This file contains the images of 33,375 outfits, which include all 21,889 outfits in polyvore dataset. The other ~11k outfits were uploaded more than 3 years ago. We are afraid that they are out-of-fashion so we do not use them).

[category_id.txt](https://github.com/xthan/polyvore-dataset/blob/master/category_id.txt) contains the mapping between category ID and category name. Thanks [Zhenyu](https://github.com/zyyang) for providing it!

#### Fill-in-the-blank Fashion Recommendation

fill_in_the_blank_test.json contains the questions used to evaluate the fill-in-the-blank fashion recommendation task. It follows the following format:

    {
        "question": Fashion item sequence to form the question,
        "answers": Multiple choice set to choose from,
        "blank_position": The blank position to be filled in.
    },
    
The name of a fashion item is SetID_ItemIndex, _e.g._, 119704139_1 is the fashion item with "index" 1 in the outfit with "set_id" 119704139. The first answer in "answers" is the correct one (_i.e.,_ the original fashion item in the outfit). 


#### Fashion Compatibility Prediction

fashion-compatibility-prediction.txt contains ~7,000 outfits, where 4,000 are incompatible and 3,000 are compatible.

In each line, the first number indicates compatibility (1 is compatible, 0 is not) followed by a sequence of fashion items consisting of the outfit.

### Some Notes
0. These outfits are crawled around 02/19/2017, so you can estimate the exact upload date of an outfit by looking at the "date" field.

0. For outfits that contain too many fashion items, we only keep their first 8 items.

0. We delete the fashion items with non-fashion "categoryid" such as background, texts, and decorations. As a result, the indices of items in an outfit may not be consecutive.


### Citation

If this dataset helps your research, please cite our paper:

    @inproceedings{han2017learning,
      author = {Han, Xintong and Wu, Zuxuan and Jiang, Yu-Gang and Davis, Larry S},
      title = {Learning Fashion Compatibility with Bidirectional LSTMs},
      booktitle = {ACM Multimedia},
      year  = {2017},
    }

### Other Datasets from Polyvore.com

There are several datasets crawled from Polyvore.com:

0. The Elements of Fashion Style. [[paper]](http://ranjithakumar.net/resources/vaccaro-uist2016-fashion.pdf) [[dataset]](https://github.com/kristenvaccaro/fashion-data)

0. Mining Fashion Outfit Composition Using An End-to-End Deep Learning Approach on Set Data. [[paper]](https://arxiv.org/pdf/1608.03016.pdf) [[dataset]](https://github.com/raingo/outfit)

0. NeuroStylist: Neural Compatibility Modeling for Clothing Matching. [[paper]](https://drive.google.com/file/d/0B9ef99fUwsVZbjIxNUlKTFZMWUU/view) [[dataset]](http://neurostylist.farbox.com/)

0. Learning Type-Aware Embeddings for Fashion Compatibility. [[paper]](https://arxiv.org/pdf/1803.09196.pdf)[[dataset]](https://github.com/mvasil/fashion-compatibility)[[cleaned dataset]](https://github.com/AemikaChow/AiDLab-fAshIon-Data/blob/main/Datasets/cleaned-type.md)

0. How Good Is Aesthetic Ability of a Fashion Model? [[paper]](https://openaccess.thecvf.com/content/CVPR2022/papers/Zou_How_Good_Is_Aesthetic_Ability_of_a_Fashion_Model_CVPR_2022_paper.pdf)[[dataset]](https://github.com/AemikaChow/AiDLab-fAshIon-Data/blob/main/Datasets/A100.md)


================================================
FILE: category_id.txt
================================================
2 Clothing
3 Dresses
4 Day Dresses
5 Cocktail Dresses
6 Gowns
7 Skirts
8 Mini Skirts
9 Knee Length Skirts
10 Long Skirts
11 Tops
15 Tunics
17 Blouses
18 Cardigans
19 Sweaters
21 T-Shirts
23 Outerwear
24 Coats
25 Jackets
26 Vests
27 Jeans
28 Pants
29 Shorts
30 Suits
31 Swimwear
33 Activewear
35 Bags
36 Tote Bags
37 Shoulder Bags
38 Clutches
39 Luggage
40 Wallets
41 Shoes
42 Boots
43 Pumps
46 Sandals
47 Flats
48 Flip Flops
49 Sneakers
50 Slippers
51 Accessories
52 Belts
53 Gloves
55 Hats
56 Ties
57 Sunglasses
58 Hair Accessories
59 Umbrellas
60 Jewelry
61 Watches
62 Necklaces
64 Earrings
65 Rings
343 Men's Tank Tops
67 Brooches
68 Hosiery
69 Socks
71 Men's Fashion
74 Beauty Products
75 Costumes
76 Electronics
77 Font
78 Food & Drink
85 Sleepwear
93 Makeup
94 Skincare
95 Fragrance
96 Bath & Body
97 Haircare
98 Nail Care
99 Beauty Accessories
101 Maternity
102 Baby
104 Tank Tops
105 Scarves
106 Bracelets & Bangles
107 Charms & Pendants
108 Intimates
110 Sports & Outdoors
113 Furniture
115 Sofas
116 Accent Chairs
118 Accent Tables
120 Ottomans
122 Tables
123 Chairs
124 Barstools
126 Beds
127 Dressers
129 Storage & Shelves
130 Bookcases
132 Entertainment Units
135 Lighting
136 Rugs
139 Vases
140 Candles & Candleholders
141 Frames
143 Mirrors
144 Throw Pillows
4241 Fabric
4242 Flooring
147 Office Chairs
4244 Holiday Decorations
150 Hammocks & Swings
4247 Decorative Hardware
4248 Home Fragrance
153 Outdoor Loungers & Day Beds
154 Patio Umbrellas
155 Outdoor Benches
157 Garden Fountains
4254 Small Storage
159 Bedding
160 Sheets & Pillowcases
4257 Wallpaper
162 Blankets
163 Duvet Covers
164 Bed Pillows
166 Bath
167 Bath Towels
168 Shower Curtains
169 Bath Rugs & Mats
170 Bath Accessories
4267 Outdoor Decor
172 Bakeware
173 Cutlery
174 Small Appliances
175 Cookware
176 Kitchen Gadgets & Tools
177 Drinkware
178 Flatware
179 Serveware
180 Table Linens
181 Panel Screens
182 Home Decor
184 Face Makeup
185 Cheek Makeup
186 Eye Makeup
187 Lip Makeup
188 Concealer
189 Foundation
190 Face Powder
191 Tinted Moisturizer
192 Makeup Remover
193 Makeup Primer
194 Blush
195 Cheek Bronzer
4292 Beach Towels
197 Mascara
198 False Eyelashes
199 Eyeliner
200 Lipstick
201 Lip Gloss
202 Lip Pencils
203 Lip Stain
204 Face Care
205 Face Cleansers
206 Face Toners
207 Face Moisturizers
208 Face Masks
209 Eye Care
211 Lip Treatments
213 Body Cleansers
214 Body Moisturizers
216 Hair Removal
217 Sun Care
218 Hair Shampoo
219 Hair Conditioner
220 Styling Products
221 Hair Color
222 Nail Polish
223 Nail Treatments
224 Eyelash Curlers
225 Tweezers & Brow Tools
226 Sharpeners
227 Hair Styling Tools
228 Blow Dryers & Irons
229 Brushes & Combs
231 Bags & Cases
236 Blazers
237 Skinny Jeans
238 Bootcut Jeans
239 Wide Leg Jeans
240 Boyfriend Jeans
241 Leggings
243 Jumpsuits
244 Rompers
245 Bras
246 Panties & Thongs
247 Camisoles
248 Chemises
249 Pajamas
250 Robes
251 Tights
252 Activewear Tops
253 Activewear Pants
254 Activewear Skirts
255 Activewear Shorts
256 Activewear Jackets
257 Sports Bras
258 Messenger Bags
259 Backpacks
260 Briefcases
261 Ankle Booties
262 Mid Calf Boots
263 Knee High Boots
264 Over-The-Knee Boots
265 Loafers & Moccasins
266 Oxfords
267 Clogs
268 Athletic Shoes
270 Sports Accessories
271 Men's Clothing
272 Men's Shirts
273 Men's Sweaters
275 Men's T-Shirts
276 Men's Outerwear
277 Men's Sportcoats & Blazers
278 Men's Jeans
279 Men's Pants
280 Men's Shorts
281 Men's Suits
282 Men's Swimwear
283 Men's Underwear
284 Men's Sleepwear
285 Men's Activewear
286 Men's Activewear Tops
287 Men's Activewear Pants
288 Men's Activewear Shorts
289 Men's Activewear Jackets
290 Men's Bags & Wallets
291 Men's Shoes
292 Men's Boots
293 Men's Sandals
294 Men's Flip Flops
295 Men's Loafers & Moccasins
296 Men's Dress Shoes
297 Men's Sneakers
298 Men's Athletic Shoes
299 Men's Accessories
300 Men's Belts
301 Men's Gloves
302 Men's Scarves
303 Men's Hats
304 Men's Sunglasses
305 Men's Watches
306 Suspenders
307 Cuff Links
308 Pets
309 Activewear Tank Tops
310 Straight Leg Jeans
311 Books
313 Dinnerware
314 Curtains
315 Shapewear
316 Office Accessories
317 Garden Tools
318 Handbags
319 Makeup Brushes
320 Deodorant
321 Gift Cards
4426 Eyewear
4428 Eyeglasses
333 Body Art
334 Men's Grooming
335 Men's Fragrance
4432 Outdoors
4433 Bed Accessories
338 Makeup Tools
339 Manicure Tools
340 Gift Sets & Kits
4437 Fans
342 Men's Polos
4439 Food Storage Containers
4440 Teapots
4441 Kids
4442 Juniors
4443 Jewelry Storage
4445 Cleaning
4446 Cabinets
4447 Men's Eyeglasses
4448 Media
4449 Benches
4450 Kitchen Linens
4451 Party Supplies
4452 Flared Jeans
4454 Men's Casual Shirts
4455 Men's Coats
4456 Men's Jackets
4457 Men's Vests
4458 Men's Casual Pants
4459 Men's Dress Pants
4460 Men's Socks
4461 Men's Bags
4462 Men's Briefcases
4463 Men's Wallets
4464 Men's Oxfords
4465 Men's Slippers
4466 Men's Watches & Jewelry
4467 Men's Key Rings & Chains
4468 Men's Money Clips
4470 Bow Ties
4472 Men's Tech Accessories
4473 Men's Umbrellas
4474 Men's Grooming Bags
4475 Men's Deodorant
4476 Men's Gift Sets & Kits
4477 Men's Shaving
4478 Boys
4479 Girls
4480 Health
4481 Oral Care
4482 Supplements
4483 Napkin Rings
4484 Stools
4485 Outdoor Stools
4486 Aprons
4487 Bedspreads
4488 Children's Furniture
4489 Nursery Furniture
4490 Baby Bedding
4492 Window Blinds
4493 Outdoor Patio Sets
4495 Sweatshirts
4496 Hoodies
4497 Men's Sweatshirts
4498 Men's Hoodies
4499 Dining Chairs
4500 Dining Tables
4501 Bar Cabinets
4502 Standing Fans
4503 Ceiling Lights
4504 Desk Lamps
4505 Floor Lamps
4506 Table Lamps
4507 Wall Lights
4508 Curtain Rods
4509 Children's Room
4510 Children's Bedding
4511 Children's Decor
4512 Home Improvement
4513 Paint
4514 Storage & Organization
4516 Wedding Dresses
4517 Bikini Tops
4518 Bikini Bottoms
4520 Men's Backpacks
4521 Men's Messenger Bags
4522 Men's Work Boots
4523 Men's Bracelets
4524 Men's Necklaces
4525 Men's Rings
4526 Handkerchiefs
4438 Floral Decor
4240 Clocks
146 Desks
148 File Cabinets
4246 Fireplace Accessories
151 Outdoor Tables
152 Outdoor Chairs
949 Toys
161 Comforters
4258 Window Treatments
171 Kitchen & Dining
4269 Patio Furniture
4276 Outdoor Lighting
196 Eyeshadow
3336 Stationery
1605 Bikinis
1606 One Piece Swimsuits
1607 Cover-ups
1967 Tech Accessories
332 Capri & Cropped Pants
4429 Sideboards
4430 Armoires
4431 Nightstands
336 Men's Hair Care
337 Men's Skincare
4434 Quilts & Coverlets
4435 Bar Tools
4436 Cookbooks
341 Men's Dress Shirts