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="nicholschart">
15
<refname>nicholschart</refname>
16
<refpurpose> Nichols chart</refpurpose>
19
<title>Calling Sequence</title>
20
<synopsis>nicholschart([ modules [,args [,colors]]])</synopsis>
24
<title>Arguments</title>
29
<para>real vector ( modules (in dB))</para>
35
<para>real vector (phases (in degree))</para>
41
<para>a scalar or a vector, the color indices for isogain and iso phase curves</para>
47
<title>Description</title>
48
<para> plot the Nichols'chart: iso-module and iso-argument contours of
49
<literal>y/(1+y)</literal> in <literal>y</literal> phase/gain plane
52
<literal>nicholschart</literal> may be used in cunjunction with
53
<link linkend="black">black</link>.
56
The default values for <literal>modules</literal> and
57
<literal>args</literal> are respectively :
60
<literal>[-12 -8 -6 -5 -4 -3 -2 -1.4 -1 -.5 0.25 0.5 0.7 1 1.4 2 2.3 3 4 5 6 8 12]</literal>
63
<literal>[-(1:10) , -(20:10:160)]</literal>
67
<title>Examples</title>
68
<programlisting role="example"><![CDATA[
71
nicholschart(modules=[-6 -3 -1 1 3 6], args=[-1 -20 20 40 80 160 180]);
76
<imagedata fileref="../images/nicholschart.svg"/>
80
<programlisting role="example"><![CDATA[
81
//Black diagram with Nichols chart as a grid
83
Plant=syslin('c',16000/((s+1)*(s+10)*(s+100)));
84
//two degree of freedom PID
86
PID=syslin('c',(1/(2*xsi*tau*s))*(1+2*xsi*tau*s+tau^2*s^2));
88
black([Plant;Plant*PID ],0.01,100,["Plant";"Plant and PID corrector"]);
89
//move the caption in the lower rigth corner
90
ax=gca();Leg=ax.children(1);
91
Leg.legend_location="in_lower_right";
92
nicholschart(colors=color('light gray')*[1 1])
97
<imagedata fileref="../images/black2.svg"/>
102
<refsection role="see also">
103
<title>See Also</title>
104
<simplelist type="inline">
106
<link linkend="black">black</link>
109
<link linkend="nyquist">nyquist</link>
112
<link linkend="hallchart">hallchart</link>