allmargin (Control Design and Simulation Module, MathScript Function)
Member of the frqrsp class.
Syntax
gmf = allmargin(SysInSISO)
[gmf, gm] = allmargin(SysInSISO)
[gmf, gm, pmf] = allmargin(SysInSISO)
[gmf, gm, pmf, pm] = allmargin(SysInSISO)
Description
Calculates all gain and phase margins of a single-input single-output (SISO) system model. The gain margins indicate where the frequency response crosses at 0 decibels. The phase margins indicate where the frequency response crosses -180 degrees. Use the margin function to return only the smallest gain and phase margins of a SISO model.
Inputs
| Name | Description |
| SysInSISO | Specifies a linear time-invariant (LTI) SISO model in transfer function, zero-pole-gain, or state-space form. |
Outputs
| Name | Description |
| gmf | Returns the gain margin frequencies, in radians/second, of the SysInSISO model. A gain margin frequency indicates where the model phase crosses -180 degrees. The i-th element of this vector corresponds to the i-th element of the gm vector. gmf is a real vector. |
| gm | Returns the gain margins of the SysInSISO model. gm is a real vector. |
| pmf | Returns the phase margin frequencies, in radians/second, of the SysInSISO model. A phase margin frequency indicates where the model magnitude crosses 0 decibels. The i-th element of this vector corresponds to the i-th element of the pm vector. pmf is a real vector. |
| pm | Returns the phase margins of SysInSISO. pm is a real vector. |
Examples
SysInSISO = tf([1, 1], [1, -1, 3])[gmf, gm, pmf, pm] = allmargin(SysInSISO)