| 1 |
Starting a New IFC Project |
| 2 |
========================== |
| 3 |
|
| 4 |
To ensure the best start for your IFC project, follow these steps: |
| 5 |
|
| 6 |
Start a New Blender Session |
| 7 |
--------------------------- |
| 8 |
|
| 9 |
- Close any open Blender windows. |
| 10 |
- Launch a fresh instance of Blender. |
| 11 |
|
| 12 |
This ensures there are no lingering connections or data from previous projects. |
| 13 |
|
| 14 |
Create a New IFC Project |
| 15 |
------------------------ |
| 16 |
|
| 17 |
There are two main methods to create a new IFC project: |
| 18 |
|
| 19 |
Using File Menu (Recommended) |
| 20 |
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ |
| 21 |
|
| 22 |
.. figure:: images/file_new-ifc-project-submenu.png |
| 23 |
:alt: New IFC Project submenu options |
| 24 |
|
| 25 |
New IFC Project submenu options |
| 26 |
|
| 27 |
1. Go to File > New IFC Project. |
| 28 |
2. Choose from the following options: |
| 29 |
|
| 30 |
- New Metric (m) Project: Creates a project using meters as the base unit. |
| 31 |
- New Metric (mm) Project: Creates a project using millimeters as the base unit. |
| 32 |
- New Imperial (ft) Project: Creates a project using feet as the base unit. |
| 33 |
- New Demo Project: Creates a project with pre-populated demo content. |
| 34 |
- New Project Wizard: Opens the Project Info panel for customized setup. |
| 35 |
|
| 36 |
3. If you chose one of the first four options, your project will be created immediately. |
| 37 |
4. New Project Wizard is detailed below. |
| 38 |
|
| 39 |
Using New Project Wizard / Scene Properties |
| 40 |
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ |
| 41 |
|
| 42 |
.. figure:: images/project_wizard.png |
| 43 |
:alt: Project Wizard in `Scene Properties > Project Overview` subtab |
| 44 |
|
| 45 |
Project Wizard in `Scene Properties > Project Overview` subtab |
| 46 |
|
| 47 |
|
| 48 |
1. You can access this method in two ways: |
| 49 |
|
| 50 |
- Go to `File > New IFC Project > New Project Wizard` |
| 51 |
- Navigate to Scene `Properties > Project Overview > Project Info` |
| 52 |
|
| 53 |
2. In the Project Info panel: |
| 54 |
|
| 55 |
- Choose the IFC Schema (IFC2X3, IFC4, or IFC4X3). |
| 56 |
- Select the Unit System (Metric or Imperial). |
| 57 |
- Choose Length, Area, and Volume units. |
| 58 |
- Select a Template (Blank or IFC4 Demo Template). |
| 59 |
|
| 60 |
3. Click the "Create Project" button. |
| 61 |
|
| 62 |
Cleaning the scene |
| 63 |
------------------ |
| 64 |
|
| 65 |
- After creating a new project, Bonsai considers the presence of three default Blender objects: |
| 66 |
a mesh (usually the default cube), a camera, and a light. |
| 67 |
- If have scene setup like this, Bonsai will clean it up |
| 68 |
- Any customizations you make to the Blender scene before finalizing the IFC project creation will be preserved. |
| 69 |
|
| 70 |
If you like, you can delete the default cube, camera and light manually. Or create your own objects. |
| 71 |
This is only recommended for users proficient in Blender. Otherwise, use the File menu or Create Project button in New Project Wizard. |
| 72 |
|
| 73 |
Project Initialization |
| 74 |
---------------------- |
| 75 |
|
| 76 |
.. figure:: images/outliner.png |
| 77 |
:alt: A basic spatial tree in the Outliner |
| 78 |
|
| 79 |
A basic spatial tree in the Outliner |
| 80 |
|
| 81 |
|
| 82 |
- A basic spatial tree will be created with `IfcProject > IfcSite > IfcBuilding > IfcStorey`. |
| 83 |
- You can view this structure in the Outliner. |
| 84 |
- The Project Info panel will update to show details about your new IFC project. |
| 85 |
|
| 86 |
Saving |
| 87 |
------ |
| 88 |
|
| 89 |
.. figure:: images/project-info_unsaved.png |
| 90 |
:alt: Project Info in Unsaved Mode |
| 91 |
|
| 92 |
Project Info in Unsaved Mode |
| 93 |
|
| 94 |
|
| 95 |
After creating a new project, Bonsai enters an Unsaved Mode. It's important to understand how saving works in Bonsai: |
| 96 |
|
| 97 |
**Saving IFC Project**: |
| 98 |
- Using the keyboard shortcut `Ctrl+S` or `File > Save IFC Project` will save only the `.ifc` file. |
| 99 |
- The `.blend` file remains unsaved and unnamed after this operation. |
| 100 |
|
| 101 |
**Initial Save**: |
| 102 |
- On your first save, you'll be prompted to choose a location and name for your `.ifc` file. |
| 103 |
- This does not automatically save a `.blend` file. |
| 104 |
|
| 105 |
**Blend File Saving**: |
| 106 |
- To save the `.blend` file, you need to use Blender's standard `File > Save` or `File > Save As...` options. |
| 107 |
- This operation is separate from saving the IFC project. |
| 108 |
|
| 109 |
**File Menu Options**: |
| 110 |
- `File > Save IFC Project` saves only the `.ifc` file. |
| 111 |
- `File > Save IFC Project As...` allows you to save the .ifc file to a new location or with a new name. |
| 112 |
- Standard Blender save options (`File > Save`, `File > Save As...`) only affect the .blend file. |
| 113 |
|
| 114 |
**Opening Projects**: |
| 115 |
- `File > Open IFC Project` loads only the `.ifc` file. It does not automatically load a corresponding `.blend` file. |
| 116 |
- To open a `.blend` file associated with an IFC project, you need to open it separately using Blender's standard open options. |
| 117 |
|
| 118 |
**Best Practices**: |
| 119 |
- Always use `File > Open IFC Project` to load your BIM data. |
| 120 |
- If you want to preserve Blender-specific settings or custom scene setups, save the `.blend` file separately. |
| 121 |
- Be aware that opening a `.blend` file directly will not load the associated IFC data. |
| 122 |
|
| 123 |
**For BIM Workflows**: |
| 124 |
- Focus on the `.ifc` file as the primary source of truth for your BIM data. |
| 125 |
- Use `.blend` files if you need to preserve specific Blender setups or visual configurations, but remember these are secondary to the IFC data. |
| 126 |
|
| 127 |
Remember, in Bonsai, the `.ifc` file contains the critical BIM information. |
| 128 |
The `.blend` file is primarily for Blender-specific settings and visual representations. |
| 129 |
Always ensure your IFC project is saved before closing Blender or starting a new session. |
| 130 |
If you need to preserve Blender-specific configurations, save the `.blend` file separately. |
| 131 |
|
| 132 |
Remember to save your work regularly using `File > Save IFC Project`. |
| 133 |
|
| 134 |
Next Steps |
| 135 |
---------- |
| 136 |
|
| 137 |
- Begin modeling your building elements (walls, slabs, etc.). |
| 138 |
- Set up project properties and classifications. |
| 139 |
- Start defining spaces and zones within your building. |
| 140 |
|
| 141 |
.. seealso:: |
| 142 |
- :doc:`/users/user_interface/property_editor/scene_editor/project_overview/project_info` |
| 143 |
- :doc:`/users/user_interface/topbar` |