Categories &

Functions List

Class Definition: frd

Function File: sys = frd (sys)
Function File: sys = frd (sys, w)
Function File: sys = frd (H, w, …)
Function File: sys = frd (H, w, tsam, …)

Create or convert to frequency response data.

Inputs

sys

LTI model to be converted to frequency response data. If second argument w is omitted, the interesting frequency range is calculated by the zeros and poles of sys.

H

Frequency response array (p-by-m-by-lw). H(i,j,k) contains the response from input j to output i at frequency k. In the SISO case, a vector (lw-by-1) or (1-by-lw) is accepted as well.

w

Frequency vector (lw-by-1) in radian per second [rad/s]. Frequencies must be in ascending order.

tsam

Sampling time in seconds. If tsam is not specified, a continuous-time model is assumed.

Optional pairs of properties and values. Type set (frd) for more information.

Outputs

sys

Frequency response data object.

Option Keys and Values

’H’

Frequency response array. See ’Inputs’ for details.

’w’

Frequency vector. See ’Inputs’ for details.

’tsam’

Sampling time. See ’Inputs’ for details.

’inname’

The name of the input channels in sys. Cell vector of length m containing strings. Default names are {'u1', 'u2', ...}

’outname’

The name of the output channels in sys. Cell vector of length p containing strings. Default names are {'y1', 'y2', ...}

’ingroup’

Struct with input group names as field names and vectors of input indices as field values. Default is an empty struct.

’outgroup’

Struct with output group names as field names and vectors of output indices as field values. Default is an empty struct.

’name’

String containing the name of the model.

’notes’

String or cell of string containing comments.

’userdata’

Any data type.

See also: dss, ss, tf

Source Code: frd

Method: frd

Function File: sys = frd (sys)
Function File: sys = frd (sys, w)
Function File: sys = frd (H, w, …)
Function File: sys = frd (H, w, tsam, …)

Create or convert to frequency response data.

Inputs

sys

LTI model to be converted to frequency response data. If second argument w is omitted, the interesting frequency range is calculated by the zeros and poles of sys.

H

Frequency response array (p-by-m-by-lw). H(i,j,k) contains the response from input j to output i at frequency k. In the SISO case, a vector (lw-by-1) or (1-by-lw) is accepted as well.

w

Frequency vector (lw-by-1) in radian per second [rad/s]. Frequencies must be in ascending order.

tsam

Sampling time in seconds. If tsam is not specified, a continuous-time model is assumed.

Optional pairs of properties and values. Type set (frd) for more information.

Outputs

sys

Frequency response data object.

Option Keys and Values

’H’

Frequency response array. See ’Inputs’ for details.

’w’

Frequency vector. See ’Inputs’ for details.

’tsam’

Sampling time. See ’Inputs’ for details.

’inname’

The name of the input channels in sys. Cell vector of length m containing strings. Default names are {'u1', 'u2', ...}

’outname’

The name of the output channels in sys. Cell vector of length p containing strings. Default names are {'y1', 'y2', ...}

’ingroup’

Struct with input group names as field names and vectors of input indices as field values. Default is an empty struct.

’outgroup’

Struct with output group names as field names and vectors of output indices as field values. Default is an empty struct.

’name’

String containing the name of the model.

’notes’

String or cell of string containing comments.

’userdata’

Any data type.

See also: dss, ss, tf