← Back to branch summary

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

« back to all changes in this revision

Viewing changes to man/eng/robust/hinf.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
http://bugs.debian.org/255869
changed configure.in to build scilab's own malloc.o, closes: #255869

Show diffs side-by-side

added added

removed removed

Lines of Context:
man/eng/robust/hinf.xml
 
1
<?xml version="1.0" encoding="ISO-8859-1" standalone="no"?>
 
2
<!DOCTYPE MAN SYSTEM "../../manrev.dtd">
 
3
<MAN>
 
4
  <LANGUAGE>eng</LANGUAGE>
 
5
  <TITLE>hinf</TITLE>
 
6
  <TYPE>Scilab Function</TYPE>
 
7
  <DATE>April 1999</DATE>
 
8
  <SHORT_DESCRIPTION name="hinf">  H_infinity design of continuous-time systems</SHORT_DESCRIPTION>
 
9
  <CALLING_SEQUENCE>
 
10
    <CALLING_SEQUENCE_ITEM>   [AK,BK,CK,DK,(RCOND)] = hinf(A,B,C,D,ncon,nmeas,gamma)  </CALLING_SEQUENCE_ITEM>
 
11
  </CALLING_SEQUENCE>
 
12
  <PARAM>
 
13
    <PARAM_INDENT>
 
14
      <PARAM_ITEM>
 
15
        <PARAM_NAME>A</PARAM_NAME>
 
16
        <PARAM_DESCRIPTION>
 
17
          <SP>: the n-by-n system state matrix A.</SP>
 
18
        </PARAM_DESCRIPTION>
 
19
      </PARAM_ITEM>
 
20
      <PARAM_ITEM>
 
21
        <PARAM_NAME>B</PARAM_NAME>
 
22
        <PARAM_DESCRIPTION>
 
23
          <SP>: the n-by-m system input matrix B.</SP>
 
24
        </PARAM_DESCRIPTION>
 
25
      </PARAM_ITEM>
 
26
      <PARAM_ITEM>
 
27
        <PARAM_NAME>C</PARAM_NAME>
 
28
        <PARAM_DESCRIPTION>
 
29
          <SP>: the p-by-n system output matrix C.</SP>
 
30
        </PARAM_DESCRIPTION>
 
31
      </PARAM_ITEM>
 
32
      <PARAM_ITEM>
 
33
        <PARAM_NAME>D</PARAM_NAME>
 
34
        <PARAM_DESCRIPTION>
 
35
          <SP>: the p-by-m system matrix D.</SP>
 
36
        </PARAM_DESCRIPTION>
 
37
      </PARAM_ITEM>
 
38
      <PARAM_ITEM>
 
39
        <PARAM_NAME>ncon</PARAM_NAME>
 
40
        <PARAM_DESCRIPTION>
 
41
          <SP>: the number of control inputs. m &gt;= ncon &gt;= 0, p-nmeas &gt;= ncon.</SP>
 
42
        </PARAM_DESCRIPTION>
 
43
      </PARAM_ITEM>
 
44
      <PARAM_ITEM>
 
45
        <PARAM_NAME>nmeas</PARAM_NAME>
 
46
        <PARAM_DESCRIPTION>
 
47
          <SP>: the number of measurements. p &gt;= nmeas &gt;= 0, m-ncon &gt;= nmeas.</SP>
 
48
        </PARAM_DESCRIPTION>
 
49
      </PARAM_ITEM>
 
50
      <PARAM_ITEM>
 
51
        <PARAM_NAME>gamma</PARAM_NAME>
 
52
        <PARAM_DESCRIPTION>
 
53
          <SP>: the parameter gamma used in H_infinity design. It is assumed that gamma is sufficiently large so that the controller is admissible. gamma &gt;= 0.</SP>
 
54
        </PARAM_DESCRIPTION>
 
55
      </PARAM_ITEM>
 
56
      <PARAM_ITEM>
 
57
        <PARAM_NAME>AK</PARAM_NAME>
 
58
        <PARAM_DESCRIPTION>
 
59
          <SP>: the n-by-n controller state matrix AK.</SP>
 
60
        </PARAM_DESCRIPTION>
 
61
      </PARAM_ITEM>
 
62
      <PARAM_ITEM>
 
63
        <PARAM_NAME>BK</PARAM_NAME>
 
64
        <PARAM_DESCRIPTION>
 
65
          <SP>: the n-by-nmeas controller input matrix BK.</SP>
 
66
        </PARAM_DESCRIPTION>
 
67
      </PARAM_ITEM>
 
68
      <PARAM_ITEM>
 
69
        <PARAM_NAME>CK</PARAM_NAME>
 
70
        <PARAM_DESCRIPTION>
 
71
          <SP>: the ncon-by-n controller output matrix CK.</SP>
 
72
        </PARAM_DESCRIPTION>
 
73
      </PARAM_ITEM>
 
74
      <PARAM_ITEM>
 
75
        <PARAM_NAME>DK</PARAM_NAME>
 
76
        <PARAM_DESCRIPTION>
 
77
          <SP>: the ncon-by-nmeas controller matrix DK.</SP>
 
78
        </PARAM_DESCRIPTION>
 
79
      </PARAM_ITEM>
 
80
      <PARAM_ITEM>
 
81
        <PARAM_NAME>RCOND</PARAM_NAME>
 
82
        <PARAM_DESCRIPTION>
 
83
          <SP>: a vector containing estimates of the reciprocal condition numbers of the matrices which are to be inverted and estimates of the reciprocal condition numbers of the Riccati equations which have to be solved during the computation of the controller. (See the description of the algorithm in [1].)</SP>
 
84
          <PARAM_INDENT>
 
85
            <PARAM_ITEM>
 
86
              <PARAM_NAME>RCOND</PARAM_NAME>
 
87
              <PARAM_DESCRIPTION>
 
88
                <SP>(1) contains the reciprocal condition number of the  control transformation matrix TU,</SP>
 
89
              </PARAM_DESCRIPTION>
 
90
            </PARAM_ITEM>
 
91
            <PARAM_ITEM>
 
92
              <PARAM_NAME>RCOND</PARAM_NAME>
 
93
              <PARAM_DESCRIPTION>
 
94
                <SP>(2) contains the reciprocal condition number of the  measurement transformation matrix TY,</SP>
 
95
              </PARAM_DESCRIPTION>
 
96
            </PARAM_ITEM>
 
97
            <PARAM_ITEM>
 
98
              <PARAM_NAME>RCOND</PARAM_NAME>
 
99
              <PARAM_DESCRIPTION>
 
100
                <SP>(3) contains an estimate of the reciprocal condition number of the X-Riccati equation,</SP>
 
101
              </PARAM_DESCRIPTION>
 
102
            </PARAM_ITEM>
 
103
            <PARAM_ITEM>
 
104
              <PARAM_NAME>RCOND</PARAM_NAME>
 
105
              <PARAM_DESCRIPTION>
 
106
                <SP>(4) contains an estimate of the reciprocal condition number of the Y-Riccati equation.</SP>
 
107
              </PARAM_DESCRIPTION>
 
108
            </PARAM_ITEM>
 
109
          </PARAM_INDENT>
 
110
        </PARAM_DESCRIPTION>
 
111
      </PARAM_ITEM>
 
112
    </PARAM_INDENT>
 
113
  </PARAM>
 
114
  <DESCRIPTION>
 
115
    <P><VERB>[AK,BK,CK,DK,(RCOND)] = hinf(A,B,C,D,ncon,nmeas,gamma)</VERB>
 
116
    To compute the matrices of an H-infinity (sub)optimal n-state
 
117
    controller</P>
 
118
    <VERBATIM>
 
119
<![CDATA[
 
120
              | AK | BK |
 
121
          K = |----|----|,
 
122
              | CK | DK |
 
123
   ]]>
 
124
    </VERBATIM>
 
125
    <P>
 
126
    for the continuous-time system</P>
 
127
    <VERBATIM>
 
128
<![CDATA[
 
129
              | A  | B1  B2  |   | A | B |
 
130
          P = |----|---------| = |---|---|,
 
131
              | C1 | D11 D12 |   | C | D | 
 
132
              | C2 | D21 D22 |
 
133
   ]]>
 
134
    </VERBATIM>
 
135
    <P>
 
136
    and for a given value of gamma, where B2 has column size of the
 
137
    number of control inputs (ncon) and C2 has row size of the number
 
138
    of measurements (nmeas) being provided to the controller.</P>
 
139
  </DESCRIPTION>
 
140
  <SECTION label="References">
 
141
    <P>
 
142
    [1] P.Hr. Petkov, D.W. Gu and M.M. Konstantinov. Fortran 77 routines     for Hinf and H2 design of continuous-time linear control systems.     Report98-14, Department of Engineering, Leicester University,     August 1998.</P>
 
143
  </SECTION>
 
144
  <EXAMPLE>
 
145
<![CDATA[
 
146
//example from Niconet report SLWN1999-12
 
147
//Hinf
 
148
A=[-1  0  4  5 -3 -2
 
149
   -2  4 -7 -2  0  3
 
150
   -6  9 -5  0  2 -1
 
151
   -8  4  7 -1 -3  0
 
152
    2  5  8 -9  1 -4
 
153
    3 -5  8  0  2 -6];
 
154
 
 
155
B=[-3 -4 -2  1  0
 
156
    2  0  1 -5  2
 
157
   -5 -7  0  7 -2
 
158
    4 -6  1  1 -2
 
159
   -3  9 -8  0  5
 
160
    1 -2  3 -6 -2];
 
161
 
 
162
C=[ 1 -1  2 -4  0 -3
 
163
   -3  0  5 -1  1  1
 
164
   -7  5  0 -8  2 -2
 
165
    9 -3  4  0  3  7
 
166
    0  1 -2  1 -6 -2];
 
167
 
 
168
D=[ 1 -2 -3  0  0
 
169
    0  4  0  1  0
 
170
    5 -3 -4  0  1
 
171
    0  1  0  1 -3
 
172
    0  0  1  7  1];
 
173
Gamma=10.18425636157899;
 
174
[AK,BK,CK,DK] = hinf(A,B,C,D,2,2,Gamma)
 
175
 ]]>
 
176
  </EXAMPLE>
 
177
  <SEE_ALSO>
 
178
    <SEE_ALSO_ITEM>
 
179
      <LINK>dhinf</LINK>
 
180
    </SEE_ALSO_ITEM>
 
181
  </SEE_ALSO>
 
182
</MAN>