Download images and labels from scratch the surface.

Scratch the surface is a blog I maintain with a labeled collection of surfaces.

Its goals are:

• Highlight the often unnoticed beauty of the surfaces around us.

• Provide an ever increasing repository of labeled surfaces.

If you wanted a labeled collection of surfaces to train a classifier, to texturize your videogame or because any other reason, you came to the right place.

• BeautifulSoup
• pandas
• requests

Download images, contexts and labels:

python3 surface-scratcher.py

I try to upload a new surface everyday, so if you want to keep your local dataset up to date, you can do as follows:

python3 surface-scratcher.py --update

Each surface has a context image, i.e. a photo of the object that contains said surface. If you don't want/need the context images, you can disable its download:

python3 surface-scratcher.py --no_context

This information is also available, doing so: python3 surface-scratcher.py -h

After running the program will you get two folders: surfaces and contexts that contain the surfaces and the context images respectively. Each image is labeled with its index.

You will also get a csv file named labels.csv where each row contains the index and information of each surface.

This program is licensed under the MIT License - see the LICENSE file for details.