https://github.com/google-deepmind/3d-shapes

This repository contains the 3D shapes dataset, used in Kim, Hyunjik and Mnih, Andriy. "Disentangling by Factorising." In Proceedings of the 35th International Conference on Machine Learning (ICML). 2018. to assess the disentanglement properties of unsupervised learning methods.

https://github.com/google-deepmind/3d-shapes

Science Score: 13.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
  • DOI references
  • Academic publication links
  • Committers with academic emails
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (10.4%) to scientific vocabulary
Last synced: 6 months ago · JSON representation

Repository

This repository contains the 3D shapes dataset, used in Kim, Hyunjik and Mnih, Andriy. "Disentangling by Factorising." In Proceedings of the 35th International Conference on Machine Learning (ICML). 2018. to assess the disentanglement properties of unsupervised learning methods.

Basic Info
  • Host: GitHub
  • Owner: google-deepmind
  • License: apache-2.0
  • Language: Jupyter Notebook
  • Default Branch: master
  • Homepage:
  • Size: 579 KB
Statistics
  • Stars: 144
  • Watchers: 7
  • Forks: 33
  • Open Issues: 3
  • Releases: 0
Created over 7 years ago · Last pushed about 2 years ago
Metadata Files
Readme Contributing License

README.md

3dshapes - 3D Shapes dataset

This repository contains the 3D shapes dataset, used in Kim, Hyunjik and Mnih, Andriy. "Disentangling by Factorising." In Proceedings of the 35th International Conference on Machine Learning (ICML). 2018. to assess the disentanglement properties of unsupervised learning methods.

If you use this dataset in your work, please cite it as follows:

Bibtex

@misc{3dshapes18, title={3D Shapes Dataset}, author={Burgess, Chris and Kim, Hyunjik}, howpublished={https://github.com/deepmind/3dshapes-dataset/}, year={2018} }

Description

3dshapes_gif

3dshapes is a dataset of 3D shapes procedurally generated from 6 ground truth independent latent factors. These factors are floor colour, wall colour, object colour, scale, shape and orientation.

All possible combinations of these latents are present exactly once, generating N = 480000 total images.

Latent factor values

  • floor hue: 10 values linearly spaced in [0, 1]
  • wall hue: 10 values linearly spaced in [0, 1]
  • object hue: 10 values linearly spaced in [0, 1]
  • scale: 8 values linearly spaced in [0, 1]
  • shape: 4 values in [0, 1, 2, 3]
  • orientation: 15 values linearly spaced in [-30, 30]

We varied one latent at a time (starting from orientation, then shape, etc), and sequentially stored the images in fixed order in the images array. The corresponding values of the factors are stored in the same order in the labels array.

The data is stored in a HDF5 file with the following fields:

  • images: (480000 x 64 x 64 x 3, uint8) RGB images.
  • labels: (480000 x 6, float64) Values of the latent factors.

Download data file from Google Cloud Storage

You will first need to download the data from Google Cloud Storage. Click on this link and left-click the file 3dshapes.h5 to download it.

Demo Jupyter Notebook

The repository includes a demo that shows how to load the dataset. You can open the .ipynb file using Jupyter notebook, with Python 2 installed. Make sure that the data file 3dshapes.h5 is located at the directory where the notebook is running.

Disclaimers

This dataset was created using the Generative Query Networks Mujoco environment. This is not an official Google product.

Owner

  • Name: Google DeepMind
  • Login: google-deepmind
  • Kind: organization

GitHub Events

Total
  • Watch event: 19
  • Fork event: 1
Last Year
  • Watch event: 19
  • Fork event: 1

Committers

Last synced: 10 months ago

All Time
  • Total Commits: 2
  • Total Committers: 2
  • Avg Commits per committer: 1.0
  • Development Distribution Score (DDS): 0.5
Past Year
  • Commits: 0
  • Committers: 0
  • Avg Commits per committer: 0.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email Commits
hyunjik11 h****1@g****m 1
Louise Deason l****n@g****m 1

Issues and Pull Requests

Last synced: 10 months ago

All Time
  • Total issues: 2
  • Total pull requests: 1
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Total issue authors: 2
  • Total pull request authors: 1
  • Average comments per issue: 0.0
  • Average comments per pull request: 1.0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 1
  • Pull requests: 0
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Issue authors: 1
  • Pull request authors: 0
  • Average comments per issue: 0.0
  • Average comments per pull request: 0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • dominikzietlow (1)
  • alainray (1)
Pull Request Authors
  • till2 (2)
Top Labels
Issue Labels
Pull Request Labels