Debian Codegraph @

src/bonsai/docs/guides/authoring/starting_new_project.rst

raw
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`