buildingSMART / buildingSMART/IFC4.x-development
Deprecated entities discrepancies
- Dominant language
- Python
- Stars
- 234
- Forks
- 123
- Avg merge
- 15h 4m
- Merged PRs (30d)
- 5
Description
Was investigating which entities were deprecated in IFC4X3 and there are some inconsistencies.
Used sources:
Introduction - https://standards.buildingsmart.org/IFC/RELEASE/IFC4_3/HTML/content/introduction.htm
deprecated_entities based on ifc.xml:
```
["IfcPostalAddress", "IfcTelecomAddress", "IfcDoorLiningProperties", "IfcDoorPanelProperties", "IfcPermeableCoveringProperties", "IfcWindowLiningProperties", "IfcWindowPanelProperties", "IfcElectricDistributionBoard", "IfcElectricDistributionBoardType", "IfcMaterialClassificationRelationship", "IfcMaterialList", "IfcCivilElement", "IfcCivilElementType", "IfcRelConnectsPortToElement", "IfcRelServicesBuildings", "IfcTrapeziumProfileDef", "IfcBuildingSystem", "IfcRelCoversBldgElements", "IfcRelCoversSpaces", "IfcWallStandardCase"]
```
Entities pages - e.g. https://ifc43-docs.standards.buildingsmart.org/IFC/RELEASE/IFC4x3/HTML/lexical/IfcFaceBasedSurfaceModel.htm
----
### Discrepancies:
1. IfcFaceBasedSurfaceModel
- Deprecated in Introduction
- Not deprecated in ifc.xml
- Not deprecated on entity page https://ifc43-docs.standards.buildingsmart.org/IFC/RELEASE/IFC4x3/HTML/lexical/IfcFaceBasedSurfaceModel.htm
2. Predefined property sets - IfcDoorLiningProperties, IfcDoorPanelProperties, IfcPermeableCoveringProperties, IfcWindowLiningProperties, IfcWindowPanelProperties
- Not deprecated in Introduction
- Deprecated in ifc.xml
- Deprecated on entity pages https://ifc43-docs.standards.buildingsmart.org/IFC/RELEASE/IFC4x3/HTML/lexical/IfcDoorLiningProperties.htm
Had an idea that may be it was deprecated in IFC4, therefore it's not present in introduction but it seems it wasn't - https://standards.buildingsmart.org/IFC/RELEASE/IFC4/ADD2_TC1/HTML/link/ifcdoorliningproperties.htm
3. Some of IfcSpaceTypeEnum values.
- Not deprecated in Introduction
- Deprecated on enum page https://ifc43-docs.standards.buildingsmart.org/IFC/RELEASE/IFC4x3/HTML/lexical/IfcSpaceTypeEnum.htm
4. Some of IfcBuildingElementProxyTypeEnum values:
- Not deprecated in Introduction
- Deprecated on enum page https://ifc43-docs.standards.buildingsmart.org/IFC/RELEASE/IFC4x3/HTML/lexical/IfcBuildingElementProxyTypeEnum.htm
5. IfcShapeRepresentation.RepresentationType PointCloud value
- Not deprecated in Introduction
- Deprecated on entity page https://ifc43-docs.standards.buildingsmart.org/IFC/RELEASE/IFC4x3/HTML/lexical/IfcShapeRepresentation.htm
6. Some deprecations are using `IFC4.3.2.0 DEPRECATION` and some are using `IFC4.3.0.0 DEPRECATION`, shouldn't it use `IFC4.3.2.0 DEPRECATION`, the release version, for consistency?
Contributor guide
Research direction
Start by comparing the deprecated_entities list from ifc.xml with the IFC4X3 Introduction and the linked entity and enumeration pages. Check the listed entities, enum values, PointCloud, and deprecation version labels against the cited IFC4 and IFC4X3 sources. Done means the discrepancies are explained or corrected consistently across the relevant source and generated documentation.
Written by the indexing model from the issue text.
Assessment
- Domain
- documentation
- Issue type
- Bug
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 35/100