Skip to content

Commit

Permalink
Apply suggestions from code review
Browse files Browse the repository at this point in the history
Apply all suggestions for `tutorials/blender_procedural_datasets.md`

Co-authored-by: Mabel Zhang <mabel.m.zhang@gmail.com>
  • Loading branch information
AndrejOrsula and mabelzhang authored Aug 27, 2022
1 parent 7abb656 commit 7fdb05f
Showing 1 changed file with 7 additions and 7 deletions.
14 changes: 7 additions & 7 deletions tutorials/blender_procedural_datasets.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,15 +7,15 @@ utilized inside robotics simulators like Gazebo. In addition to modeling,
sculpting and texturing models manually, Blender also enables procedural
generation of datasets that can facilitate diversity in simulation environments.

[procedural_dataset_generator_script]: https://github.com/ignitionrobotics/ign-gazebo/tree/ign-gazebo6/examples/scripts/blender/procedural_dataset_generator.py
[procedural_dataset_generator_script]: https://github.com/gazebosim/gz-sim/tree/ign-gazebo6/examples/scripts/blender/procedural_dataset_generator.py
Script [`procedural_dataset_generator.py`][procedural_dataset_generator_script]
supports the generation of procedural SDF models for use inside Ignition Gazebo.
supports the generation of procedural SDF models for use inside Gazebo.
Its exporting capabilities can be used with a number of existing `.blend` files.
However, the Blender project must use node-based modifiers to enable the
generation of procedural datasets (examples shown below). This script has the
following features:

1. Generation of SDF models compatible with Ignition Fuel.
1. Generation of SDF models compatible with Gazebo Fuel.

2. Exporting visual and collision mesh geometry (at different levels of detail).

Expand All @@ -28,7 +28,7 @@ following features:
## Procedural Mesh Geometry

[url_blender_docs_geometry_nodes]: https://docs.blender.org/manual/en/latest/modeling/geometry_nodes/introduction.html
[rock_blend_file]: https://github.com/ignitionrobotics/ign-gazebo/tree/ign-gazebo6/tutorials/files/blender_procedural_generation/rock.blend
[rock_blend_file]: https://github.com/gazebosim/gz-sim/tree/ign-gazebo6/tutorials/files/blender_procedural_generation/rock.blend
[Geometry Nodes][url_blender_docs_geometry_nodes] is a feature of Blender that
enables the creation and modification of mesh geometry through node-based
pipelines. By combining procedural operations with randomness, a seemingly
Expand All @@ -38,7 +38,7 @@ geometry for rocks. The corresponding `.blend` file can be accessed here (tested
with Blender 3.0/3.1): [rock.blend][rock_blend_file]. This file can be used as a
template for the creation of other custom datasets.

@image html https://github.com/ignitionrobotics/ign-gazebo/tree/ign-gazebo6/tutorials/files/blender_procedural_generation/example_rock.gif "Procedural Generation Example" width=100%
@image html https://github.com/gazebosim/gz-sim/tree/ign-gazebo6/tutorials/files/blender_procedural_generation/example_rock.gif "Procedural Generation Example" width=100%

[url_blender_tutorial_geometry_nodes_0]: https://youtube.com/watch?v=4WAxMI1QJMQ&list=PLjEaoINr3zgFX8ZsChQVQsuDSjEqdWMAD&index=9
[url_blender_tutorial_geometry_nodes_1]: https://youtube.com/watch?v=XSkaM-8Vgz8
Expand Down Expand Up @@ -69,8 +69,8 @@ mass).

[url_snap_blender]: https://snapcraft.io/blender
If Blender is installed from [snap][url_snap_blender], it will not be possible
to setup the trimesh module required for estimation of inertial properties.
Therefore, please run Blender from console with the `--python-use-system-env`
to setup the trimesh module required for the estimation of inertial properties.
Therefore, please run Blender from the console with the `--python-use-system-env`
flag.

## Future Work
Expand Down

0 comments on commit 7fdb05f

Please sign in to comment.