IFC 4.3.2.20250905 (IFC4X3_ADD2) under development

  • Help suggest improvements
  • Get user or developer support

5.1.3.11 IfcProject

RV ⓘ
AbV ⓘ

5.1.3.11.1 Semantic definition

IfcProject establishes the context for information to be exchanged or shared, and it may represent a construction project but does not have to. The IfcProject's main purpose in an exchange structure is to provide the root instance and the context for all other information items included.

The context provided by the IfcProject includes:

  • the default units
  • the geometric representation context for exchange structures including shape representations
  • the project coordinate system
  • the coordinate space dimension
  • the precision used within the geometric representations
  • optionally the indication of the true north
  • optionally the map conversion between the project coordinate system and the geospatial coordinate reference system.
New entity in IFC1.0 The attributes RepresentationContexts and UnitsInContext are made optional and are promoted to supertype IfcContext.

Formal Propositions

  1. There shall be at most one project within the exchange context. This is enforced by the global rule IfcSingleProjectInstance.

5.1.3.11.2 Entity inheritance

5.1.3.11.3 Attributes

# Attribute Type Description
IfcRoot (4)
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,

Only the last modification is stored - either as addition, deletion or modification. 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 (7)
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 structures only).

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).

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.

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 definition can be aggregated by several other objects (occurrences or parts).

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 definition can only be part of a single decomposition (to allow hierarchical structures only).

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.

Click to show 11 hidden inherited attributes Click to hide 11 inherited attributes
IfcContext (7)
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.

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 enumeration.
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 RepresentationContexts OPTIONAL 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.

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.

The attribute has been changed to be optional. Change made with upward compatibility for file based exchange.
IsDefinedBy SET [0:?] OF IfcRelDefinesByProperties FOR RelatedObjects

Set 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.

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 included hierarchies to this context instance.

The spatial hierarchy is assigned to IfcProject using the IfcRelAggregates relationship. This is a single exception due to compatibility reasons with earlier releases.
Table 5.1.3.11.A

5.1.3.11.4 Formal propositions

Name Description
CorrectContext

If a RepresentationContexts relation is provided then there shall be no instance of IfcGeometricRepresentationSubContext directly included in the set of RepresentationContexts.

NOT(EXISTS(SELF\IfcContext.RepresentationContexts)) OR
(SIZEOF(QUERY(Temp <* SELF\IfcContext.RepresentationContexts |
 'IFC4X3_DEV_bc7847cd.IFCGEOMETRICREPRESENTATIONSUBCONTEXT' IN TYPEOF(Temp)
  )) = 0)
HasName

The Name attribute has to be provided for IfcProject. It is the short name for the project.

EXISTS(SELF\IfcRoot.Name)
NoDecomposition

The IfcProject represents the root of the any decomposition tree. It shall therefore not be used to decompose any other object definition.

SIZEOF(SELF\IfcObjectDefinition.Decomposes) = 0
Table 5.1.3.11.C

5.1.3.11.5 Property sets

  • Pset_ProjectCommon
    • ProjectType
    • ProjectInvestmentEstimate
    • FundingSource
    • ROI
    • NetEarnedValue
    • PaybackPeriod

5.1.3.11.6 Concept usage

Concept Usage Description
IfcRoot (2)
Revision Control General

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

Software Identity General

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

IfcObjectDefinition (9)
Classification Association General

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.

Aggregation General

No description available.

Approval Association General

No description available.

Constraint Association General

No description available.

Document Association General

No description available.

Library Association General

No description available.

Material Association General

No description available.

Material Single General

No description available.

Nesting General

No description available.

IfcContext (7)
Project Classification Information General

No description available.

Project Context General

No description available.

Project Document Information General

No description available.

Project Library Information General

No description available.

Project Representation Context 3D General

No description available.

Project Template Definitions General

No description available.

Project Type Definitions General

No description available.

Click to show 18 hidden inherited concepts Click to hide 18 inherited concepts
IfcProject (10)
Project Declaration General

The IfcProject is also the context for other information about the construction project such as a work plan. Non-product structures are assigned by their first level object to IfcProject using the IfcRelDeclares relationship. The IfcProject provides the context for work plans (or other non-product based) descriptions of the construction project. It is handled by the objectified relationship IfcRelDeclares.

The spatial structure and the schedule structure can be decomposed. For example the IfcBuilding can be decomposed into IfcBuildingStorey entities, and the IfcWorkPlan can be decomposed into IfcWorkSchedule entities. The products and tasks can be decomposed further. For example the IfcCurtainWall can be decomposed into IfcMember and IfcPlate, the IfcTask can be decomposed into other IfcTask entities. The products and tasks can have direct linking relationships. For example the IfcCurtainWall can be assigned to an IfcTask as an input or output for a construction schedule.

Figure 5.1.3.11.B illustrates the use of IfcProject as context for work plans or work schedules.

project relationships
Figure 5.1.3.11.B — Project spatial and work plan structure

This concept can be applied to the following resources:

Project Global Positioning General

The representation context of the project refers to a global positioning, i.e. the local engineering coordinate system of the project has a mapping to a defined projected coordinate system (a rectangular map coordinate system, as used in GIS systems)

Project Representation Context General

This concept can be applied with the following combinations:

ContextIdentifier ContextType Description
Model 3D Context for all 3D geometry.
Plan 2D Context for all 2D annotations.
Table 5.1.3.11.E
Project Representation Context 2D General

No description available.

Project Template Definitions General

If a project includes custom properties for which end users should be able to view and/or edit, then backing property templates must be defined. Such templates define applicable data types and values. Applications should not allow modification of any custom properties (other than those defined within this specification) for which no template is available.

Project Units General

No description available.

Spatial Decomposition General

The IfcProject is used to reference the root of the spatial structure of a building or other construction project (that serves as the primary project breakdown and is required to be hierarchical). The spatial structure elements are linked together, and to the IfcProject, by using the objectified relationship IfcRelAggregates.

The following constraints are applied to using the relationship IfcRelAggregates in context of IfcProject

The anomaly to use the composition structure through IfcRelAggregates for assigning the uppermost spatial container to IfcProject is due to upward compatibility reasons with earlier releases of this standard.

Figure 5.1.3.11.B illustrates project relationships with spatial structures, elements, and element type libraries.

spatial decomposition relationships
Figure 5.1.3.11.B — Project spatial structure, products and product type library

This concept can be applied to the following resources:

Project Global Positioning Geographic General

No description available.

Project Global Positioning Mapped General

No description available.

Property Sets for Contexts General

This concept can be applied to the following resources:

Table 5.1.3.11.D

5.1.3.11.7 Formal representation

ENTITY IfcProject
 SUBTYPE OF (IfcContext);
 WHERE
	CorrectContext : NOT(EXISTS(SELF\IfcContext.RepresentationContexts)) OR
(SIZEOF(QUERY(Temp <* SELF\IfcContext.RepresentationContexts |
 'IFC4X3_DEV_bc7847cd.IFCGEOMETRICREPRESENTATIONSUBCONTEXT' IN TYPEOF(Temp)
  )) = 0);
	HasName : EXISTS(SELF\IfcRoot.Name);
	NoDecomposition : SIZEOF(SELF\IfcObjectDefinition.Decomposes) = 0;
END_ENTITY;

5.1.3.11.8 References

Edit on Github


Is this page difficult to understand? Let us know!

5.1.3.11.9 Changelog

5.1.3.11.9.1 IFC4

  • where rule, CorrectContext
  • where rule, HasName
  • where rule, NoDecomposition
  • attribute, LongName
  • attribute, Phase
  • attribute, RepresentationContexts
  • attribute, UnitsInContext
  • where rule, WR31
  • where rule, WR32
  • where rule, WR33
  • supertype, Changed from "IfcObject" to "IfcContext"