Skip to content

Commit

Permalink
Updated blenderproc readme
Browse files Browse the repository at this point in the history
  • Loading branch information
nv-jeff committed Mar 8, 2024
1 parent 0760bcd commit b933570
Showing 1 changed file with 7 additions and 6 deletions.
13 changes: 7 additions & 6 deletions data_generation/blenderproc_data_gen/README.md
Original file line number Diff line number Diff line change
@@ -1,16 +1,17 @@
Blenderproc is made to create a single scene and render many frames. Adding/removing objects (such as varying the number of distractors) will cause memory bloat and poor performance. Instead, we use a batching script (`run_blenderproc_datagen.py`) to run blenderproc several times.
# Synthetic Data Generation with Blenderproc


## Usage example:
[Blenderproc](https://github.com/DLR-RM/BlenderProc) is intended to create a single scene and render multiple frames of it. Adding and removing objects (such as varying the number of distractors) will cause memory bloat and poor performance. To avoid this issue, we use a batching script (`run_blenderproc_datagen.py`) to run a standalone blenderproc script several times.

Run the blenderproc script 50 times, each time generating 1000 frames:
```

./run_blenderproc_datagen.py --nb_runs 5 --objs_folder ../models/ --nb_objects 5 --distractors_folder ../google_scanned_models/ --nb_distractors 10 --backgrounds_folder ~/data/ImageNet2012/val --nb_frames 10 --outf ~/data/DOPE/mine/Ketchup_Nov17/
## Usage example:

Run the blenderproc script 5 times, each time generating 1000 frames. Each frame will have five copies of the object and ten randomly chosen distractor objects:
```
./run_blenderproc_datagen.py --nb_runs 5 --nb_frames 1000 --objs_folder ../models/ --nb_objects 5 --distractors_folder ../google_scanned_models/ --nb_distractors 10 --backgrounds_folder ~/data/ImageNet2012/val --nb_frames 10 --outf ~/data/DOPE/Ketchup/
```

All parameters can be shown by running `python ./run_blenderproc_datagen.py --help`


Note that, as a blenderproc script, `generate_training_data.py` cannot be invoked with Python. It must be run via the `blenderproc` launch script.

0 comments on commit b933570

Please sign in to comment.