~ubuntu-branches/ubuntu/hoary/scilab/hoary

« back to all changes in this revision

Viewing changes to man/fr/graphics/evans.xml

  • Committer: Bazaar Package Importer
  • Author(s): Torsten Werner
  • Date: 2005-01-09 22:58:21 UTC
  • mfrom: (1.1.1 upstream)
  • Revision ID: james.westby@ubuntu.com-20050109225821-473xr8vhgugxxx5j
Tags: 3.0-12
changed configure.in to build scilab's own malloc.o, closes: #255869

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
<?xml version="1.0" encoding="UTF-8"?>
 
2
<!DOCTYPE MAN SYSTEM "../../manrev.dtd">
 
3
<MAN>
 
4
  <LANGUAGE>eng</LANGUAGE>
 
5
 
 
6
  <TITLE>evans</TITLE>
 
7
 
 
8
  <TYPE>Scilab Function</TYPE>
 
9
 
 
10
  <DATE>April 1993</DATE>
 
11
 
 
12
  <SHORT_DESCRIPTION name="evans">Evans root locus</SHORT_DESCRIPTION>
 
13
 
 
14
  <CALLING_SEQUENCE>
 
15
    <CALLING_SEQUENCE_ITEM>evans(H [,kmax])</CALLING_SEQUENCE_ITEM>
 
16
  </CALLING_SEQUENCE>
 
17
 
 
18
  <PARAM>
 
19
    <PARAM_INDENT>
 
20
      <PARAM_ITEM>
 
21
        <PARAM_NAME>H</PARAM_NAME>
 
22
 
 
23
        <PARAM_DESCRIPTION>
 
24
          <SP>: list (linear system <VERB>syslin</VERB>)</SP>
 
25
        </PARAM_DESCRIPTION>
 
26
      </PARAM_ITEM>
 
27
 
 
28
      <PARAM_ITEM>
 
29
        <PARAM_NAME>kmax</PARAM_NAME>
 
30
 
 
31
        <PARAM_DESCRIPTION>
 
32
          <SP>: real (maximum gain desired for the plot )</SP>
 
33
        </PARAM_DESCRIPTION>
 
34
      </PARAM_ITEM>
 
35
    </PARAM_INDENT>
 
36
  </PARAM>
 
37
 
 
38
  <DESCRIPTION>
 
39
    <P>Gives the Evans root locus for a linear system in state-space or
 
40
    transfer form H(s) (<VERB>syslin</VERB> list). This is the locus of the
 
41
    roots of <VERB>1+k*H(s)=1+k*N(s)/D(s)</VERB>, in the complex plane. For a
 
42
    selected sample of gains <VERB>k &lt;= kmax</VERB>, the imaginary part of
 
43
    the roots of <VERB>D(s)+k*N(s)</VERB> is plotted vs the real part.</P>
 
44
 
 
45
    <P>To obtain the gain at a given point of the locus you can simply execute
 
46
    the following instruction :
 
47
    <VERB>k=-1/real(horner(h,[1,%i]*locate(1)))</VERB> and click the desired
 
48
    point on the root locus. If the coordinates of the selected point are in
 
49
    the real 2 x 1 vector <VERB>P=locate(1)</VERB> this <VERB>k</VERB> solves
 
50
    the equation <VERB> k*N(w) + D(w) =0</VERB> with
 
51
    <VERB>w=P(1)+%i*P(2)=[1,%i]*P</VERB>.</P>
 
52
  </DESCRIPTION>
 
53
 
 
54
  <EXAMPLE><![CDATA[
 
55
 
 
56
H=syslin('c',352*poly(-5,'s')/poly([0,0,2000,200,25,1],'s','c'));
 
57
evans(H,100)
 
58
P=3.0548543 - 8.8491842*%i;    //P=selected point
 
59
k=-1/real(horner(H,P));
 
60
Ns=H('num');Ds=H('den');
 
61
roots(Ds+k*Ns)     //contains P as particular root
 
62
// Another one
 
63
clf();s=poly(0,'s');n=1+s;
 
64
d=real(poly([-1 -2 -%i %i],'s'));
 
65
evans(n,d,100);
 
66
//
 
67
clf();n=real(poly([0.1-%i 0.1+%i,-10],'s'));
 
68
evans(n,d,80);
 
69
 
 
70
  ]]></EXAMPLE>
 
71
 
 
72
  <SEE_ALSO>
 
73
    <SEE_ALSO_ITEM>
 
74
      <LINK>kpure</LINK>
 
75
    </SEE_ALSO_ITEM>
 
76
 
 
77
    <SEE_ALSO_ITEM>
 
78
      <LINK>krac2</LINK>
 
79
    </SEE_ALSO_ITEM>
 
80
 
 
81
    <SEE_ALSO_ITEM>
 
82
      <LINK>locate</LINK>
 
83
    </SEE_ALSO_ITEM>
 
84
  </SEE_ALSO>
 
85
</MAN>
 
 
b'\\ No newline at end of file'