This demo assumes linux operating system and bash shell. Adapt commands if you have something different.

• Follow the installation instructions for your operating system: https://github.com/3db/installers
• Activate your conda environment: conda activate threedb (if you use the default environment name, otherwise change accordingly)
• Clone this repository: git clone https://github.com/3db/demo.git
• cd demo
• Download the resources required to run this demo bash ./download_resources.sh

To run an experiment you have to:

1. Start the master process: threedb_master $RESOURCE_FOLDER $CONFIG_FILE $RESULT_FOLDER $PORT
2. Start the worker process: threedb_workers $NUM_WORKERS $RESOURCE_FOLDER 5555
3. Explore the results on the dashboard: python -m threedb.dashboard $RESULT_FOLDER

In this repository we demonstrate threedb features through multiple experiments

In this experiment, we show how to render the same object in various environment modeled by 360deg HDRI backgrounds. We demonstrate a single control: the position of the camera relative to the object.

• threedb_master experiments/simple_hdris/ experiments/simple_hdris/config.yaml /tmp/simple_hdris 5555
• threedb_workers 1 ./experiments/simple_hdris 5555

In this experiment we show how to render objects in arbitrary scenes (described by a .blend file).

• threedb_master experiments/simple_envs/ experiments/simple_envs/config.yaml /tmp/simple_envs 5555
• threedb_workers 1 ./experiments/simple_envs 5555

Being able to control the camera is nice but for most applications, users are intrested in domain specific parameters. In this experiment we show how to add a new control SunControl that is able to change the angle of the sun (i.e. the time of the day).

• threedb_master experiments/demo_sun/ experiments/demo_sun/config.yaml /tmp/demo_sun 5555
• threedb_workers 1 ./experiments/demo_sun 5555

In this experiment we demonstrate how to add a custom post processing step to the pipeline. We add a corruption control and render with it

• .threedb_master experiments/demo_corruptions/ experiments/demo_corruptions/config.yaml /tmp/demo_corruptions 5555
• threedb_workers 1 ./experiments/demo_corruptions/ 5555