Engee documentation

Discrete Transfer Fcn

Discrete transfer function.

blockType: DiscreteTransferFcn

Path in the library:

/Basic/Discrete/Discrete Transfer Fcn

Description

Block Discrete Transfer Fcn realises the transfer function of the -transform as follows:

,

where

  • and are the number of coefficients in the numerator and denominator, respectively;

  • and - coefficients of numerator and denominator in descending order ;

The values of and can be a vector or a matrix. The order of the denominator must be greater than or equal to the order of the numerator.

The coefficients of the numerator and denominator polynomials are specified in descending order of degree . The block allows polynomials in to be used to represent a discrete system; this approach is more common in control systems. Conversely, the block Discrete Transfer Fcn allows polynomials in (delay operator) to be used to represent a discrete system; this approach is typically used in digital signal processing (DSP). When the numerator and denominator polynomials have the same length, the two approaches are equivalent.

The block Discrete Transfer Fcn applies the transfer function -transform to each independent input channel.

The block icon displays the discrete transfer function given the parameters Numerator coefficients и *Denominator coefficients*If the size of the block icon does not accommodate the entire expression, is displayed.

Specifying initial states

Use the parameters *Initial states*parameter to specify the initial states of the block. The specified initial states are the initial conditions of the delay blocks used in a filter bigram that implements a discrete transfer function.

If the value of parameters Initial states is a scalar, the block initialises all filter states with the same scalar value. To initialise all states with zero, enter 0.

If the value is a Initial states - is a vector or matrix, each element of the vector or matrix specifies a unique initial state for the corresponding delay element in the corresponding channel:

  • The length of the vector must be equal to the number of delay elements in the filter, .

  • The matrix must have as many rows as the number of delay elements in the filter, . The matrix must also have one column for each channel of the input signal.

The following example shows the relationship between the initial output data of the filter and the initial input data and state. Given the initial input , the first output is related to the initial state ] and the initial input as follows:

,

.

Ports

Output

# OUT_1 — output signal
scalar | vector | matrix

Details

Output signal. Scalar, vector or matrix.

Data types

Float64.

Complex numbers support

No

Input

# IN_1 — input signal
scalar | vector | matrix

Details

Input signal. Scalar, vector or matrix.

Data types

Float32, Float64, Int8, Int16, Int32, Int64.

Complex numbers support

No

# Den — denominator coefficients
scalar | vector | matrix

Details

The denominator coefficients of a discrete transfer function.

The coefficients should be ordered in descending order of degree . Use a vector string to specify the coefficients of a single polynomial. Use a matrix to specify the coefficients of multiple polynomials to be applied to the same input signal. Each row of the matrix represents the set of coefficients of the corresponding polynomial. The order of the denominator must be greater than or equal to the order of the numerator.

Dependencies

To use this port, set the parameters Denominator source to Input port.

Data types

Float32, Float64, Int8, Int16, Int32, Int64, Fixed

Complex numbers support

No

# Num — numerator coefficients
scalar | vector | matrix

Details

The numerator coefficients of a discrete transfer function.

The coefficients should be ordered in descending order of degree . Use a vector string to specify the coefficients of a single polynomial. Use a matrix to specify the coefficients of multiple polynomials to be applied to the same input signal. Each row of the matrix represents the set of coefficients of the corresponding polynomial. The order of the denominator must be greater than or equal to the order of the numerator.

Dependencies

To use this parameter, set the Numerator source parameters to the value of Input port.

Data types

Float32, Float64, Int8, Int16, Int32, Int64, Fixed

Complex numbers support

No

Parameters

Parameters

# Numerator source — numerator coefficient source
Dialog | Input port

Details

Indicate the source of the numerator coefficients:

  • Dialog - the numerator coefficients are specified in the parameters Numerator coefficients;

  • Input port - numerator coefficients are sent to the Num port.

Values

Dialog | Input port

Default value

Dialog

Program usage name

NumeratorSource

Tunable

No

Evaluatable

No

# Numerator coefficients — numerator coefficients
Scalar / array of real numbers

Details

Numerator coefficients of the discrete transfer function.

Dependencies

To use this parameter, set the Numerator source parameters to Dialog.

Default value

[1]

Program usage name

Numerator

Tunable

Yes

Evaluatable

Yes

# Denominator source — source of denominator coefficients
Dialog | Input port

Details

State the source of the denominator coefficients:

  • Dialog - denominator coefficients are specified in the parameters Denominator coefficients;

  • Input port - denominator coefficients are sent to the Den port.

Values

Dialog | Input port

Default value

Dialog

Program usage name

DenominatorSource

Tunable

No

Evaluatable

No

# Denominator coefficients — denominator coefficients
Scalar / array of real numbers

Details

Denominator coefficients of the discrete transfer function.

Dependencies

To use this parameter, set the Denominator source parameters to Dialog.

Default value

[1, 0.5]

Program usage name

Denominator

Tunable

Yes

Evaluatable

Yes

# Initial states — initial values
Scalar / array of real numbers

Details

Initial values. Scalar, vector or matrix.

Default value

0

Program usage name

InitialStates

Tunable

Yes

Evaluatable

Yes

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

Details

Specify the parameter Sample time as a non-negative number. To inherit the discrete step of the system, set the value of this parameters to -1.

Default value

-1

Program usage name

SampleTime

Tunable

No

Evaluatable

Yes

Additional options

C code generation: Yes