Skip to Main Content Skip to Search
Product Documentation

getLoopTransfer - Class: slTunable

Tunable model of open-loop transfer function at specified location

Syntax

L = getLoopTransfer(ST,location)
L = getLoopTransfer(ST,location,sign)
L = getLoopTransfer(ST,location,openings)
L = getLoopTransfer(ST,location,openings,sign)

Description

L = getLoopTransfer(ST,location) returns the linearized point-to-point open-loop transfer function of the control system described by the slTunable interface ST. The point-to-point open-loop transfer function L is the open-loop response obtained by injecting signals at location and measuring the return signals at the same point.

L = getLoopTransfer(ST,location,sign) specifies the sign of L. By default, L is the positive-feedback open-loop transfer function. Set sign to -1 to compute the negative-feedback open-loop transfer function.

L = getLoopTransfer(ST,location,openings) computes L with additional loop openings at the locations specified by openings.

L = getLoopTransfer(ST,location,openings,sign) specifies both additional loop openings and the sign.

Input Arguments

ST

slTunable interface describing a Simulink model.

location

String or cell array of strings specifying signal locations at which to compute a point-to-point open loop transfer function. Each signal in location must be present in the Switches, Controls, or Measurements properties of the slTunable interface ST. Use a cell array to specify multiple locations and compute a MIMO loop transfer.

You can specify an abbreviated signal path in location provided the string matches the end of the full signal path and unambiguously identifies the signal.

sign

Sign of the open-loop transfer function L.

  • +1 (default) — getLoopTransfer returns the positive-feedback open-loop transfer function, computed by injecting sine waves at the locations specified in location and measuring the return signals at the same point. The closed-loop transfer function is feedback(L,1,+1).

  • -1getLoopTransfer returns the negative-feedback open-loop transfer function. The negative-feedback transfer function is –1 times the positive-feedback transfer function. The closed-loop transfer function is feedback(L,1).

Set sign to -1 if you intend to use the open-loop transfer function L in applications that assume the negative-feedback definition of L. Many classical design and analysis techniques use the negative-feedback convention. For example, the Nyquist or root locus design techniques usually assume that L is defined such that the closed-loop transfer function is feedback(L,1).

Default: +1

openings

String or cell array of strings specifying additional locations at which feedback loops are opened for the computation of L. Specify the locations as the names of signals listed in the Controls, Measurements, or Switches properties of ST. Loop openings listed in the Openings property of ST are always open.

You can specify an abbreviated signal path in openings provided the string matches the end of the full signal path and unambiguously identifies the signal.

Default: {0x1 cell}

Output Arguments

L

Tunable genss model of the point-to-point response measured at location. If location is a cell array identifying multiple signals, L is a MIMO response.

L captures the dependence of the response on the parameters of the tunable blocks in the TunedBlocks property of ST. The current values of the tunable parameters of L are equal to the current parameter values in L. Therefore, you can use getLoopTransfer after tuning ST with slTunable.looptune to examine open-loop responses of the tuned control system.

See Also

genss | slTunable | slTunable.getIOTransfer | slTunable.loopview

Tutorials

  


Free Control Systems Interactive Kit

Learn more about resources for designing, testing, and implementing control systems.

Get free kit

Trials Available

Try the latest control systems products.

Get trial software
 © 1984-2012- The MathWorks, Inc.    -   Site Help   -   Patents   -   Trademarks   -   Privacy Policy   -   Preventing Piracy   -   RSS