This repository consists of Blender python scripts and corresponding assets to generate variants of the IITH-CANDLE dataset.
The rendered version of the dataset is provided at the IITH-CANDLE repository.
Download and install Blender. Make sure that it's accessible from the command line.
Note: Tests and rendering were performed on version 2.90. Unless future versions include breaking changes, functionality should be largely unaffected. We will be happy to receive a PR / issue if any incompatibilities arise.
The main script candle_simulator.py runs in an instance of blender invoked by the command:
# starts blender in the background, without audio and runs the python script
$ blender -b -noaudio -P candle_simulator.py
The rendered version of the dataset is provided at the IITH-CANDLE repository.
Each factor of variation can be independently modified or extended by simply editing or adding .blend files under ./data/ consisting of just that factor. The script then combines them independently while generating the dataset.
- Add in or modify a factor, say we add
./objects/monkey.blend. Ensure that the filename and the property name of the factor in Blender match. - Update
properties: object_typeto includemonkey. - Rendering a version now will augment IITH-CANDLE with all variants of monkey.
| Factor | Conventions |
|---|---|
| objects | We recommend the objects fit in a 1x1x1m space at the origin. This helps with uniform translation and scaling. Also update properties: object_type. |
| scenes | They are node-based world textures pointing to a HDRI image. We recommend just copying an existing one over and modifying the image to point to the required one. Also update scenes and bounds in the script with the XY coordinates where objects are allowed to be placed. |
| size | Just modify properties: size in the script. The objects will be scaled at runtime. |
| rotation | Just modify properties: rotation in the script. The objects will be rotated at runtime. |
| lights | To modify the type of light, edit lights.blend. If only the positions have to be changed, just edit lights and light_position correspondingly. |
| color (materials) | Vanilla Blender materials. Just modify properties: color as well. |
If you use IITH-CANDLE, please consider citing:
@article{candle,
title={On Causally Disentangled Representations},
journal={Proceedings of the AAAI Conference on Artificial Intelligence},
author={Abbavaram Gowtham Reddy, Benin Godfrey L, and Vineeth N Balasubramanian},
year={2022},
month={February}
}
This work is licensed under the MIT License and the dataset itself is licensed under the Creative Commons Attribution 4.0 International License.