Scilab Website | Contribute with GitLab | Mailing list archives | ATOMS toolboxes
Scilab Online Help
5.5.2 - Português

Change language to:
English - Français - 日本語 - Русский

Please note that the recommended version of Scilab is 2024.0.0. This page might be outdated.
See the recommended documentation of this function

Ajuda do Scilab >> CACSD > g_margin

g_margin

gain margin and associated crossover frequency

Calling Sequence

gm=g_margin(h)
[gm,fr]=g_margin(h)

Arguments

h

a SISO linear system (see :syslin).

gm

a number, the gain margin (in dB) if any of Inf

fr

a number, the associated frequency in hertz, or an empty matrix if the gain margin does not exist.

Description

Given a SISO linear system in continuous or discrete time, g_margin returns gm, the gain margin in dB of h and fr, the achieved corresponding frequency in Hz.

The gain margin, if it exists, is the minimal value of the system gain at points where the nyquist plot crosses the negative real axis. In other words the gain margin is 20*log10(1/g) where g is the open loop gain of h when the frequency response phase of h equals -180°

The algorithm uses polynomial root finder to solve the equations:

h(s)=h(-s)

for the continuous time case.

h(z)=h(1/z)

for the discrete time case.

Examples

h=syslin('c',-1+%s,3+2*%s+%s^2) //continuous time case
[g,fr]=g_margin(h)
[g,fr]=g_margin(h-10)
nyquist(h-10)
h = syslin(0.1,0.04798*%z+0.0464,%z^2-1.81*%z+0.9048);//discrete time case
[g ,fr]=g_margin(h);
show_margins(h)

See Also

  • p_margin — phase margin and associated crossover frequency
  • show_margins — display gain and phase margin and associated crossover frequencies
  • repfreq — frequency response
  • black — diagrama de Black (carta de Nichols)
  • bode — diagrama de Bode
  • nicholschart — Nichols chart
  • nyquist — diagrama de Nyquist
Report an issue
<< fstabst CACSD gamitg >>

Copyright (c) 2022-2023 (Dassault Systèmes)
Copyright (c) 2017-2022 (ESI Group)
Copyright (c) 2011-2017 (Scilab Enterprises)
Copyright (c) 1989-2012 (INRIA)
Copyright (c) 1989-2007 (ENPC)
with contributors
Last updated:
Wed Apr 01 10:24:17 CEST 2015