Discrete Transfer Fcn

Implement discrete transfer function

Library

Discrete

Description

The Discrete Transfer Fcn block implements the z-transform transfer function:

H(z)=num(z)den(z)=num0zm+num1zm1+...+nummden0zn+den1zn1+...+denn

where m+1 and n+1 are the number of numerator and denominator coefficients, respectively. num and den contain the coefficients of the numerator and denominator in descending powers of z. num can be a vector or matrix, den must be a vector, and you specify both as parameters on the block dialog box. The order of the denominator must be greater than or equal to the order of the numerator.

Specify the coefficients of the numerator and denominator polynomials in descending powers of z. This block lets you use polynomials in z to represent a discrete system, a method that control engineers typically use. Conversely, the Discrete Filter block lets you use polynomials in z-1 (the delay operator) to represent a discrete system, a method that signal processing engineers typically use. The two methods are identical when the numerator and denominator polynomials have the same length.

The Discrete Transfer Fcn block applies the z-transform transfer function to each independent channel of the input. The Input processing parameter allows you to specify whether the block treats each element of the input as an individual channel (sample-based processing), or each column of the input as an individual channel (frame-based processing). To perform frame-based processing, you must have a DSP System Toolbox™ license.

Specifying Initial States

Use the Initial states parameter to specify initial filter states. To determine the number of initial states you must specify and how to specify them, see the following tables.

Frame-Based Processing

Input Number of ChannelsValid Initial States (Dialog Box)Valid Initial States (Input Port)
  • Column vector (K-by-1)

  • Unoriented vector (K)

1
  • Scalar

  • Column vector (M-by-1)

  • Row vector (1-by-M)

  • Scalar

  • Column vector (M-by-1)

  • Row vector (1-by-N)

  • Matrix (K-by-N)

N
  • Scalar

  • Column vector (M-by-1)

  • Row vector (1-by-M)

  • Matrix (M-by-N)

  • Scalar

  • Matrix (M-by-N)

Sample-Based Processing

InputNumber of ChannelsValid Initial States (Dialog Box)Valid Initial States (Input Port)
  • Scalar

1
  • Scalar

  • Column vector (M-by-1)

  • Row vector (1-by-M)

  • Scalar

  • Column vector (M-by-1)

  • Row vector (1-by-M)

  • Row vector (1-by-N)

  • Column vector (N-by-1)

  • Unoriented vector (N)

N
  • Scalar

  • Column vector (M-by-1)

  • Row vector (1-by-M)

  • Matrix (M-by-N)

  • Scalar

  • Matrix (K-by-N)

K×N
  • Scalar

  • Column vector (M-by-1)

  • Row vector (1-by-M)

  • Matrix (M-by-(K×N))

  • Scalar

When the Initial states is a scalar, the block initializes all filter states to the same scalar value. Enter 0 to initialize all states to zero. When the Initial states is a vector or a matrix, each vector or matrix element specifies a unique initial state for a corresponding delay element in a corresponding channel:

  • The vector length must equal the number of delay elements in the filter, M = max(number of zeros, number of poles).

  • The matrix must have the same number of rows as the number of delay elements in the filter, M = max(number of zeros, number of poles). The matrix must also have one column for each channel of the input signal.

The following example shows the relationship between the initial filter output and the initial input and state. Given an initial input u1, the first output y1 is related to the initial state [x1, x2] and initial input by:

y1=4x1x2=1/2(u13x1)

Data Type Support

The Discrete Transfer Function block accepts and outputs real and complex signals of any signed numeric data type that Simulink® supports. The block supports the same types for the numerator and denominator coefficients.

Numerator and denominator coefficients must have the same complexity. They can have different word lengths and fraction lengths.

States are complex when either the input or the coefficients are complex.

The following diagrams show the filter structure and the data types that the block uses for floating-point and fixed-point signals.

The block omits the dashed divide when you select the Optimize by skipping divide by leading denominator coefficient (a0) parameter.

Parameters and Dialog Box

The Main pane of the Discrete Transfer Fcn block dialog box appears as follows.

Numerator

Numerator coefficients of the discrete transfer function. To specify the coefficients, set the Source to Dialog. Then enter the coefficients in Value as descending powers of z. Use a row vector to specify the coefficients for a single numerator polynomial. Use a matrix to specify coefficients for multiple filters to be applied to the same input. Each matrix row represents a set of filter taps.

Denominator

Denominator coefficients of the discrete transfer function. To specify the coefficients, set the Source to Dialog. Then, enter the coefficients in Value as descending powers of z. Use a row vector to specify the coefficients for a single denominator polynomial. Use a matrix to specify coefficients for multiple filters to be applied to the same input. Each matrix row represents a set of filter taps.

Initial states

If the Source is Dialog, then, in Value, specify the initial states of the filter states. To learn how to specify initial states, see Specifying Initial States.

If the Source is Input port, then there is nothing to be specified for Value.

External reset

Specify the trigger event to use to reset the states to the initial conditions.

Reset ModeBehavior
NoneNo reset.
RisingReset on a rising edge.
FallingReset on a falling edge.
EitherReset on either a rising or falling edge.
LevelReset in either of these cases:
  • when there is a nonzero at the current time step

  • when the time step value changes from nonzero at the previous time step to zero at the current time step

Level holdReset when nonzero at the current time step.

The reset signal must be a scalar of type single, double, boolean, or integer. Fixed point data types, except for ufix1, are not supported.

Input processing

Specify whether the block performs sample- or frame-based processing.

  • Elements as channels (sample based) — Process each element of the input as an independent channel.

  • Columns as channels (frame based) — Process each column of the input as an independent channel.

      Note:   Frame-based processing requires a DSP System Toolbox license.

      For more information, see Sample- and Frame-Based Concepts in the DSP System Toolbox documentation.

Optimize by skipping divide by leading denominator coefficient (a0)

Select when the leading denominator coefficient, a0, equals one. This parameter optimizes your code.

When you select this check box, the block does not perform a divide-by-a0 either in simulation or in the generated code. An error occurs if a0 is not equal to one.

When you clear this check box, the block is fully tunable during simulation, and performs a divide-by-a0 in both simulation and code generation.

Sample time

Specify the time interval between samples. To inherit the sample time, set this parameter to -1. See Specify Sample Time.

The Data Types pane of the Discrete Transfer Function block dialog box appears as follows.

State

Specify the state data type. You can set it to:

  • A rule that inherits a data type, for example, Inherit: Same as input

  • A built-in integer, for example, int8

  • A data type object, for example, a Simulink.NumericType object

  • An expression that evaluates to a data type, for example, fixdt(1,16,0)

Click the Show data type assistant button to display the Data Type Assistant, which helps you set the State parameter.

See Specify Data Types Using Data Type Assistant for more information.

Numerator coefficients

Specify the numerator coefficient data type. You can set it to:

  • A rule that inherits a data type, for example, Inherit: Inherit via internal rule

  • A built-in integer, for example, int8

  • A data type object, for example, a Simulink.NumericType object

  • An expression that evaluates to a data type, for example, fixdt(1,16,0)

Click the Show data type assistant button to display the Data Type Assistant, which helps you set the Numerator coefficients parameter.

See Specify Data Types Using Data Type Assistant for more information.

Numerator coefficient minimum

Specify the minimum value that a numerator coefficient can have. The default value is [] (unspecified). Simulink software uses this value to perform:

Numerator coefficient maximum

Specify the maximum value that a numerator coefficient can have. The default value is [] (unspecified). Simulink software uses this value to perform:

Numerator product output

Specify the product output data type for the numerator coefficients. You can set it to:

  • A rule that inherits a data type, for example, Inherit: Inherit via internal rule

  • A built-in data type, for example, int8

  • A data type object, for example, a Simulink.NumericType object

  • An expression that evaluates to a data type, for example, fixdt(1,16,0)

Click the Show data type assistant button to display the Data Type Assistant, which helps you set the Numerator product output parameter.

See Specify Data Types Using Data Type Assistant for more information.

Numerator accumulator

Specify the accumulator data type for the numerator coefficients. You can set it to:

  • A rule that inherits a data type, for example, Inherit: Inherit via internal rule

  • A built-in data type, for example, int8

  • A data type object, for example, a Simulink.NumericType object

  • An expression that evaluates to a data type, for example, fixdt(1,16,0)

Click the Show data type assistant button to display the Data Type Assistant, which helps you set the Numerator accumulator parameter.

See Specify Data Types Using Data Type Assistant for more information.

Denominator coefficients

Specify the denominator coefficient data type. You can set it to:

  • A rule that inherits a data type, for example, Inherit: Inherit via internal rule

  • A built-in integer, for example, int8

  • A data type object, for example, a Simulink.NumericType object

  • An expression that evaluates to a data type, for example, fixdt(1,16,0)

Click the Show data type assistant button to display the Data Type Assistant, which helps you set the Denominator coefficients parameter.

See Specify Data Types Using Data Type Assistant for more information.

Denominator coefficient minimum

Specify the minimum value that a denominator coefficient can have. The default value is [] (unspecified). Simulink software uses this value to perform:

Denominator coefficient maximum

Specify the maximum value that a denominator coefficient can have. The default value is [] (unspecified). Simulink software uses this value to perform:

Denominator product output

Specify the product output data type for the denominator coefficients. You can set it to:

  • A rule that inherits a data type, for example, Inherit: Inherit via internal rule

  • A built-in data type, for example, int8

  • A data type object, for example, a Simulink.NumericType object

  • An expression that evaluates to a data type, for example, fixdt(1,16,0)

Click the Show data type assistant button to display the Data Type Assistant, which helps you set the Denominator product output parameter.

See Specify Data Types Using Data Type Assistant for more information.

Denominator accumulator

Specify the accumulator data type for the denominator coefficients. You can set it to:

  • A rule that inherits a data type, for example, Inherit: Inherit via internal rule

  • A built-in data type, for example, int8

  • A data type object, for example, a Simulink.NumericType object

  • An expression that evaluates to a data type, for example, fixdt(1,16,0)

Click the Show data type assistant button to display the Data Type Assistant, which helps you set the Denominator accumulator parameter.

See Specify Data Types Using Data Type Assistant for more information.

Output

Specify the output data type. You can set it to:

  • A rule that inherits a data type, for example, Inherit: Inherit via internal rule

  • A built-in data type, for example, int8

  • A data type object, for example, a Simulink.NumericType object

  • An expression that evaluates to a data type, for example, fixdt(1,16,0)

Click the Show data type assistant button to display the Data Type Assistant, which helps you set the Output parameter.

See Specify Block Output Data Types for more information.

Output minimum

Specify the minimum value that the block can output. The default value is [] (unspecified). Simulink uses this value to perform:

  • Simulation range checking (see Signal Ranges)

  • Automatic scaling of fixed-point data types

Output maximum

Specify the maximum value that the block can output. The default value is [] (unspecified). Simulink uses this value to perform:

  • Simulation range checking (see Signal Ranges)

  • Automatic scaling of fixed-point data types

Lock data type settings against changes by the fixed-point tools

Select to lock all data type settings of this block against changes by the Fixed-Point Tool and the Fixed-Point Advisor. For more information, see Lock the Output Data Type Setting in the Fixed-Point Designer™ documentation.

Integer rounding mode

Specify the rounding mode for fixed-point operations. For more information, see Rounding. in the Fixed-Point Designer documentation.

Saturate on integer overflow
ActionReasons for Taking This ActionWhat Happens for OverflowsExample

Select this check box.

Your model has possible overflow, and you want explicit saturation protection in the generated code.

Overflows saturate to either the minimum or maximum value that the data type can represent.

The maximum value that the int8 (signed, 8-bit integer) data type can represent is 127. Any block operation result greater than this maximum value causes overflow of the 8-bit integer. With the check box selected, the block output saturates at 127. Similarly, the block output saturates at a minimum output value of -128.

Do not select this check box.

You want to optimize efficiency of your generated code.

You want to avoid overspecifying how a block handles out-of-range signals. For more information, see Checking for Signal Range Errors.

Overflows wrap to the appropriate value that is representable by the data type.

The maximum value that the int8 (signed, 8-bit integer) data type can represent is 127. Any block operation result greater than this maximum value causes overflow of the 8-bit integer. With the check box cleared, the software interprets the overflow-causing value as int8, which can produce an unintended result. For example, a block result of 130 (binary 1000 0010) expressed as int8, is -126.

When you select this check box, saturation applies to every internal operation on the block, not just the output or result. Usually, the code generation process can detect when overflow is not possible. In this case, the code generator does not produce saturation code.

The State Attributes pane of the Discrete Filter block dialog box appears as follows.

State name

Use this parameter to assign a unique name to the block state. The default is ' '. When this field is blank, no name is assigned. When using this parameter, remember these considerations:

  • A valid identifier starts with an alphabetic or underscore character, followed by alphanumeric or underscore characters.

  • The state name applies only to the selected block.

This parameter enables State name must resolve to Simulink signal object when you click Apply.

For more information, see States in the Simulink Coder™ documentation.

State name must resolve to Simulink signal object

Select this check box to require that the state name resolve to a Simulink signal object. This check box is cleared by default.

State name enables this parameter.

Selecting this check box disables Code generation storage class.

Package

Select a package that defines the custom storage class you want to apply. If you have defined any packages of your own, click Refresh. This action adds all user-defined packages on your search path to the package list.

Code generation storage class

Select custom storage class for state.

Default: Auto

Auto

Auto is the appropriate storage class for states that you do not need to interface to external code.

SimulinkGlobal

model_P initializes the state to its corresponding value in the workspace.

ExportedGlobal

State is stored in a global variable

ImportedExtern

model_private.h declares the state as an extern variable.

ImportedExternPointer

model_private.h declares the state as an extern pointer.

Default

A non-editable placeholder storage class is created.

BitField

A struct declaration is created that embeds Boolean data.

Volatile

Volatile type qualifier is used in state declaration.

ExportToFile

Header (.h) file containing global variable declarations is generated with user-specified name.

ImportFromFile

Predefined header (.h) files containing global variable declarations are included.

FileScope

A static qualifier is generated in front of the state declaration to make the state visible only to the current file.

Struct

A struct declaration is created to encapsulate parameter or signal object data.

StructVolatile

Volatile type qualifier is used in struct declaration.

GetSet

Supports specialized function calls to read and write memory.

State name enables this parameter.

The list of valid storage classes differs based on the Package selection.

Setting this parameter to ExportedGlobal, ImportedExtern, or ImportedExternPointer enables Code generation storage type qualifier.

Code generation storage type qualifier

Specify a Simulink Coder storage type qualifier. The default is ' '. When this field is blank, no qualifier is assigned.

The Simulink Coder product does not check this string for errors. Thus, whatever value you enter appears automatically in the variable declaration.

Setting Code generation storage class to ExportedGlobal, ImportedExtern, or ImportedExternPointer enables this parameter.

During simulation, the block uses the following values:

  • The initial value of the signal object to which the state name resolves

  • Minimum and maximum values of the signal object

For more information, see States in the Simulink Coder documentation.

Characteristics

Direct Feedthrough

Only when the leading numerator coefficient is not equal to zero and the numerator order equals the denominator order

Sample Time

Specified in the Sample time parameter

Scalar Expansion

Yes, of initial states

States

See Specifying Initial States

Dimensionalized

Yes

Zero-Crossing Detection

No

Was this topic helpful?