FreeMVD_Mirror/IFC_roundtrip_specification...

213 lines
14 KiB
Markdown
Raw Normal View History

# IFC roundtripping specifications
This file lists "exercises" to be performed by a BIM application to achieve adequate round-tripping with IFC files. The application should successfully complete all the steps.
2020-05-23 18:59:41 +00:00
---
## File Naming Convension Examples:
2020-05-23 23:46:46 +00:00
| 1 Original File | 2 Exported IFC File | 3 Imported Native File | 4 Exported IFC File | 5 Imported Native File |
| ------------------- | ---------------------- | ------------------------ | ---------------------------- | ---------------------------- |
| Extrusions_01.FCStd | Extrusions_02_PASS.ifc | Extrusions_03_PASS.rvt | Extrusions_04_FAIL_rvt.ifc | Extrusions_05_FAIL_rvt.rvt |
| | | | | Extrusions_05_FAIL_rvt.FCStd |
| | | Extrusions_03_PASS.FCStd | | |
| | | Extrusions_03_PASS.blend | Extrusions_04_PASS_blend.ifc | Extrusions_05_PASS_blend.rvt |
| | | Extrusions_03_PASS.pln | Extrusions_04_PASS_pln.ifc | Extrusions_05_PASS_pln.pln |
| | | | | Extrusions_05_PASS_pln.rvt |
2020-05-12 08:29:07 +00:00
2020-05-23 18:59:41 +00:00
---
# Tests
---
## Extrusions_Rectangles
The application should be able to export and import an IFC file containing three IfcBuildingElementProxy entities, each with one representation, which is an IfcExtrudedAreaSolid, each based on IfcArbitraryClosedProfileDef made of an IfcPolyline, like the example below. One profile should lie on the XY plane, one in the YZ plane, and a third on a plane made of one of the former rotated 45° along the Y axis. Extrusion directions should be normal to the profiles.
![](Specifications_Test_Files/Extrusions_Rectangles/from_FreeCAD/Extrusions_Rectangles_example.png)
2020-05-14 09:19:00 +00:00
```
#20= IFCBUILDINGELEMENTPROXY('0ohBfsArr3ruXYxacT4yl5',#1,'NOTDEFINED',$,$,#2,#21,$,.NOTDEFINED.);
#21= IFCPRODUCTDEFINITIONSHAPE($,$,(#22));
#22= IFCSHAPEREPRESENTATION(#9,'Body','SweptSolid',(#23));
#23= IFCEXTRUDEDAREASOLID(#24,#31,#25,2000.);
#24 = IFCARBITRARYCLOSEDPROFILEDEF(.AREA., $, #26);
#26 = IFCPOLYLINE((#27, #28, #29, #30));
#27 = IFCCARTESIANPOINT((0., 0.));
#28 = IFCCARTESIANPOINT((1000., 0.));
#29 = IFCCARTESIANPOINT((1000., 1000.));
#30 = IFCCARTESIANPOINT((0., 1000.));
#25= IFCDIRECTION((0.,0.,1.));
#31= IFCAXIS2PLACEMENT3D(#32,#33,#34);
#32= IFCDIRECTION((0.7071,0.,-0.7071));
#33= IFCDIRECTION((0.7071,0.,0.7071));
#34= IFCCARTESIANPOINT((1000.,0.,2000.));
```
2020-05-24 17:32:36 +00:00
#### Native Funtionality
| Program | Native funtion/object |
| ------------ | ------------------------------------------------------------------------------- |
| ArchiCAD | |
| BlenderBIM | Mesh - IfcArbitraryClosedProfileDef & ExtrudedDirection saved via Vertex Groups |
| FreeCAD | |
| Microstation | |
| Revit | Model-in-Place Family - Solid Extrusion |
| Vectorworks | |
2020-06-01 13:50:12 +00:00
2020-05-24 17:32:36 +00:00
### Import criteria
* The extrusion directions and profile positions are correct
* The extrusions can be changed after import
* The base polylines can be edited after import
2020-05-24 17:32:36 +00:00
### Export criteria
2020-05-23 19:10:25 +00:00
* The exported IFC file contains three
* IfcBuildingElementProxy, each with an
* IfcExtrudedAreaSolid as its representation and an
* IfcArbitraryClosedProfileDef made of an
2020-05-23 19:11:54 +00:00
* IfcPolyline as its profile.
2020-05-24 17:32:36 +00:00
### Results
2020-05-15 13:33:21 +00:00
2020-06-01 13:50:12 +00:00
Test files here: [FreeMVD_WorkFlow/Specifications_Test_Files/Extrusions_Rectangles/](https://gitlab.com/OpeningDesign/FreeMVD_WorkFlow/tree/master/Specifications_Test_Files/Extrusions_Rectangles)
| Program | Version<br/>native/plugin | Imported Native File (PASS/FAIL) | Import Comments | Exported IFC File (PASS/FAIL) | Export Comments |
| ----------- | ------------------------- | --------------------------------- | ------------------------------------------------------------ | ------------------------------ | -------------------------------------------------------------------------------------------------------- |
| ArchiCAD | | | | | |
| BlenderBIM | 2.82a/0.200621 | :heavy_check_mark: | editing the profile's base polylines, however, is cumbersome | :heavy_check_mark: | |
| FreeCAD | | :heavy_check_mark: | | :heavy_check_mark: | |
| Revit | 2020/20.1.0.1 | :heavy_check_mark: | | :x: | - Incorrect extrusion direction <br>- IFCARBITRARYCLOSEDPROFILEDEF was changed to IFCRECTANGLEPROFILEDEF |
| Vectorworks | | | | | |
2020-06-01 13:50:12 +00:00
2020-05-24 17:32:36 +00:00
## Mapped Items
2020-05-23 23:46:46 +00:00
Mapped Items, which go by many different names in different BIM apps (a few called out below), are objects where the definition of one object is connected to another. That is, if one istance is modified, these changes will also be reflected in other connected or linked instances.
2020-05-23 23:49:32 +00:00
![](Specifications_Test_Files/Mapped_Items/imgs/Mapped_Items_Code.png)
2020-05-23 23:46:46 +00:00
2020-05-24 17:32:36 +00:00
#### Native Funtionality
2020-05-23 23:46:46 +00:00
2020-05-24 17:32:36 +00:00
| Program | Native funtion/object |
| ------------ | --------------------- |
| ArchiCAD | Objects, Modules |
| BlenderBIM | Linked Objects |
| FreeCAD | Clones |
| Microstation | Cells |
| Revit | Groups, Families |
| Vectorworks | Symbols |
2020-05-23 23:46:46 +00:00
2020-05-23 23:49:32 +00:00
![](Specifications_Test_Files/Mapped_Items/imgs/Mapped_Items_Visual.gif)
2020-05-23 23:46:46 +00:00
2020-05-24 17:32:36 +00:00
### Import criteria
2020-05-23 23:46:46 +00:00
- That the connection or link between objects in still intact. That is, if one instance is changed, the other instances will change as well.
2020-05-24 17:32:36 +00:00
### Export criteria
2020-05-23 23:46:46 +00:00
- The IFC file has the same shared mapping connected to the objects--circled in red below.
2020-05-23 23:49:32 +00:00
![](Specifications_Test_Files/Mapped_Items/imgs/Mapped_Items_Code_circled.png)
2020-05-23 23:46:46 +00:00
2020-05-24 17:32:36 +00:00
### Results
2020-05-24 00:22:51 +00:00
2020-06-01 13:50:12 +00:00
Test files here: [Specifications_Test_Files/Mapped_Items/](https://gitlab.com/OpeningDesign/FreeMVD_WorkFlow/tree/master/Specifications_Test_Files/Mapped_Items)
| Program | Version<br/>native/plugin | Imported Native File (PASS/FAIL) | Import Comments | Exported IFC File (PASS/FAIL) | Export Comments |
| ----------- | ------------------------- | -------------------------------- | ------------------------------- | ------------------------------ | --------------- |
| ArchiCAD | | | | | |
| BlenderBIM | 2.82a/0.200511 | :heavy_check_mark: | | :heavy_check_mark: | |
| FreeCAD | | :heavy_check_mark: | | :heavy_check_mark: | |
| Revit | 2020/20.1.0.1 | :x: | link was broken between objects | :x: | |
| Vectorworks | | | | | |
2020-06-01 13:50:12 +00:00
## Extrusions_Circles
2020-05-29 10:31:51 +00:00
The application should be able to export and import an IFC file containing 2 circle extrusions.
2020-05-29 10:31:51 +00:00
![](Specifications_Test_Files/Extrusions_Circles/from_Revit/imgs/Extrusions_Circles_01.rvt.png)
2020-05-29 10:31:51 +00:00
#### Native Funtionality
| Program | Native funtion/object |
| ------------ | --------------------------------------- |
| ArchiCAD | |
| BlenderBIM | |
| FreeCAD | |
| Microstation | |
| Revit | Model-in-Place Family - Solid Extrusion |
2020-05-29 10:31:51 +00:00
| Vectorworks | |
### Import criteria
* The extrusion directions and profile positions are correct
* The extrusions can be changed after import
* The radius of the circles can be changed after import
### Export criteria
- (2) IFCEXTRUDEDAREASOLIDs with
- (1) IFCCIRCLEPROFILEDEF
### Results
2020-06-01 13:50:12 +00:00
Test files here: [FreeMVD_WorkFlow/Specifications_Test_Files/Extrusions_Circles](https://gitlab.com/OpeningDesign/FreeMVD_WorkFlow/tree/master/FreeMVD_WorkFlow/Specifications_Test_Files/Extrusions_Circles)
| Program | Version<br/>native/plugin | Imported Native File (PASS/FAIL) | Import Comments | Exported IFC File (PASS/FAIL) | Export Comments |
| ----------- | ------------------------- | --------------------------------- | ------------------------------------ | ------------------------------ | ------------------------------------------------------------------------------------- |
| ArchiCAD | | | | | |
| BlenderBIM | | | | | |
| FreeCAD | | | | | |
| Revit | | Partial | creates (2) arcs instead of a circle | :heavy_check_mark: | if native file has (2) arcs as the profile, it still exports as IFCCIRCLEPROFILEDEFs |
| Vectorworks | | | | | |
2020-06-01 13:50:12 +00:00
## Extrusions_Arcs
The application should be able to export and import an IFC file containing 2 extrusions with arcs in the profile.
![](Specifications_Test_Files/Extrusions_Arcs/from_Revit/imgs/Extrusions_Arcs_01.rvt.png)
#### Native Funtionality
| Program | Native funtion/object |
| ------------ | --------------------------------------- |
| ArchiCAD | |
| BlenderBIM | |
| FreeCAD | |
| Microstation | |
| Revit | Model-in-Place Family - Solid Extrusion |
| Vectorworks | |
### Import criteria
* The extrusion directions and profile positions are correct
* The extrusions can be changed after import
* The radius of the arcs can be changed after import
### Export criteria
- IFCEXTRUDEDAREASOLID
- IFCARBITRARYCLOSEDPROFILEDEF
- IFCCOMPOSITECURVE
- (1) IFCCOMPOSITECURVESEGMENT *(the arc)*
- IFCTRIMMEDCURVE
- IFCCIRCLE
- (4) IFCCOMPOSITECURVESEGMENT *(the straight lines)*
2020-05-30 18:50:40 +00:00
- IFCPOLYLINE
2020-05-29 10:31:51 +00:00
### Results
2020-06-01 13:50:12 +00:00
Test files here: [FreeMVD_WorkFlow/Specifications_Test_Files/Arcs](https://gitlab.com/OpeningDesign/FreeMVD_WorkFlow/tree/master/FreeMVD_WorkFlow/Specifications_Test_Files/Extrusions_Arcs)
| Program | Version<br/>native/plugin | Imported Native File (PASS/FAIL) | Import Comments | Exported IFC File (PASS/FAIL) | Export Comments |
| -------------------------------- | ------------------------- | --------------------------------- | --------------- | ------------------------------ | --------------- |
| ArchiCAD | | | | | |
| BlenderBIM | | | | | |
| FreeCAD | | | | | |
| Revit | | :heavy_check_mark: | | :heavy_check_mark: | |
| Vectorworks | | | | | |
| <!--stackedit_data: | | | | | |
| eyJoaXN0b3J5IjpbLTgxOTIwMzg0MF19 | | | | | |
| --> | | | | | |