Class Ifc4::IfcDoor

Nested Relationships

This class is a nested type of Struct Ifc4.

Inheritance Relationships

Base Type

Derived Type

Class Documentation

class Ifc4::IfcDoor : public Ifc4::IfcBuildingElement

Definition from ISO 6707-1:1989: Construction for closing an opening, intended primarily for access with hinged, pivoted or sliding operation. The door is a building element that is predominately used to provide controlled access for people and goods. It includes constructions with hinged, pivoted, sliding, and additionally revolving and folding operations. A door consists of a lining and one or several panels. The IfcDoor defines a particular occurrence of a door inserted in the spatial context of a project. A door can:

be inserted as a filler in an opening using the IfcRelFillsElement relationship, then the IfcDoor has an inverse attribute FillsVoids provided,

NOTE View definitions or implementer agreements may restrict the relationship to only include one window (or door) into one opening.

be part of an element assembly, in general an IfcCurtainWall, using the IfcRelAggregates relationship, then the inverse attribute Decomposes is provided. or be a “free standing” door, then the IfcDoor has no inverse attributes FillsVoids or Decomposes provided.

The IFC specification provides two entities for door occurrences:

IfcDoorStandardCase used for all occurrences of doors, that have a ‘Profile’ shape representation defined to which a set of shape parameters for lining and framing properties apply. Additionally it requires the provision of an IfcDoorType that references one IfcDoorLiningProperties and on to many IfcDoorPanelProperties.

NOTE see IfcDoorStandardCase for all specific constraints imposed by this subtype.

IfcDoor used for all other occurrences of doors, particularly for doors having only ‘Brep’, or ‘SurfaceModel’ geometry without applying shape parameters.

The actual parameter of the door and/or its shape are defined by the IfcDoor as the occurrence definition (or project instance), or by the IfcDoorType as the specific definition (or project type). The following parameters are given:

at the IfcDoor or IfcDoorStandardCase for occurrence specific parameters. The IfcDoor specifies:

the door width and height the door opening direction (by the y-axis of the ObjectPlacement)

at the IfcDoorType, to which the IfcDoor is related by the inverse relationship IsDefinedBy pointing to IfcRelDefinesByType, for type parameters common to all occurrences of the same type.

the operation type (single swing, double swing, revolving, etc.) the door hinge side (by using two different styles for right and left opening doors) the construction material type the particular attributes for the lining by the IfcDoorLiningProperties the particular attributes for the panels by the IfcDoorPanelProperties

HISTORY New entity in IFC Release 1.0. IFC2x4 CHANGE The attributes PredefinedType and OperationType are added, the applicable type object has been changed to IfcDoorType.

Material Use Definition The material of the IfcDoor is defined by the IfcMaterialConstituentSet or as fall back by IfcMaterial and attached by the IfcRelAssociatesMaterial.RelatingMaterial. It is accessible by the inverse HasAssociations relationship. The following keywords for IfcMaterialConstituentSet.MaterialConstituents[n].Name shall be used:

‘Lining’ - to indicate that the material constituent applies to to the door lining ‘Framing’ - to indicate that the material constituent applies to to the door panel(s), if not provided, the ‘Lining’ material information applied to panel(s) as well ‘Glazing’ - to indicate that the material constituent applies to to the glazing part

If the fall back single IfcMaterial is referenced, it applies to the lining and framing of the door. Property Set Use Definition: The property sets relating to the IfcDoor are defined by the IfcPropertySet and attached by the IfcRelDefinesByProperties relationship. It is accessible by the inverse IsDefinedBy relationship. The following property set definitions specific to the IfcDoor are part of this IFC release:

Pset_DoorCommon: common property set for all door occurrences Pset_DoorWindowGlazingType: specific property set for the glazing properties of the door glazing, if available Pset_DoorWindowShadingType: specific property set for the shading properties of the door glazing, if available

Quantity Use Definition The quantities relating to the IfcDoor are defined by the IfcElementQuantity and attached by the IfcRelDefinesByProperties relationship. It is accessible by the inverse IsDefinedBy relationship. The following base quantities are defined and should be exchanged with the IfcElementQuantity.Name = ‘BaseQuantities’. Other quantities can be defined being subjected to local standard of measurement with another string value assigned to MethodOfMeasurement. Quanties shall be never assigned to the IfcDoorType.

Qto_DoorBaseQuantities: base quantities for all door occurrences.

Containment Use Definition The IfcDoor, as any subtype of IfcBuildingElement, may participate in two different containment relationships as shown in Figure 96. The first (and in most implementation scenarios mandatory) relationship is the hierachical spatial containment, the second (optional) relationship is the aggregation within anelement assembly.

The IfcDoor is places within the project spatial hierarchy using the objectified relationship IfcRelContainedInSpatialStructure, refering to it by its inverse attribute SELF\IfcElement.ContainedInStructure. Subtypes ofIfcSpatialStructureElement are valid spatial containers, with IfcBuildingStorey being the default container. The IfcDoor may be aggregated into an element assembly using the objectified relationship IfcRelAggregates, refering to it by its inverse attribute SELF\IfcObjectDefinition.Decomposes. Doors may be part of an IfcCurtainWall as a special focus subtype. In this case it should not be additionally contained in the project spatial hierarchy, i.e.SELF\IfcElement.ContainedInStructure should be NIL.

NOTE The containment shall be defined independently of the filling relationship, that is, even if the IfcDoor is a filling of an opening established by IfcRelFillsElement, it is also contained in the spatial structure by an IfcRelContainedInSpatialStructure.

Figure 96 — Door containment

Geometry Use Definitions: The geometric representation of IfcDoor is given by the IfcProductDefinitionShape, allowing multiple geometric representations. The IfcDoor, in case of an occurrance object, gets its parameter and shape from the IfcDoorType. If an IfcRepresentationMap (a block definition) is defined for the IfcDoorType, then the IfcDoor inserts it through the IfcMappedItem. Local Placement The local placement for IfcDoor is defined in its supertype IfcProduct. It is defined by the IfcLocalPlacement, which defines the local coordinate system that is referenced by all geometric representations.

The PlacementRelTo relationship of IfcLocalPlacement shall point to the local placement of the same element (if given), in which the IfcDoor is used as a filling (normally an IfcOpeningElement), as provided by the IfcRelFillsElement relationship. If the IfcDoor is not inserted into an IfcOpeningElement, then the PlacementRelTo relationship of IfcLocalPlacement shall point (if given) to the local placement of the same IfcSpatialStructureElement that is used in the ContainedInStructure inverse attribute or to a referenced spatial structure element at a higher level. If the relative placement is not used, the absolute placement is defined within the world coordinate system.

Geometric Representation Thegeometric representation of IfcDoor is defined using the following (potentiallymultiple) IfcShapeRepresentation’s for its IfcProductDefinitionShape:

Profile: A’Curve3D’ consisting of a single losed curve defining the outer boundary of the door (lining). The door parametric representation uses this profile in order to apply the door lining and panel parameter. If not provided, the profile of the IfcOpeningElement is taken. FootPrint: A ‘GeometricCurveSet’, or ‘Annotation2D’ representation defining the 2D shape of the door Body: A ‘SweptSolid’, ‘SurfaceModel’, or ‘Brep’ representation defining the 3D shape of the door.

In addition the parametric representation of a (limited) door shape is available by applying the parameters from IfcDoorType referencing IfcDoorLiningProperties and IfcDoorPanelProperties. The purpose of the parameter is described at those entities and below (door opening operation by door type). Profile -‘Curve3D’ representation The door profile is represented by a three-dimensional closed curve within a particular shape representation. The profile is used to apply the parameter of the parametric door representation.The following attribute values for the IfcShapeRepresentation holding this geometric representation shall be used:

RepresentationIdentifier : ‘Profile’ RepresentationType : ‘Curve3D’, only a single closed curve shall be contained in the set of IfcShapeRepresentation.Items.

A ‘Profile’ representation has to be provided if:

a parametric representation shall be applied to the door AND

thedoor is ‘free standing’, or the opening into which thedoor is inserted is not extruded horizontally (i.e. where the opening profile does not match thedoor profile)

FootPrint -‘GeometricCurveSet’ or ‘Annotation2D’ representation The door foot print is represented by a set of two-dimensionalcurves (or in case of ‘Annotation2D’ additional hatching and text) within a particular shape representation. The foot print is used for the planview representation of the door.The following attribute values for the IfcShapeRepresentation holding this geometric representation shall be used:

RepresentationIdentifier : ‘FootPrint’ RepresentationType : ‘GeometricCurveSet’, or ‘Annotation2D’

Body - ‘SweptSolid’, ‘SurfaceModel’, or ‘Brep’ representation The door body is either represented parameterically (see parametric representation) or by explicit 3D shape. The 3D shape is given by using extrusion geometry, or surface models, or Brep models within a particular shape representation. The body is used for the model view representation of the door.The following attribute values for the IfcShapeRepresentation holding this geometric representation shall be used:

RepresentationIdentifier : ‘Body’ RepresentationType : ‘SweptSolid’, ‘SurfaceModel’, or ‘Brep’

MappedRepresentation The ‘FootPrint’ and ‘Body’ geometric representation of IfcDoor can be shared among several identical doors using the ‘MappedRepresentation’. The following attribute values for the IfcShapeRepresentation holding this geometric representation shall be used:

RepresentationIdentifier : ‘FootPrint’, ‘Body’ RepresentationType : ‘MappedRepresentation’

The same constraints, as given for the ‘FootPrint’, ‘Body’ representation identifiers, shall apply to the MappedRepresentation of the IfcRepresentationMap. Parameteric Representation using parameters at IfcDoorType The parameters that defines the shape of the IfcDoor, are given at the IfcDoorType and the property sets, which are included in the IfcDoorType. The IfcDoor only defines the local placement which determines the opening direction of the door. The overall size of the IfcDoor to be used to apply the lining or panel parameter provided by the IfcDoorType is determined by the IfcShapeRepresentation with the RepresentationIdentifier = ‘Profile’. Only in case of an IfcDoor inserted into an IfcOpeningElement using the IfcRelFillsElement relatioship, having a horizontal extrusion (along the y-axis of the IfcDoor), the overall size is determined by the extrusion profile of the IfcOpeningElement. NOTE The OverallWidth and OverallHeight parameters are for informational purpose only. The opening direction is determined by the local placement of IfcDoor and the OperationType of the door style as shown in Figure 97. NOTE There are different definitions in various countries on what a left opening or left hung or left swing door is (same for right). Therefore the IFC definition may derivate from the local standard and need to be mapped appropriately.

Opening directions

Definitions Reference to other standards

The door panel (for swinging doors) opens always into the direction of the positive Y axis of the local placement. The determination of whether the door opens to the left or to the right is done at the level of the IfcDoorType. Here it is a left side opening door given byIfcDoorType.OperationType = SingleSwingLeft refered to as LEFT HAND (LH) in US *

refered to as DIN-R (right hung) in Germany

If the door should open to the other side, then the local placement has to be changed. It is still a left side opening door, given by IfcDoorType.OperationType = SingleSwingLeft refered to as RIGHT HAND REVERSE (RHR) in US *

refered to as DIN-R (right hung) in Germany

If the door panel (for swinging doors) opens to the right, a separate door style needs to be used (here IfcDoorTypee.OperationType = SingleSwingRight) and it always opens into the direction of the positive Y axis of the local placement. refered to as RIGHT HAND (RH) in US *

refered to as DIN-L (left hung) in Germany

If the door panel (for swinging doors) opens to the right, and into the opposite directions, the local placement of the door need to change. The door style is given by IfcDoorType.OperationType = SingleSwingRight. refered to as LEFT HAND REVERSE (LHR) in US *

refered to as DIN-L (left hung) in Germany

  • it assumes that the ‘inside/private/primary’ space is above (top in the pictures) and the ‘outside/public/secondary’ space is below (bottom in the pictures).

Figure 97 — Door swing

Subclassed by Ifc4::IfcDoorStandardCase

Public Types

typedef IfcTemplatedEntityList<IfcDoor> list

Public Functions

bool hasOverallHeight() const

Whether the optional attribute OverallHeight is defined for this IfcDoor.

double OverallHeight() const

Overall measure of the height, it reflects the Z Dimension of a bounding box, enclosing the body of the door opening. If omitted, the OverallHeight should be taken from the geometric representation of the IfcOpening in which the door is inserted.

NOTE The body of the door might be taller then the door opening (e.g. in cases where the door lining includes a casing). In these cases the OverallHeight shall still be given as the door opening height, and not as the total height of the door lining.

void setOverallHeight(double v)
bool hasOverallWidth() const

Whether the optional attribute OverallWidth is defined for this IfcDoor.

double OverallWidth() const

Overall measure of the width, it reflects the X Dimension of a bounding box, enclosing the body of the door opening. If omitted, the OverallWidth should be taken from the geometric representation of the IfcOpening in which the door is inserted.

NOTE The body of the door might be wider then the door opening (e.g. in cases where the door lining includes a casing). In these cases the OverallWidth shall still be given as the door opening width, and not as the total width of the door lining.

void setOverallWidth(double v)
bool hasPredefinedType() const

Whether the optional attribute PredefinedType is defined for this IfcDoor.

::Ifc4::IfcDoorTypeEnum::Value PredefinedType() const

Predefined generic type for a door that is specified in an enumeration. There may be a property set given specificly for the predefined types. NOTE The PredefinedType shall only be used, if no type object IfcDoorType is assigned, providing its own IfcDoorType.PredefinedType.

IFC2x4 CHANGE The attribute has been added at the end of the entity definition.

void setPredefinedType(::Ifc4::IfcDoorTypeEnum::Value v)
bool hasOperationType() const

Whether the optional attribute OperationType is defined for this IfcDoor.

::Ifc4::IfcDoorTypeOperationEnum::Value OperationType() const

Type defining the general layout and operation of the door type in terms of the partitioning of panels and panel operations.

NOTE The OperationType shall only be used, if no type object IfcDoorType is assigned, providing its own IfcDoorType.OperationType.

IFC2x4 CHANGE The attribute has been added at the end of the entity definition.

void setOperationType(::Ifc4::IfcDoorTypeOperationEnum::Value v)
bool hasUserDefinedOperationType() const

Whether the optional attribute UserDefinedOperationType is defined for this IfcDoor.

std::string UserDefinedOperationType() const
void setUserDefinedOperationType(std::string v)
const IfcParse::entity &declaration() const
IfcDoor(IfcEntityInstanceData *e)
IfcDoor(std::string v1_GlobalId, ::Ifc4::IfcOwnerHistory *v2_OwnerHistory, boost::optional<std::string> v3_Name, boost::optional<std::string> v4_Description, boost::optional<std::string> v5_ObjectType, ::Ifc4::IfcObjectPlacement *v6_ObjectPlacement, ::Ifc4::IfcProductRepresentation *v7_Representation, boost::optional<std::string> v8_Tag, boost::optional<double> v9_OverallHeight, boost::optional<double> v10_OverallWidth, boost::optional<::Ifc4::IfcDoorTypeEnum::Value> v11_PredefinedType, boost::optional<::Ifc4::IfcDoorTypeOperationEnum::Value> v12_OperationType, boost::optional<std::string> v13_UserDefinedOperationType)

Public Static Functions

const IfcParse::entity &Class()