IFC 4.3.x development

5.1.3.12 IfcProjectLibrary

Change log

IFC4

added

5.1.3.12.1 Semantic definitions at the entity

An IfcProjectLibrary collects all library elements that are included within a referenced project data set.

Examples for project libraries include:

  • type libraries (also called style or family libraries): a collection of subtypes of IfcTypeObject
  • property definition libraries: a collections of IfcPropertySetTemplate or IfcPropertyTemplates

The inherited attributes RepresentationContext and UnitsInContext have the following meaning:

  • Context of the representations used within the project library. When the project library includes shape representations for its library type objects, one or several geometric representation contexts need to be included that define the coordinate system, the coordinate space dimensions, and/or the precision factor,
  • Units locally assigned to measure types used within the context of this project library.

NOTE  It is generally discouraged to use a different length measure and plane angle measure in an included project library compared with the project itself. It may lead to unexpected results for the shape representation of items included in the project library.

Instances of IfcProjectLibrary are assigned to the project context using the IfcRelDeclares relationship and accessible through the inverse attribute HasContext. Individual object types and property (set) templates are assigned to the IfcProjectLibrary using the IfcRelDeclares relationship and are accessible through the inverse attribute Declares. An IfcProjectLibrary may be decomposed into sub libraries using the relationship IfcRelNests. Sub libraries are accessed by the IfcProjectLibrary through the inverse attribute IsNestedBy.

HISTORY  New entity in IFC4.

# Attribute Type Description
IfcRoot
1 GlobalId IfcGloballyUniqueId Assignment of a globally unique identifier within the entire software world.
2 OwnerHistory OPTIONAL IfcOwnerHistory Assignment of the information about the current ownership of that object, including owning actor, application, local identification and information captured about the recent changes of the object,

> NOTE  only the last modification in stored - either as addition, deletion or modification.

> IFC4 CHANGE  The attribute has been changed to be OPTIONAL.
3 Name OPTIONAL IfcLabel Optional name for use by the participating software systems or users. For some subtypes of IfcRoot the insertion of the Name attribute may be required. This would be enforced by a where rule.
4 Description OPTIONAL IfcText Optional description, provided for exchanging informative comments.
IfcObjectDefinition
HasAssignments SET [0:?] OF IfcRelAssigns FOR RelatedObjects Reference to the relationship objects, that assign (by an association relationship) other subtypes of IfcObject to this object instance. Examples are the association to products, processes, controls, resources or groups.
Nests SET [0:1] OF IfcRelNests FOR RelatedObjects References to the decomposition relationship being a nesting. It determines that this object definition is a part within an ordered whole/part decomposition relationship. An object occurrence or type can only be part of a single decomposition (to allow hierarchical strutures only).

> IFC4 CHANGE  The inverse attribute datatype has been added and separated from Decomposes defined at IfcObjectDefinition.
IsNestedBy SET [0:?] OF IfcRelNests FOR RelatingObject References to the decomposition relationship being a nesting. It determines that this object definition is the whole within an ordered whole/part decomposition relationship. An object or object type can be nested by several other objects (occurrences or types).

> IFC4 CHANGE  The inverse attribute datatype has been added and separated from IsDecomposedBy defined at IfcObjectDefinition.
HasContext SET [0:1] OF IfcRelDeclares FOR RelatedDefinitions References to the context providing context information such as project unit or representation context. It should only be asserted for the uppermost non-spatial object.

> IFC4 CHANGE  The inverse attribute datatype has been added.
IsDecomposedBy SET [0:?] OF IfcRelAggregates FOR RelatingObject References to the decomposition relationship being an aggregation. It determines that this object definition is whole within an unordered whole/part decomposition relationship. An object definitions can be aggregated by several other objects (occurrences or parts).

> IFC4 CHANGE  The inverse attribute datatype has been changed from the supertype IfcRelDecomposes to subtype IfcRelAggregates.
Decomposes SET [0:1] OF IfcRelAggregates FOR RelatedObjects References to the decomposition relationship being an aggregation. It determines that this object definition is a part within an unordered whole/part decomposition relationship. An object definitions can only be part of a single decomposition (to allow hierarchical strutures only).

> IFC4 CHANGE  The inverse attribute datatype has been changed from the supertype IfcRelDecomposes to subtype IfcRelAggregates.
HasAssociations SET [0:?] OF IfcRelAssociates FOR RelatedObjects Reference to the relationship objects, that associates external references or other resource definitions to the object.. Examples are the association to library, documentation or classification.
IfcContext
5 ObjectType OPTIONAL IfcLabel The object type denotes a particular type that indicates the object further. The use has to be established at the level of instantiable subtypes.

> NOTE  Subtypes of IfcContext do not introduce a PredefinedType attribute, therefore the usage of ObjectType is not bound to the selection of USERDEFINED within the PredefinedType enumaration.
6 LongName OPTIONAL IfcLabel Long name for the context as used for reference purposes.
7 Phase OPTIONAL IfcLabel Current project phase, or life-cycle phase of this project. Applicable values have to be agreed upon by view definitions or implementer agreements.
8 RepresentationContextsOPTIONAL SET [1:?] OF IfcRepresentationContext Context of the representations used within the context. When the context is a project and it includes shape representations for its components, one or several geometric representation contexts need to be included that define e.g. the world coordinate system, the coordinate space dimensions, and/or the precision factor.

> IFC4 CHANGE  The attribute has been changed to be optional. Change made with upward compatibility for file based exchange.
9 UnitsInContext OPTIONAL IfcUnitAssignment Units globally assigned to measure types used within the context.

> IFC4 CHANGE  The attribute has been changed to be optional. Change made with upward compatibility for file based exchange.
IsDefinedBy SET [0:?] OF IfcRelDefinesByProperties FOR RelatedObjectsSet of relationships to property set definitions attached to this context. Those statically or dynamically defined properties contain alphanumeric information content that further defines the context.

> IFC4 CHANGE  The data type has been changed from IfcRelDefines to IfcRelDefinesByProperties with upward compatibility for file based exchange.
Declares SET [0:?] OF IfcRelDeclares FOR RelatingContext Reference to the IfcRelDeclares relationship that assigns the uppermost entities of includes hierarchies to this context instance.

> NOTE  The spatial hiearchy is assigned to IfcProject using the IfcRelAggregates relationship. This is a single exception due to compatibility reasons with earlier releases.

5.1.3.12.1 Entity inheritance

dot_inheritance IfcProjectLibrary IfcProjectLibrary IfcContext IfcContext IfcProjectLibrary->IfcContext IfcProject IfcProject IfcProject->IfcContext IfcObjectDefinition IfcObjectDefinition IfcContext->IfcObjectDefinition IfcObject IfcObject IfcObject->IfcObjectDefinition IfcRoot IfcRoot IfcObjectDefinition->IfcRoot IfcTypeObject IfcTypeObject IfcTypeObject->IfcObjectDefinition IfcPropertyDefinition IfcPropertyDefinition IfcPropertyDefinition->IfcRoot IfcRelationship IfcRelationship IfcRelationship->IfcRoot

5.1.3.12.2 Definitions applying to General Usage

5.1.3.12.2.1 Classification Association

Any object occurrence or object type can have a reference to a specific classification reference, i.e. to a particular facet within a classification system.

5.1.3.12.2.2 Identity

IfcRoot assigns the globally unique ID. In addition it may provide for a name and a description about the concept.

5.1.3.12.2.3 Revision Control

Ownership, history, and merge state is captured using IfcOwnerHistory.

5.1.3.12.3 Formal representations

ENTITY IfcProjectLibrary
 SUBTYPE OF (IfcContext);
END_ENTITY;