FreeMVD_Mirror/IFC_roundtrip_specification...

368 lines
22 KiB
Markdown
Raw Permalink 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-28 19:03:24 +00:00
Test files here: [FreeMVD_WorkFlow/Specifications_Test_Files/Extrusions_Rectangles/](https://gitlab.com/OSarch/FreeMVD_WorkFlow/tree/master/Specifications_Test_Files/Extrusions_Rectangles)
2020-06-01 13:50:12 +00:00
| 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-06-28 18:39:20 +00:00
---
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 | Mesh |
2020-05-29 10:31:51 +00:00
| 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-28 19:03:24 +00:00
Test files here: [FreeMVD_WorkFlow/Specifications_Test_Files/Extrusions_Circles](https://gitlab.com/OSarch/FreeMVD_WorkFlow/tree/master/FreeMVD_WorkFlow/Specifications_Test_Files/Extrusions_Circles)
2020-06-01 13:50:12 +00:00
| Program | Version<br/>native/plugin | Imported Native File (PASS/FAIL) | Import Comments | Exported IFC File (PASS/FAIL) | Export Comments |
| ----------- | ------------------------- | --------------------------------- | --------------------------------------------------------------------------------------------------------------------- | ------------------------------ | ------------------------------------------------------------------------------------- |
| ArchiCAD | | | | | |
| BlenderBIM | 2.82a/200829-win | Partial | the radius value is not accessible.  Possible room for UI improvement in the future, in using modifiers, curves, etc. | :heavy_check_mark: | |
| 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-28 19:19:45 +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-28 19:03:24 +00:00
Test files here: [FreeMVD_WorkFlow/Specifications_Test_Files/Arcs](https://gitlab.com/osarch/FreeMVD_WorkFlow/-/tree/master/Specifications_Test_Files/Extrusions_Arcs)
2020-06-01 13:50:12 +00:00
2020-08-14 15:47:14 +00:00
| 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 | FAIL | creates a faceted mesh | FAIL | |
| FreeCAD | | | | | |
2020-08-14 15:47:14 +00:00
| Revit | | :heavy_check_mark: | | :heavy_check_mark: | |
| VectorWorks | | | | | |
2020-06-28 19:19:45 +00:00
2020-06-29 14:55:07 +00:00
## Extrusions_Void_InnerBoundary
2020-06-29 14:55:07 +00:00
![](Specifications_Test_Files/Extrusions_Void_InnerBoundary/from_Revit/Extrusions_Void_InnerBoundary_01.png)
2020-06-28 18:39:20 +00:00
#### 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 base polylines can be edited after import
### Export criteria
- IFCEXTRUDEDAREASOLID
- IFCARBITRARYPROFILEDEFWITHVOIDS
- IFCPOLYLINE
- IFCPOLYLINE
### Results
2020-06-29 14:55:07 +00:00
Test files here: [FreeMVD_WorkFlow/Specifications_Test_Files/Extrusions_Void_InnerBoundary/](https://gitlab.com/osarch/FreeMVD_WorkFlow/-/tree/master/Specifications_Test_Files/Extrusions_Void_InnerBoundary)
2020-06-28 18:39:20 +00:00
2020-08-14 15:47:14 +00:00
| 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 | :x: | Profile and Extrusion Direction not available | | |
| FreeCAD | | | | :heavy_check_mark: | |
| Revit | 2020/20.1.0.1 | :heavy_check_mark: | | :heavy_check_mark: | |
| Vectorworks | | | | | |
2020-06-28 18:39:20 +00:00
---
## Mapped Items
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.
![](Specifications_Test_Files/Mapped_Items/imgs/Mapped_Items_Code.png)
#### Native Funtionality
| Program | Native funtion/object |
| ------------ | --------------------- |
| ArchiCAD | Objects, Modules |
| BlenderBIM | Linked Objects |
| FreeCAD | Clones |
| Microstation | Cells |
| Revit | Groups, Families |
| Vectorworks | Symbols |
![](Specifications_Test_Files/Mapped_Items/imgs/Mapped_Items_Visual.gif)
### Import criteria
- That the connection or link between objects in still intact. That is, if one instance is changed, the other instances will change as well.
### Export criteria
- The IFC file has the same shared mapping connected to the objects--circled in red below.
![](Specifications_Test_Files/Mapped_Items/imgs/Mapped_Items_Code_circled.png)
### Results
2020-06-28 18:55:52 +00:00
Test files here: [Specifications_Test_Files/Mapped_Items/](https://gitlab.com/OSarch/FreeMVD_WorkFlow/tree/master/Specifications_Test_Files/Mapped_Items)
2020-06-28 18:39:20 +00:00
| Program | Version<br/>native/plugin | Imported Native File (PASS/FAIL) | Import Comments | Exported IFC File (PASS/FAIL) | Export Comments |
| ----------- | ------------------------- | -------------------------------- | ------------------------------- | ------------------------------ | --------------- |
2020-06-28 19:19:45 +00:00
| ArchiCAD | | | | | |
| BlenderBIM | 2.82a/0.200511 | :heavy_check_mark: | | :heavy_check_mark: | |
| FreeCAD | | :heavy_check_mark: | | :heavy_check_mark: | |
2020-06-28 18:39:20 +00:00
| Revit | 2020/20.1.0.1 | :x: | link was broken between objects | :x: | |
2020-06-28 19:19:45 +00:00
| Vectorworks | | | | | |
2020-08-14 15:47:14 +00:00
---
## Model_Lines_Straight
Straight lines in 3D space.
#### Native Funtionality
| Program | Native funtion/object |
| ------------ | --------------------- |
| ArchiCAD | |
| BlenderBIM | |
| FreeCAD | |
| Microstation | |
| Revit | Model Lines |
| Vectorworks | |
### Import criteria
![](Specifications_Test_Files/Model_Lines_Straight/from_Revit/Model_Lines_Straight_01.png)
### Export criteria
From Revit...
2020-06-28 19:19:45 +00:00
2020-08-14 15:47:14 +00:00
/*#160= IFCPRODUCTDEFINITIONSHAPE($,$,(#157));*/
/*#157= IFCSHAPEREPRESENTATION(#113,'Annotation','Annotation2D',(#147));*/
/*#113= IFCGEOMETRICREPRESENTATIONSUBCONTEXT($,'Annotation',*,*,*,*,#112,0.01,.PLAN_VIEW.,$);*/
/*#112= IFCGEOMETRICREPRESENTATIONCONTEXT($,'Annotation',3,0.0001,#101,#102);*/
/*#101= IFCAXIS2PLACEMENT3D(#6,$,$);*/
/*#6= IFCCARTESIANPOINT((0.,0.,0.));*/
/*#102= IFCDIRECTION((6.12303176911189E-17,1.));*/
/*#147= IFCGEOMETRICCURVESET((#145,#183,#199,#215,#231));*/
/*#145= IFCPOLYLINE((#9,#143));*/
/*#9= IFCCARTESIANPOINT((0.,0.));*/
### Results
Test files here: [Model_Lines_Straight](https://gitlab.com/OSarch/FreeMVD_WorkFlow/tree/master/Specifications_Test_Files/Model_Lines_Straight)
| Program | Version<br/>native/plugin | Imported Native File (PASS/FAIL) | Import Comments | Exported IFC File (PASS/FAIL) | Export Comments |
| ----------- | ------------------------- | -------------------------------- | --------------- | ------------------------------ | --------------- |
| ArchiCAD | | | | | |
2020-08-14 15:54:17 +00:00
| BlenderBIM | 2.83.2/200731-win | :x: | | | |
2020-08-14 15:47:14 +00:00
| FreeCAD | | | | | |
| Revit | 2020/20.1.0.1 | :heavy_check_mark: | | :heavy_check_mark: | |
| Vectorworks | | | | | |
<!--
## Category
2020-09-05 14:20:30 +00:00
Short DescriptionCategory
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-08-14 15:47:14 +00:00
2020-09-05 14:20:30 +00:00
![](Specifications_Test_Files/Mapped_Items/imgs/<to image>Mapped_Items_Code.png)
2020-08-14 15:47:14 +00:00
#### Native Funtionality
| Program | Native funtion/object |
| ------------ | --------------------- |
2020-09-05 14:20:30 +00:00
| ArchiCAD | Objects, Modules |
| BlenderBIM | Linked Objects |
| FreeCAD | Clones |
| Microstation | Cells |
| Revit | Groups, Families |
| Vectorworks | Symbols |
2020-08-14 15:47:14 +00:00
### Import criteria
- Description of what needs to be seen in the native app
### Export criteria
Something similar to this...
- IFCEXTRUDEDAREASOLID
- IFCARBITRARYPROFILEDEFWITHVOIDS
- IFCPOLYLINE
- IFCPOLYLINE
### Results
2020-06-28 18:55:52 +00:00
2020-09-05 14:20:30 +00:00
Test files here: [name of test![](Specifications_Test_Files/Mapped_Items/imgs/Mapped_Items_Visual.gif)
### Import criteria
- That the connection or link between objects in still intact. That is, if one instance is changed, the other instances will change as well.
### Export criteria
- The IFC file has the same shared mapping connected to the objects--circled in red below.
![](Specifications_Test_Files/Mapped_Items/imgs/Mapped_Items_Code_circled.png)
### Results
Test files here: [Specifications_Test_Files/Mapped_Items/](https://gitlab.com/OSarch/FreeMVD_WorkFlow/tree/master/Specifications_Test_Files/location of test fileMapped_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 | | | | | |
-->
<!--stackedit_data:
eyJoaXN0b3J5IjpbLTc5MzIxNjMwM119
2020-06-28 18:55:52 +00:00
-->