| 1 |
Working with Representations |
| 2 |
---------------------------- |
| 3 |
|
| 4 |
Bonsai provides tools to view, edit, and manage representations of IFC elements directly within Blender's interface. |
| 5 |
This section covers how to work with these representations effectively. |
| 6 |
|
| 7 |
Viewing Representations |
| 8 |
^^^^^^^^^^^^^^^^^^^^^^^ |
| 9 |
|
| 10 |
To view the representations of an IFC element: |
| 11 |
|
| 12 |
1. Select the element in the 3D viewport. |
| 13 |
2. Navigate to Scene > Geometry and Materials > Representations in the Properties panel. |
| 14 |
3. You'll see a list of all representations associated with the element, including their context and type. |
| 15 |
|
| 16 |
Editing Representations |
| 17 |
^^^^^^^^^^^^^^^^^^^^^^^ |
| 18 |
|
| 19 |
To edit an existing representation: |
| 20 |
|
| 21 |
1. In the Representations panel, click on the representation you want to edit to make it active. |
| 22 |
2. Switch to Edit Mode in the 3D viewport. |
| 23 |
3. Make your desired changes to the geometry. |
| 24 |
4. Once finished, click "Manually Save Representation" in the Representation Utilities section. |
| 25 |
|
| 26 |
.. note:: |
| 27 |
Not all representation types can be directly edited. For example, SweptSolid representations cannot be modified in this way. |
| 28 |
|
| 29 |
Adding Representations |
| 30 |
^^^^^^^^^^^^^^^^^^^^^^ |
| 31 |
|
| 32 |
To add a new representation to an element: |
| 33 |
|
| 34 |
1. Select the element in the 3D viewport. |
| 35 |
2. In the Representations panel, use the dropdown menu at the top to select the desired context (e.g., Model, Plan). |
| 36 |
3. Click the "+" button next to the dropdown. |
| 37 |
4. In the dialog that appears, choose the method for creating the representation (e.g., Trace Outline, Bounding Box). |
| 38 |
5. Follow any additional prompts to complete the creation of the new representation. |
| 39 |
|
| 40 |
Common Representation Types in Bonsai |
| 41 |
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ |
| 42 |
|
| 43 |
Bonsai supports several representation types, each suitable for different purposes: |
| 44 |
|
| 45 |
1. SweptSolid |
| 46 |
- RepresentationIdentifier: 'Body' |
| 47 |
- RepresentationType: 'SweptSolid' |
| 48 |
- Description: Used for 3D shapes created by extruded area solids or revolved area solids. |
| 49 |
- Typical use: Walls, columns, beams with simple profiles. |
| 50 |
|
| 51 |
2. Tessellation |
| 52 |
- RepresentationIdentifier: 'Body' |
| 53 |
- RepresentationType: 'Tessellation' |
| 54 |
- Description: Represents 3D shapes using tessellated surface models. |
| 55 |
- Typical use: Complex geometries, imported meshes. |
| 56 |
|
| 57 |
3. Clipping |
| 58 |
- RepresentationIdentifier: 'Body' |
| 59 |
- RepresentationType: 'Clipping' |
| 60 |
- Description: 3D shapes created using Boolean operations with half-spaces. |
| 61 |
- Typical use: Complex shapes with cutouts or intersections. |
| 62 |
|
| 63 |
4. Curve2D |
| 64 |
- RepresentationIdentifier: 'Axis' |
| 65 |
- RepresentationType: 'Curve2D' |
| 66 |
- Description: 2D curves, often used for wall axes or material layer alignments. |
| 67 |
- Typical use: Defining the centerline of walls. |
| 68 |
|
| 69 |
5. Curve3D |
| 70 |
- RepresentationIdentifier: 'Axis' |
| 71 |
- RepresentationType: 'Curve3D' |
| 72 |
- Description: 3D curves, used for axes of longitudinal elements. |
| 73 |
- Typical use: Defining the profile of walls, openings. |
| 74 |
|
| 75 |
|
| 76 |
Converting Representations |
| 77 |
^^^^^^^^^^^^^^^^^^^^^^^^^^ |
| 78 |
|
| 79 |
Bonsai offers tools to convert between different representation types: |
| 80 |
|
| 81 |
1. Select the representation you want to convert. |
| 82 |
2. In the Representation Utilities section, you'll find options like: |
| 83 |
- Convert To Tessellation |
| 84 |
- Convert To Rectangle Extrusion |
| 85 |
- Convert To Circle Extrusion |
| 86 |
- Convert To Arbitrary Extrusion |
| 87 |
|
| 88 |
.. warning:: |
| 89 |
Converting representations may result in loss of parametric information. Use these tools with caution. |
| 90 |
|
| 91 |
Best Practices |
| 92 |
^^^^^^^^^^^^^^ |
| 93 |
|
| 94 |
- Always use the appropriate representation type for the element you're modeling. |
| 95 |
- Be cautious when editing representations directly, as this may affect the element's relationship with its type or other elements. |
| 96 |
- When possible, use parametric definitions (like Material Layers for walls) instead of direct mesh editing. |
| 97 |
- Regularly check the IFC validity of your model after making significant changes to representations. |
| 98 |
|
| 99 |
Future Developments |
| 100 |
^^^^^^^^^^^^^^^^^^^ |
| 101 |
|
| 102 |
The Bonsai team is continually working on improving the representation editing experience. Future updates may include: |
| 103 |
|
| 104 |
- More intuitive interfaces for non-mesh modeling. |
| 105 |
- Enhanced tools for working with parametric representations. |
| 106 |
- Improved validation and error checking when editing representations. |
| 107 |
|
| 108 |
For the latest updates and feature requests, refer to the Bonsai GitHub repository. |