Type:

Function

Available as of:

V1.0.3.0

Versions:

Current version

i_lrAccuracy

LREAL

Maximum permissible error for the calculated distance.

The iteration process aborts if the calculated distance of the polytopes deviates from the exact distance by less than this value. The lower this value is, the more exact is the result and the higher the number of the necessary iteration steps.

Value range: > 0.0

q_etDiag

GD.ET_Diag

General library-independent statement on the diagnostic.

A value not equal to ET_Diag.Ok corresponds to an diagnostic message.

q_etDiagExt

ET_DiagExt

POU-specific output on the diagnostic.

q_etDiag = ET_Diag.Ok -> Status message

q_etDiag <> ET_Diag.Ok -> Diagnostic message

q_lrDistance

LREAL

Calculated distance between iq_stPolytope1 and iq_stPolytope2. This deviates by maximally i_lrAccuracy from the distance.

q_diNumberOfIterations

DINT

Number of iteration steps which were required for the distance calculations.

iq_stPolytope1

ST_Polytope

Convex polytope 1

iq_stPolytope2

ST_Polytope

Convex polytope 2

OK

Ok

0

Ok

ExecutionAborted

MaxNumberOfIterationsExceeded

96

The maximum number of iteration steps has been exceeded.

InputParameterInvalid

AccuracyRange

118

Accuracy is outside the valid range.

InputParameterInvalid

NumberOfVerticesPolytope1Range

56

NumberOfVertices of polytope 1 is outside the valid range.

InputParameterInvalid

NumberOfVerticesPolytope2Range

57

NumberOfVertices of polytope 2 is outside the valid range.

UnexpectedProgramBehavior

UnknownState

2

The POU is in an undefined state.

Enumeration name:

AccuracyRange

Enumeration value:

118

Description:

Accuracy is outside the valid range.

-

At the input i_lrAccuracy, a number smaller than Gc_lrZeroTolerance has been applied.

A value greater than zero has to be specified.

Enumeration name:

MaxNumberOfIterationsExceeded

Enumeration value:

96

Description:

The maximum number of iteration steps has been exceeded.

-

i_lrAccuracy has been chosen too small. The numerical approximation method converges to such an exact result in not less than Gc_diMaxNumberOfIterations iteration steps.

A higher value must be chosen for i_lrAccuracy.

Enumeration name:

NumberOfVerticesPolytope1Range

Enumeration value:

56

Description:

NumberOfVertices of polytope 1 is outside the valid range.

-

 At the input iq_stPolytope1.diNumberOfVertices, a value smaller than 1 or greater than Gc_diMaxNumberOfVertices has been applied.

For iq_stPolytope1.diNumberOfVertices, a value between 1 and Gc_diMaxNumberOfVertices must be chosen.

Enumeration name:

NumberOfVerticesPolytope2Range

Enumeration value:

57

Description:

NumberOfVertices of polytope 2 is outside the valid range.

-

 At the input iq_stPolytope2.diNumberOfVertices, a value smaller than 1 or greater than Gc_diMaxNumberOfVertices has been applied.

For iq_stPolytope2.diNumberOfVertices, a value between 1 and Gc_diMaxNumberOfVertices must be chosen.

Enumeration name:

Ok

Enumeration value:

0

Description:

Ok

Enumeration name:

UnknownState

Enumeration value:

2

Description:

The POU is in an undefined state.

-

The internal state of the POU is indeterminable.

Please inform your Schneider Electric representative about this detected error.