1
<?xml version="1.0" encoding="UTF-8"?>
3
* Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
6
* This file must be used under the terms of the CeCILL.
7
* This source file is licensed as described in the file COPYING, which
8
* you should have received as part of this distribution. The terms
9
* are also available at
10
* http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt
13
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" version="5.0-subset Scilab" xml:lang="en" xml:id="zgrid">
15
<refname>zgrid</refname>
16
<refpurpose> zgrid plot</refpurpose>
19
<title>Calling Sequence</title>
22
zgrid(zeta,wn [,colors])
23
zgrid(['new',] zeta,wn [,colors])
24
zgrid(zeta,wn [,'new'] [,colors])
28
<title>Arguments</title>
34
array of damping factors. Only values in <literal>[0
37
are taken into account. The default value is
38
<literal>0:0.1:1</literal>.
45
<para>array of normalized natural frequencies (factors of
46
π/dt). Only values in <literal>[0 1]</literal> are taken
47
into account. The default value is
48
<literal>0:0.1:1</literal>.
55
<para>a scalar or an 2 element array with integer values (color index).</para>
61
<title>Description</title>
63
plots z-plane grid lines: lines of constant damping factor
64
(selection given by <literal>zeta</literal>) and natural frequency
65
(selection given by <literal>wn</literal>) are drawn in within the
69
Iso-frequency curves are shown in on the interval
73
The <literal>colors</literal> argument may be used to assign a
74
color for constant damping ratio curves
75
(<literal>colors(2)</literal>) and for frequency curves
76
(<literal>colors(1)</literal>).
79
The <literal>zgrid</literal> function is often used to draw a grid
80
for evens root locus of continuous time linear systems. In such a
81
case the <literal>zgrid</literal> function should be called after
82
the call to <link linkend="evans">evans</link>. For continuous time linear
83
systems one should use <link linkend="sgrid">sgrid</link> function instead.
86
The optional argument <literal>'new'</literal> can be used to
87
erase the graphic window before plotting the grid.
91
<title>Examples</title>
92
<programlisting role="example"><![CDATA[
94
clf();zgrid(0:0.2:1,[0.2 0.6 0.8 1])
99
<imagedata fileref="../images/zgrid.svg"/>
103
<programlisting role="example"><![CDATA[
104
//zgrid with discrete time system root locus
106
H=syslin(0.01,(0.54-1.8*z+2.9*z^2-2.6*z^3+z^4)/(0.8+0.78*z-0.1*z^2+0.9*z^3+z^4))
107
clf();evans(H,1000);zgrid(0:0.1:0.5)
113
<imagedata fileref="../images/evans3.svg"/>
118
<refsection role="see also">
119
<title>See Also</title>
120
<simplelist type="inline">
122
<link linkend="evans">evans</link>
125
<link linkend="sgrid">sgrid</link>
128
<link linkend="freson">freson</link>
131
<link linkend="datatips">datatips</link>