Compute the Length of a Distant Link (EWR_ComputeLengthOfDistantLink)

An opening ID is an entry point used to customize business logic. The Compute the length of a distant link opening ID is available in the resource set Electrical physical system design resources and is used to compute the length of a distant link which connects a device with a branch.

Important:
  • The Extra Length attribute is not taken into account during the computation.
  • The opening ID is also available is you work with cables and cable routes.
Note: For more information about customization by business rules, see Installation and Setup: Customize: Behavior: Data Setup: Customization by Business Rules.

This page discusses:

General Information

This opening ID is invoked when you compute the length of a conductor.

The computation can be based on:

  • The device instance attributes, like Sub_Type
  • The device position
  • The cavity position

The table below provides you with information related to the definition of the Opening ID.

PLM Opening ID: EWR_ComputeLengthOfDistantLink
Customization intent: Computation
Execution context:Client

Input Objects

Input objects must be of the following types:

  • ThisObject: VPMInstance (Device Instance connected with distant link)
  • Parameters corresponds to the context object.

Context Object Parameters

Parameter NameTypeRead/WriteComments
DevicePositionXPLM Entity ReadLength

X coordinate of:

  • Cavity position if the conductor is routed to a cavity
  • Device position if the conductor is routed to a device

DevicePositionYPLM Entity ReadLength

Y coordinate of:

  • Cavity position if the conductor is routed to a cavity
  • Device position if the conductor is routed to a device

DevicePositionZPLM Entity ReadLength

Z coordinate of:

  • Cavity position if the conductor is routed to a cavity
  • Device position if the conductor is routed to a device

DistantLinkPositionXPLM Entity ReadLength

X coordinate of the connection position

DistantLinkPositionYPLM Entity ReadLength

Y coordinate of the connection position

DistantLinkPositionZPLM Entity ReadLength

Z coordinate of the connection position

DistantLinkLengthOutputWriteLength

Length of distant link to be used for conductor length computation

Sample

The following sample explains how to use an opening ID to compute the length of a distant link.

Let DDLPosX(Real)
Let DDLPosY(Real)
Let DDLPosZ(Real)
Let DistantLinkLen(Real)

Let DiffX(Real)
Let DiffY(Real)
Let DiffZ(Real)

Let DorCX(Real)
Let DorCY(Real)
Let DorCZ(Real)

/*Get the Distant link position on the Branch*/
Set DDLPosX = Parameters.GetAttributeReal("DistantLinkPositionX")
Set DDLPosY = Parameters.GetAttributeReal("DistantLinkPositionY")
Set DDLPosZ = Parameters.GetAttributeReal("DistantLinkPositionZ")

/*Get the position related to the Device*/
/*If Conductor is defined till device, this position is the Device Origin*/
/*If Conductor is defined till a cavity of the device, then this position is the position of the Cavity*/

Set DorCX = Parameters.GetAttributeReal("DevicePositionX")
Set DorCY = Parameters.GetAttributeReal("DevicePositionY")
Set DorCZ = Parameters.GetAttributeReal("DevicePositionZ")

/*Compute the linear distance between two points*/
Set DiffX  = DDLPosX -DorCX
Set DiffY  = DDLPosY -DorCY
Set DiffZ  = DDLPosZ -DorCZ

Set DiffX = DiffX*DiffX
Set DiffY = DiffY*DiffY
Set DiffZ = DiffZ*DiffZ

Set DistantLinkLen = DiffX + DiffY + DiffZ
Set DistantLinkLen = sqrt(DistantLinkLen)
Set DistantLinkLen = DistantLinkLen/1000

/*Return the computed length*/
Parameters.SetAttributeReal("DistantLinkLength",DistantLinkLen)