buildingSMART / buildingSMART/IFC4.x-development

Deprecated entities discrepancies

Open
#963 1 comment 0 reactions 0 assignees View on GitHub
before-NWI legacy
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

Open the contributing 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.