Class Ifc4::IfcStructuralLoadGroup

Nested Relationships

This class is a nested type of Struct Ifc4.

Inheritance Relationships

Base Type

Derived Type

Class Documentation

class Ifc4::IfcStructuralLoadGroup : public Ifc4::IfcGroup

Definition from IAI: The entity IfcStructuralLoadGroup is used to structure the physical impacts. By using the grouping features inherited from IfcGroup, instances of IfcStructuralAction (or its subclasses) and of IfcStructuralLoadGroup can be used to define load groups, load cases and load combinations. (See also IfcLoadGroupTypeEnum.)

NOTE: Important functionality for the description of a load-bearing system is derived from the existing IFC entity IfcGroup. This class provides, via the relationship class IfcRelAssignsToGroup, the needed grouping mechanism. In this way, instances of IfcStructuralAction belonging to a specific load group can be unambiguously determined.

NOTE: The relationship class IfcRelAssignsToGroupByFactor is used to group load cases into load combinations. The factor provided in this assignment relationship is to applied together with the optional IfcStructuralLoadGroup.Coefficient. Unlike this coefficient which always affects the load group, the IfcRelAssignsToGroupByFactor.Factor is specific for a load case—load combination pair. As many instances of IfcRelAssignsToGroupByFactor are used within one load combination as there are different Factors to be applied to load cases in the load combination.

On the other hand, a load case may appear in more than one load combination and can have a different Factor in each assignment by IfcRelAssignsToGroupByFactor.

HISTORY: New entity in IFC 2x2. IFC 2x4 change: Subtype IfcStructuralLoadCase added. Informal propositions and WHERE rule added. Predefined type LOAD_COMBINATION_GROUP made obsolete and removed.

Informal propositions:

Load groups of type LOAD_GROUP shall only contain instances of IfcStructuralAction. Load groups of type LOAD_CASE shall always be instantiated from the subtype IfcStructuralLoadCase, not directly from the generic type IfcStructuralLoadGroup itself. Instances of IfcStructuralLoadCase shall only contain instances of IfcStructuralAction or/ and instances of IfcStructuralLoadGroup of type LOAD_GROUP. Load groups of type LOAD_COMBINATION shall only contain instances of IfcStructuralLoadCase.

Subclassed by Ifc4::IfcStructuralLoadCase

Public Functions

::Ifc4::IfcLoadGroupTypeEnum::Value PredefinedType() const

Selects a predefined type for the load group. It can be differentiated between load groups, load cases, load combinations, or userdefined grouping levels.

void setPredefinedType(::Ifc4::IfcLoadGroupTypeEnum::Value v)
::Ifc4::IfcActionTypeEnum::Value ActionType() const

Type of actions in the group. Normally needed if ‘PredefinedType’ specifies a LOAD_CASE.

void setActionType(::Ifc4::IfcActionTypeEnum::Value v)
::Ifc4::IfcActionSourceTypeEnum::Value ActionSource() const

Source of actions in the group. Normally needed if ‘PredefinedType’ specifies a LOAD_CASE.

void setActionSource(::Ifc4::IfcActionSourceTypeEnum::Value v)
bool hasCoefficient() const

Whether the optional attribute Coefficient is defined for this IfcStructuralLoadGroup.

double Coefficient() const

Load factor. If omitted, a factor is not yet known or not specified. A load factor of 1.0 shall be explicitly exported as Coefficient = 1.0.

void setCoefficient(double v)
bool hasPurpose() const

Whether the optional attribute Purpose is defined for this IfcStructuralLoadGroup.

std::string Purpose() const

Description of the purpose of this instance. Among else, possible values of the Purpose of load combinations are ‘SLS’, ‘ULS’, ‘ALS’ to indicate serviceability, ultimate, or accidental limit state.

void setPurpose(std::string v)
IfcTemplatedEntityList<IfcStructuralResultGroup>::ptr SourceOfResultGroup() const
IfcTemplatedEntityList<IfcStructuralAnalysisModel>::ptr LoadGroupFor() const
const IfcParse::entity &declaration() const
IfcStructuralLoadGroup(IfcEntityInstanceData *e)
IfcStructuralLoadGroup(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::IfcLoadGroupTypeEnum::Value v6_PredefinedType, ::Ifc4::IfcActionTypeEnum::Value v7_ActionType, ::Ifc4::IfcActionSourceTypeEnum::Value v8_ActionSource, boost::optional<double> v9_Coefficient, boost::optional<std::string> v10_Purpose)

Public Static Functions

const IfcParse::entity &Class()