Engee documentation

Algebraic Constraint

Input signal limitation.

blockType: AlgebraicConstraint

Path in the library:

/Basic/Math Operations/Algebraic Constraint

Description

The block Algebraic Constraint limits (reduces) the input signal to the value or 0 and outputs the algebraic state . The block calculates and outputs the value at which its input signal becomes equal to 0 or , depending on the selected value for the Constraint parameter. The block must be located in an unbroken algebraic loop, i.e. other blocks in it must have direct signal transmission. For example, you can specify algebraic equations for differential-algebraic systems (DAS) with index 1.

Ports

Input

# f(z) — The input signal
scalar | vector

Details

The signal that is being limited or to solve an algebraic loop.

Data types

Float64

Complex numbers support

Yes

Output

# z — output state
scalar | vector

Details

Solving an algebraic loop when the input signal is is subject to restriction or .

Data types

Float64

Complex numbers support

Yes

Parameters

Parameters

# Constraint — limitation on the input signal
f(z) = 0 | f(z) = z

Details

The type of constraint that needs to be solved. You can find a solution for f(z) = 0 or f(z) = z.

Values

f(z) = 0 | f(z) = z

Default value

f(z) = 0

Program usage name

Constraint

Tunable

No

Evaluatable

No

# Initial guess — the initial assumption about the value of the solution

Details

An initial approximation for an algebraic state , close to the expected value of the solution. This value is used to increase the efficiency of the algebraic loop solver.

Default value

0.0

Program usage name

InitialGuess

Tunable

No

Evaluatable

Yes

# Tolerance — solver tolerance
Float64 real number

Details

Specify a lower value to increase accuracy or a higher value to speed up execution.

Block Algebraic Constraint supports the confidence domain method [1], [2] for solving algebraic loops.

Default value

1e-08

Program usage name

Tolerance

Tunable

No

Evaluatable

Yes

Literature

  1. Garbow, B. S., K. E. Hillstrom, and J. J. Moré. User Guide for MINPACK-1. Argonne, IL: Argonne National Laboratory, 1980.

  2. Rabinowitz, P. H. Numerical Methods for Nonlinear Algebraic Equations. New York: Gordon and Breach, 1970.