Haven

The focus of this example is the haven dataset collection.

In order to use this example first download all the haven assets via the haven download script:

blenderproc download haven

This will download all 3D models, all environment HDRs and also all textures they provide.

Usage

Execute in the BlenderProc main directory:

blenderproc run examples/datasets/haven/main.py resources/haven/models/ArmChair_01/ArmChair_01_2k.blend resources/haven examples/datasets/haven/output

• examples/datasets/haven/main.py: path to the python file with pipeline configuration.
• resources/haven/models/ArmChair_01/ArmChair_01.blend: Path to the blend file, from the haven dataset, browse the model folder, for all possible options
• resources/haven: The folder where the hdri folder can be found, to load an world environment
• examples/datasets/haven/output: path to the output directory.

Visualization

In the output folder you will find a series of .hdf5 containers. These can be visualized with the script:

blenderproc vis hdf5 examples/datasets/haven/output/*.hdf5

Steps

• The BlendLoader loads the given blend file and extracts the object
• Then the HavenEnvironmentLoader loads a randomly selected HDR image as world environment

Python file (main.py)

BlendLoader

# Load the object into the scene
objs = bproc.loader.load_blend(args.blend_path)

The bproc.loader.load_blend() loads the given blend file and extracts the object from it.

HavenEnvironmentLoader

# Set a random hdri from the given haven directory as background
haven_hdri_path = bproc.loader.get_random_world_background_hdr_img_path_from_haven(args.haven_path)
bproc.world.set_world_background_hdr_img(haven_hdri_path)

This loader will load a random HDR image and will use it as an environment background for the scene.