Engee documentation

Discrete State-Space

Realises a discrete system in the state space.

discrete state space

Description

Block behaviour for non-empty matrices

Block Discrete State-Space realises the system described by the following equations:

,

where

  • - input;

  • - state;

  • - output.

The matrix coefficients should have the following characteristics as shown in the diagram:

  • A must be a matrix of size by , where is the number of states.

  • B must be a matrix of size by , where is the number of input parameters.

  • C must be a matrix of size to , where is the number of outputs.

  • D must be a matrix of size to .

discrete state space 1

The block takes one input and generates one output. The length of the input vector is the number of columns in the matrices B и D. The length of the output vector is the number of rows in the matrices C и D. To set the initial state vector, use the Initial conditions parameters.

To specify a vector or a matrix of zeros for A, B, C, D, or Initial conditions, use the zeros function.

Block behaviour for empty matrices

When the matrices A, B и C are empty (e.g., [;;;]), the block functionality becomes:

.

If the vector Initial conditions is also empty, the block uses the null initial state vector.

Ports

Input

# IN_1 — input signal
scalar | vector | matrix-column

Details

An input vector whose length is equal to the number of columns in the matrices B и D.

Data types

Float16, Float32, Float64, Int8, Int16, Int32, Int64, UInt8, UInt16, UInt32, UInt64, Bool, .

Complex numbers support

No

Output

# OUT_1 — output signal
scalar | vector

Details

Output vector whose length is equal to the number of rows in the matrices C и D.

Data types

Float64.

Complex numbers support

No

Parameters

Main

# A — matrix A

Details

matrix coefficient A of size to , where is the number of states.

Default value

1

Program usage name

A

Tunable

Yes

Evaluatable

Yes

# B — matrix B

Details

matrix coefficient B of size to , where is the number of input parameters.

Default value

1

Program usage name

B

Tunable

Yes

Evaluatable

Yes

# C — matrix C

Details

matrix coefficient C of size to , where is the number of outputs.

Default value

1

Program usage name

C

Tunable

Yes

Evaluatable

Yes

# D — matrix D
Scalar / array of real numbers

Details

Matrix coefficient D of size to , where is the number of outputs and is the number of input parameters.

Default value

1

Program usage name

D

Tunable

Yes

Evaluatable

Yes

# Initial conditions — initial state vector
Scalar / vector of real numbers

Details

Specify the initial state vector.

Default value

0

Program usage name

InitialCondition

Tunable

Yes

Evaluatable

Yes

# Sample time — interval between calculation steps
SampleTime (real number / vector of two real numbers)

Details

Specify the interval between calculation steps as a non-negative number. To inherit a calculation step, set this parameter to -1.

Default value

-1

Program usage name

SampleTime

Tunable

No

Evaluatable

Yes