SI Estimate Transfer Function Model from FRF VI

System Identification VIs

previous page next page
SI Estimate Transfer Function Model from FRF VI

Owning Palette: Frequency-Domain Model Estimation VIs

Installed With: System Identification Toolkit

Estimates the parameters of a continuous or discrete transfer function (TF) model for an unknown system by using a frequency response function (FRF). You must manually select the polymorphic instance to use.

You can obtain the FRF of a plant by using the SI Estimate FRF VI. You can wire the FRF magnitude and FRF phase outputs of the SI Estimate FRF VI to the FRF magnitude and FRF phase inputs of the SI Estimate Transfer Function Model from FRF VI.

Details  Example

Use the pull-down menu to select an instance of this VI.

 Place on the block diagram  Find on the Functions palette

SI Estimate Continuous Transfer Function Model from FRF (SISO Arbitrary)

FRF weight specifies the frequency-domain weight of the estimation error. The estimation error is the difference between the original FRF and the FRF that the system model out generates. As you increase the FRF weight at a certain frequency, the estimation error at that frequency decreases.
FRF format specifies the format of the FRF magnitude and the FRF phase.
Note  If you use the SI Estimate FRF VI to estimate the FRF, specify the same FRF format settings for this parameter as you do for the SI Estimate FRF VI.
dB on? specifies whether magnitude is in decibels or in a linear scale. The default is FALSE, which specifies that this VI expresses magnitude in a linear scale.
unwrap phase? specifies whether the phase is unwrapped. The default is FALSE, which specifies that the phase is wrapped.
convert to degree? specifies whether the unit of phase is in radians or degrees. The default is FALSE, which means the phase is in radians.
FRF magnitude specifies the magnitude of the averaged frequency response and frequency scale.
frequency specifies the frequencies, in hertz, at which this VI evaluates the averaged frequency response.
magnitude specifies the magnitude of the averaged frequency response. Use dB on? to specify the unit of magnitude.
FRF phase specifies the phase of the averaged frequency response and frequency scale.
frequency specifies the frequencies, in hertz, at which this VI evaluates the averaged frequency response.
phase specifies the phase of the averaged frequency response. Use unwrap phase? to specify whether the phase is unwrapped. Use convert to degrees? to specify the unit of phase.
orders of transfer function model specifies the numerator and denominator orders of the transfer function model.
num order specifies the numerator order of the system model. The default value is 1.
den order specifies the denominator order of the system model. The default value is 2. The value of den order must be greater than the value of num order.
error in describes error conditions that occur before this VI or function runs. The default is no error. If an error occurred before this VI or function runs, the VI or function passes the error in value to error out. This VI or function runs normally only if no error occurred before this VI or function runs. If an error occurs while this VI or function runs, it runs normally and sets its own error status in error out. Use the Simple Error Handler or General Error Handler VIs to display the description of the error code. Use error in and error out to check errors and to specify execution order by wiring error out from one node to error in of the next node.
status is TRUE (X) if an error occurred before this VI or function ran or FALSE (checkmark) to indicate a warning or that no error occurred before this VI or function ran. The default is FALSE.
code is the error or warning code. The default is 0. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code.
source specifies the origin of the error or warning and is, in most cases, the name of the VI or function that produced the error or warning. The default is an empty string.
system model out returns information about the model structure, nominal or estimated parameters, identification result, and so on. Use the Model Management VIs to retrieve the information system model out contains.
Note  You can use a customized system model probe to view model information that flows through system model wires when you debug a block diagram created with the System Identification VIs. Right-click a system model wire and select Custom Probe»SI System Model from the shortcut menu to use the system model probe.
coefficients of transfer function model returns the coefficients of the transfer function model.
numerator returns the numerator coefficients of the transfer function model, in ascending order. The coefficients take the following form: b0 + b1s + … + bmsm.
denominator returns the denominator coefficients of the transfer function model, in ascending order. The coefficients take the following form: a0 + a1s + … + ansn.
error out contains error information. If error in indicates that an error occurred before this VI or function ran, error out contains the same error information. Otherwise, it describes the error status that this VI or function produces. Right-click the error out front panel indicator and select Explain Error from the shortcut menu for more information about the error.
status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.
code is the error or warning code. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code.
source describes the origin of the error or warning and is, in most cases, the name of the VI or function that produced the error or warning.

SI Estimate Continuous Transfer Function Model from FRF (SISO Uniform)

FRF weight specifies the frequency-domain weight of the estimation error. The estimation error is the difference between the original FRF and the FRF that the system model out generates. As you increase the FRF weight at a certain frequency, the estimation error at that frequency decreases.
FRF format specifies the format of the FRF magnitude and the FRF phase.
Note  If you use the SI Estimate FRF VI to estimate the FRF, specify the same FRF format settings for this parameter as you do for the SI Estimate FRF VI.
dB on? specifies whether magnitude is in decibels or in a linear scale. The default is FALSE, which specifies that this VI expresses magnitude in a linear scale.
unwrap phase? specifies whether the phase is unwrapped. The default is FALSE, which specifies that the phase is wrapped.
convert to degree? specifies whether the unit of phase is in radians or degrees. The default is FALSE, which means the phase is in radians.
FRF magnitude specifies the magnitude of the averaged frequency response and frequency scale.
f0 specifies the starting frequency of the spectrum, in hertz.
df specifies the frequency increment of the spectrum, in hertz.
magnitude specifies the magnitude of the averaged frequency response. Use dB on? to specify the unit of magnitude.
FRF phase specifies the phase of the averaged frequency response and frequency scale.
f0 specifies the starting frequency of the spectrum, in hertz.
df specifies the frequency increment of the spectrum, in hertz.
phase specifies the phase of the averaged frequency response. Use unwrap phase? to specify whether the phase is unwrapped. Use convert to degrees? to specify the unit of phase.
orders of transfer function model specifies the numerator and denominator orders of the transfer function model.
num order specifies the numerator order of the system model. The default value is 1.
den order specifies the denominator order of the system model. The default value is 2. The value of den order must be greater than the value of num order.
error in describes error conditions that occur before this VI or function runs. The default is no error. If an error occurred before this VI or function runs, the VI or function passes the error in value to error out. This VI or function runs normally only if no error occurred before this VI or function runs. If an error occurs while this VI or function runs, it runs normally and sets its own error status in error out. Use the Simple Error Handler or General Error Handler VIs to display the description of the error code. Use error in and error out to check errors and to specify execution order by wiring error out from one node to error in of the next node.
status is TRUE (X) if an error occurred before this VI or function ran or FALSE (checkmark) to indicate a warning or that no error occurred before this VI or function ran. The default is FALSE.
code is the error or warning code. The default is 0. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code.
source specifies the origin of the error or warning and is, in most cases, the name of the VI or function that produced the error or warning. The default is an empty string.
system model out returns information about the model structure, nominal or estimated parameters, identification result, and so on. Use the Model Management VIs to retrieve the information system model out contains.
Note  You can use a customized system model probe to view model information that flows through system model wires when you debug a block diagram created with the System Identification VIs. Right-click a system model wire and select Custom Probe»SI System Model from the shortcut menu to use the system model probe.
coefficients of transfer function model returns the coefficients of the transfer function model.
numerator returns the numerator coefficients of the transfer function model, in ascending order. The coefficients take the following form: b0 + b1s + … + bmsm.
denominator returns the denominator coefficients of the transfer function model, in ascending order. The coefficients take the following form: a0 + a1s + … + ansn.
error out contains error information. If error in indicates that an error occurred before this VI or function ran, error out contains the same error information. Otherwise, it describes the error status that this VI or function produces. Right-click the error out front panel indicator and select Explain Error from the shortcut menu for more information about the error.
status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.
code is the error or warning code. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code.
source describes the origin of the error or warning and is, in most cases, the name of the VI or function that produced the error or warning.

SI Estimate Discrete Transfer Function Model from FRF (SISO Arbitrary)

FRF weight specifies the frequency-domain weight of the estimation error. The estimation error is the difference between the original FRF and the FRF that the system model out generates. As you increase the FRF weight at a certain frequency, the estimation error at that frequency decreases.
FRF format specifies the format of the FRF magnitude and the FRF phase.
Note  If you use the SI Estimate FRF VI to estimate the FRF, specify the same FRF format settings for this parameter as you do for the SI Estimate FRF VI.
dB on? specifies whether magnitude is in decibels or in a linear scale. The default is FALSE, which specifies that this VI expresses magnitude in a linear scale.
unwrap phase? specifies whether the phase is unwrapped. The default is FALSE, which specifies that the phase is wrapped.
convert to degree? specifies whether the unit of phase is in radians or degrees. The default is FALSE, which means the phase is in radians.
FRF magnitude specifies the magnitude of the averaged frequency response and frequency scale.
frequency specifies the frequencies, in hertz, at which this VI evaluates the averaged frequency response.
magnitude specifies the magnitude of the averaged frequency response. Use dB on? to specify the unit of magnitude.
FRF phase specifies the phase of the averaged frequency response and frequency scale.
frequency specifies the frequencies, in hertz, at which this VI evaluates the averaged frequency response.
phase specifies the phase of the averaged frequency response. Use unwrap phase? to specify whether the phase is unwrapped. Use convert to degrees? to specify the unit of phase.
orders of transfer function model specifies the numerator and denominator orders of the transfer function model.
num order specifies the numerator order of the system model. The default value is 1.
den order specifies the denominator order of the system model. The default value is 2.
error in describes error conditions that occur before this VI or function runs. The default is no error. If an error occurred before this VI or function runs, the VI or function passes the error in value to error out. This VI or function runs normally only if no error occurred before this VI or function runs. If an error occurs while this VI or function runs, it runs normally and sets its own error status in error out. Use the Simple Error Handler or General Error Handler VIs to display the description of the error code. Use error in and error out to check errors and to specify execution order by wiring error out from one node to error in of the next node.
status is TRUE (X) if an error occurred before this VI or function ran or FALSE (checkmark) to indicate a warning or that no error occurred before this VI or function ran. The default is FALSE.
code is the error or warning code. The default is 0. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code.
source specifies the origin of the error or warning and is, in most cases, the name of the VI or function that produced the error or warning. The default is an empty string.
sampling rate specifies the sampling frequency, in hertz, of the estimated discrete system model. The value of sampling rate must be greater than 0. The default value is twice the highest frequency of the FRF data.
iteration criteria specifies the iteration number and tolerance.
iteration num specifies the maximum number of iterations to estimate the model.
tolerance specifies the upper bound of the estimation error under which the iteration stops.
system model out returns information about the model structure, nominal or estimated parameters, identification result, and so on. Use the Model Management VIs to retrieve the information system model out contains.
Note  You can use a customized system model probe to view model information that flows through system model wires when you debug a block diagram created with the System Identification VIs. Right-click a system model wire and select Custom Probe»SI System Model from the shortcut menu to use the system model probe.
coefficients of transfer function model returns the coefficients of the transfer function model.
numerator returns the numerator coefficients of the transfer function model, in ascending order. The coefficients take the following form: b0 + b1z + … + bmzm.
denominator returns the denominator coefficients of the transfer function model, in ascending order. The coefficients take the following form: a0 + a1z + … + anzn.
error out contains error information. If error in indicates that an error occurred before this VI or function ran, error out contains the same error information. Otherwise, it describes the error status that this VI or function produces. Right-click the error out front panel indicator and select Explain Error from the shortcut menu for more information about the error.
status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.
code is the error or warning code. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code.
source describes the origin of the error or warning and is, in most cases, the name of the VI or function that produced the error or warning.

SI Estimate Discrete Transfer Function Model from FRF (SISO Uniform)

FRF weight specifies the frequency-domain weight of the estimation error. The estimation error is the difference between the original FRF and the FRF that the system model out generates. As you increase the FRF weight at a certain frequency, the estimation error at that frequency decreases.
FRF format specifies the format of the FRF magnitude and the FRF phase.
Note  If you use the SI Estimate FRF VI to estimate the FRF, specify the same FRF format settings for this parameter as you do for the SI Estimate FRF VI.
dB on? specifies whether magnitude is in decibels or in a linear scale. The default is FALSE, which specifies that this VI expresses magnitude in a linear scale.
unwrap phase? specifies whether the phase is unwrapped. The default is FALSE, which specifies that the phase is wrapped.
convert to degree? specifies whether the unit of phase is in radians or degrees. The default is FALSE, which means the phase is in radians.
FRF magnitude specifies the magnitude of the averaged frequency response and frequency scale.
f0 specifies the starting frequency of the spectrum, in hertz.
df specifies the frequency increment of the spectrum, in hertz.
magnitude specifies the magnitude of the averaged frequency response. Use dB on? to specify the unit of magnitude.
FRF phase specifies the phase of the averaged frequency response and frequency scale.
f0 specifies the starting frequency of the spectrum, in hertz.
df specifies the frequency increment of the spectrum, in hertz.
phase specifies the phase of the averaged frequency response. Use unwrap phase? to specify whether the phase is unwrapped. Use convert to degrees? to specify the unit of phase.
orders of transfer function model specifies the numerator and denominator orders of the transfer function model.
num order specifies the numerator order of the system model. The default value is 1.
den order specifies the denominator order of the system model. The default value is 2.
error in describes error conditions that occur before this VI or function runs. The default is no error. If an error occurred before this VI or function runs, the VI or function passes the error in value to error out. This VI or function runs normally only if no error occurred before this VI or function runs. If an error occurs while this VI or function runs, it runs normally and sets its own error status in error out. Use the Simple Error Handler or General Error Handler VIs to display the description of the error code. Use error in and error out to check errors and to specify execution order by wiring error out from one node to error in of the next node.
status is TRUE (X) if an error occurred before this VI or function ran or FALSE (checkmark) to indicate a warning or that no error occurred before this VI or function ran. The default is FALSE.
code is the error or warning code. The default is 0. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code.
source specifies the origin of the error or warning and is, in most cases, the name of the VI or function that produced the error or warning. The default is an empty string.
sampling rate specifies the sampling frequency, in hertz, of the estimated discrete system model. The value of sampling rate must be greater than 0. The default value is twice the highest frequency of the FRF data.
iteration criteria specifies the iteration number and tolerance.
iteration num specifies the maximum number of iterations to estimate the model.
tolerance specifies the upper bound of the estimation error under which the iteration stops.
system model out returns information about the model structure, nominal or estimated parameters, identification result, and so on. Use the Model Management VIs to retrieve the information system model out contains.
Note  You can use a customized system model probe to view model information that flows through system model wires when you debug a block diagram created with the System Identification VIs. Right-click a system model wire and select Custom Probe»SI System Model from the shortcut menu to use the system model probe.
coefficients of transfer function model returns the coefficients of the transfer function model.
numerator returns the numerator coefficients of the transfer function model, in ascending order. The coefficients take the following form: b0 + b1z + … + bmzm.
denominator returns the denominator coefficients of the transfer function model, in ascending order. The coefficients take the following form: a0 + a1z + … + anzn.
error out contains error information. If error in indicates that an error occurred before this VI or function ran, error out contains the same error information. Otherwise, it describes the error status that this VI or function produces. Right-click the error out front panel indicator and select Explain Error from the shortcut menu for more information about the error.
status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.
code is the error or warning code. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code.
source describes the origin of the error or warning and is, in most cases, the name of the VI or function that produced the error or warning.

SI Estimate Transfer Function Model from FRF Details

If the frequency-domain data you wire to the FRF magnitude and FRF phase inputs is spaced uniformly, use the Uniform polymorphic instance of this VI. In this situation, you must specify the starting frequency f0 and the frequency increment df. If this data is spaced arbitrarily, use the Arbitrary polymorphic instance of this VI.

Note  You also can use the Arbitrary polymorphic instance if the frequency-domain data you wire to the FRF magnitude and FRF phase inputs is spaced uniformly.

Example

Refer to the Flexible Arm (Frequency Domain) VI in the labview\examples\System Identification\Industry Applications\Mechanical Systems.llb for an example of using the SI Estimate Transfer Function Model from FRF VI.

 Open example  Browse related examples

previous page start next page