*IfcConnectionPointEccentricity* is used to describe the geometric constraints that facilitate the physical connection of two objects at a point or vertex point with associated point coordinates. There is a physical distance, or eccentricity, etween the connection points of both object. The eccentricity can be either given by:

- providing the
*PointOnRelatingElement*and the*PointOnRelatedElement*, where both point coordinates are not identical within a common parent coordinate system (latestly within the world coordinate system), - providing the
*PointOnRelatingElement*and the three distance measures,*EccentricityInX*,*EccentricityInY*, and*EccentricityInZ*(or only*EccentricityInX*, and*EccentricityInY*if the underlying coordinate system is two-dimensional), or - providing both.

NOTE If both,

PointOnRelatedElement, andEccentricityInX,EccentricityInY, (EccentricityInZ) are provided, the values should be consistent. In case of any non-consistency, the calculated distance betweenPointOnRelatingElementandPointOnRelatedElementtakes precedence.

The *IfcPoint* (or the *IfcVertexPoint* with an associated *IfcPoint*) at the *PointOnRelatingElement* attribute defines the point where the basic geometry items of the connected elements connects. The point coordinates are provided within the local coordinate system of the *RelatingElement*, as specified at the *IfcRelConnects* subtype that utilizes the *IfcConnectionPointGeometry*. Optionally, the same point coordinates can also be provided within the local coordinate system of the *RelatedElement* by using the *PointOnRelatedElement* attribute, otherwise the distance to the point at the RelatedElement has to be given by the three eccentricity values.

The explicit values for *EccentricityInX*, *EccentricityInY*, and *EccentricityInZ* are always measured in the following direction and coordinate system (defining when the value is positive or negative):

- from the
*PointOnRelatedElement*to*PointOnRelatingElement*within the coordinate system of the*RelatingElement*. - in addition: when used to specify connections in structural analysis models, the
*IfcStructuralMember*is to be used as the*RelatingElement*of the relationship object utilizing*IfcConnectionPointEccentricity*, and the*IfcStructuralConnection*is the*RelatedElement*.

HISTORY New entity in IFC2x3.

# | Attribute | Type | Description |
---|---|---|---|

IfcConnectionGeometry | |||

IfcConnectionPointGeometry | |||

1 | PointOnRelatingElement | IfcPointOrVertexPoint | Point at which the connected object is aligned at the relating element, given in the LCS of the relating element. |

2 | PointOnRelatedElement | OPTIONAL IfcPointOrVertexPoint | Point at which connected objects are aligned at the related element, given in the LCS of the related element. If the information is omitted, then the origin of the related element is used. |

IfcConnectionPointEccentricity | |||

3 | EccentricityInX | OPTIONAL IfcLengthMeasure | Distance in x direction between the two points (or vertex points) engaged in the point connection. |

4 | EccentricityInY | OPTIONAL IfcLengthMeasure | Distance in y direction between the two points (or vertex points) engaged in the point connection. |

5 | EccentricityInZ | OPTIONAL IfcLengthMeasure | Distance in z direction between the two points (or vertex points) engaged in the point connection. |

ENTITY IfcConnectionPointEccentricity SUBTYPE OF (IfcConnectionPointGeometry); EccentricityInX : OPTIONAL IfcLengthMeasure; EccentricityInY : OPTIONAL IfcLengthMeasure; EccentricityInZ : OPTIONAL IfcLengthMeasure; END_ENTITY;