NativeIFC/pt-br

Warning: The NativeIFC functionality is still a work-in-progress and is not finished. Please bear that in mind when using and not rely on it until you are confident it can do what you intend. See the development roadmap to read more about the development, what's working and what's planned.

Starting from version 1.0, FreeCAD uses the Native IFC concept. It allows FreeCAD users to open, manipulate and create IFC files natively in FreeCAD.

Although FreeCAD already supported opening and saving IFC files through the Arch workbench for a long time, it did so, like most other BIM applications, by translating back and forth between the IFC file format and FreeCAD's internal data model. This means two translations, one when opening and another one when saving, which cause data loss, and a complete rewrite of the file each time. This turns it unsuitable for version control systems like Git, and very hard to locate changes.

Native IFC means that the IFC file is itself the data structure in FreeCAD. When opening an IFC file in FreeCAD, what you see on the screen is a direct rendering of the contents of the IFC file. Anything you modify will directly modify the IFC file. If you open a file, modify one element and save the file, the only thing that will have changed in the file is the line concerning that element. The rest of the file will be 100% identical to how it was before you saved. No data loss, and very identifiable changes.

The Native IFC idea itself comes from this paper by Bruno Postle. It is heavily inspired by BlenderBIM and tries as much as possible to use the same concepts and reuse the code. The final goal is to offer in FreeCAD the same level of functionality and performance found in BlenderBIM, and to upstream as much as possible to IfcOpenShell, the common IFC engine used by both applications. It started as a separate project by Yorik

Working with native IFC files in FreeCAD is simple: Open an existing IFC file or create a new project using the Project tool from the BIM Workbench. Create new objects with any of the FreeCAD workbenches or tools. Add these objects to your IFC project by dragging them into the project structure. Save the file, and you are done.

Locked and unlocked modes

The BIM Workbench offers two modes to work with IFC files. Switching between the two modes is done by clicking the lock button on the FreeCAD status bar:

File concepts

In unlocked mode, you have IFC project objects attached to IFC files, and the FreeCAD document is dependent on these IFC files. If you wish to transmit your FreeCAD file to someone else, you need to given them the IFC files too. Alternatively, you can also set the Shape mode of all the objects to "Shape" (see below). This will make the FreeCAD file retain the shape of all the IFC objects, and render them correctly even without the attached IFC file. However, the IFC objects inside will no longer be editable.

IFC objects vs BIM objects

When a BIM object or any other FreeCAD object is bound to a Native IFC project, it becomes an IFC object. Binding an object to a Native IFC project is done simply by dragging, in the tree view, the object onto the project or onto any object that is already part of that project, for example a building or a storey.

Once an object has become an IFC object, it is entirely controlled by the IFC data. It looses its former FreeCAD parametric object, and might loose any parametric properties and features that are not supported by the IFC format. The aim here is in the future to render all this seamless and keep the same editing possibilities for both IFC and non-IFC objects.

Opening and importing IFC files

• If you open, a new document will be created and you will automatically be in locked mode
• If you import, a native IFC project object will be added to the current document, but you can still create non-IFC objects outside that project. You will still be in unlocked mode

To open an IFC file, use menu File → Open and select an IFC file. To import an IFC file, use menu File → Import and select an IFC file.

To maximize initial import speed, opening or importing IFC files will by default render only the top-level object (usually a Site) in FreeCAD. To expand the contents of this object, you need to double-click it in the tree view (see below).

Importing or opening an IFC file does not require the setting of any option. However, some defaults can be tweaked under menu Edit → Preferences → BIM → NativeIFC.

Creating a new IFC document

You can choose to work in locked or unlocked mode, depending mostly if you need to have non-IFC objects in your FreeCAD document (unlocked) or wish that everything you do in the document happens in the IFC file (locked).

1. Create a new FreeCAD document with menu File -> New
2. Press the IFC Lock button on the status bar to lock the document

1. Press the Project button to create a native IFC project in the current FreeCAD document. You can have more than one in a same FreeCAD document

Saving and exporting IFC files

You can always export any FreeCAD model to IFC, even if it was not built with BIM tools or contains non-BIM elements. The non-BIM objects will simply be exported as generic IfcBuildingElementProxy entities, while BIM objects can have their class (IfcWall, IfcDoor,...) defined.

• When working in locked mode, all of what happens in your FreeCAD document is saved to the IFC file. There is no need to save the FreeCAD file anymore, and the menu entries File → Save and File → Save As are replaced with File → Save IFC file and File → Save IFC file As.... Saving the IFC file is all that's needed, there is no more .FCStd file.

• When working in unlocked mode, each IFC project object in your document will be attached to a separate IFC file. A project object keeps track of changes and its icon will show a red dot when it contains unsaved changes. Saving your FreeCAD document will also save all the IFC files attached to IFC projects found in the document.

Expanding file contents

You can also collapse expanded objects by right-clicking them in the tree and selecting IFC -> collapse children.

Loading and unloading shapes

By default, to gain speed, IFC objects don't load their full shape. Only a lightweight 3D representation is shown in the 3D view. This warrants fast import and expand operations. However complex geometric operations such as boolean operations or sections performed by section planes require the full shape to be present. In these cases, you might need to load the shape of the objects you need to perform these operations on.

To load the shape of selected objects, simply set their Shape Mode property to Shape.

Classes, attributes and properties

All IFC objects always have at least two properties: Class and Step ID. The class is the IFC class (IfcWall, IfcWindow, etc...) and the Step ID is the ID of the element in the IFC file. The Step ID is actually the sole data needed to locate the object in the IFC file. You can change the class of an object anytime, it won't have any impact over the geometry or property sets but might change available attributes (see below). You can only change to a sibling class, a parent class or a descendant class. If you want to change to a class that is very distant from the current class, you will need to know the IFC class structure and repeat the operation several times.

Layers and Materials

Layers get loaded when double-clicking an object. Layers get represented as normal FreeCAD layers, but they are hosted inside the IFC project. When using the BIM Layers tool, an additional icon indicates if the layer is part of an IFC project or not.

Materials follow the same logic. They are only loaded when double-clicking the object, they are represented as normal materials, but get hosted inside the IFC project.

Building structure

By the IFC standards, all IFC files must contain one and only one IfcProject (or IfcProjectLibrary) object, which constitutes the root of your IFC model. All other IFC objects can be freely aggregated under this root object (an idea we call a "flat file"), but the IFC standards require to have at least one building container object (IfcSite, IfcBuilding or IfcBuildingStorey) under the root IfcProject. In FreeCAD, with the default options set, exported IFC files will always contain the IfcProject and at least one building container (default ones will be created if you don't have one).

Although it is not mandatory, it is common practice in IFC files to always have a same basic structure:

IfcProject

  -> IfcSite
     -> IfcBuilding
        -> IfcBuildingStorey

You can also use groups inside your IFC projects. However, the IFC standard does not allow to nest groups inside a building structure. So these groups will be converted to IfcAssemblies. However, since most BIM applications will happily work with nested groups, you can turn off this conversion in IFC export preferences.

Check for changes in an IFC project

One of the main advantages of the native IFC system, is that only the things you change in FreeCAD get reflected in the IFC file attached to a project. As a result, that IFC file contains only very few changes, as opposed to traditional BIM applications where the IFC file is completely rewritten at each export.

This allows to precisely locate the changes inside the file. Moving a wall, for example, changes only one line: The placement of that wall. This in turn allows version control systems like Git to precisely identify those changes, and only save the increments of each new version.

You can get a visual representation (diff) of the changes in a selected IFC project by using menu Utils -> IFC Diff or, in unlocked mode, right-clicking an IFC project and selecting IFC -> Diff.

Adding, deleting and modifying objects

In locked mode, any new object added (BIM or not) gets immediately converted to IFC. There is nothing more to do.

In unlocked mode, any new object (BIM or not) added to the document needs to added to an IFC project. This is done by dragging the object in the tree view and dropping anywhere inside the structure of an IFC project.

Deleting objects that are inside an IFC project will delete them from the IFC file as well.

Once an object becomes an IFC object, it looses its former FreeCAD parametric abilities and inherits all its behaviour from the IFC file. As of FreeCAD 1.0, the editing possibilities of IFC objects are still limited, and are done entirely via properties (no graphical edit available yet). To edit an object, you must have loaded its geometry properties. This is done either by double-clicking it or right-clicking and choosing IFC -> add geometric properties in the tree view.

Editable geometric properties such as "Height" or "Width" are then added to the object. This is a work in progress, not all properties are supported yet. Changing the value of these properties will change the shape of the object.