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

« back to all changes in this revision

Viewing changes to man/fr/control/arl2.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="ISO-8859-1" standalone="no"?>
 
2
<!DOCTYPE MAN SYSTEM "../../manrev.dtd">
 
3
<MAN>
 
4
  <LANGUAGE>eng</LANGUAGE>
 
5
  <TITLE>ARL2</TITLE>
 
6
  <TYPE>Scilab Function</TYPE>
 
7
  <DATE>April 1993</DATE>
 
8
  <SHORT_DESCRIPTION name="arl2"> SISO model realization by L2 transfer approximation</SHORT_DESCRIPTION>
 
9
  <CALLING_SEQUENCE>
 
10
    <CALLING_SEQUENCE_ITEM>h=arl2(y,den0,n [,imp])  </CALLING_SEQUENCE_ITEM>
 
11
    <CALLING_SEQUENCE_ITEM>h=arl2(y,den0,n [,imp],'all')  </CALLING_SEQUENCE_ITEM>
 
12
    <CALLING_SEQUENCE_ITEM>[den,num,err]=arl2(y,den0,n [,imp])  </CALLING_SEQUENCE_ITEM>
 
13
    <CALLING_SEQUENCE_ITEM>[den,num,err]=arl2(y,den0,n [,imp],'all')  </CALLING_SEQUENCE_ITEM>
 
14
  </CALLING_SEQUENCE>
 
15
  <PARAM>
 
16
    <PARAM_INDENT>
 
17
      <PARAM_ITEM>
 
18
        <PARAM_NAME>y</PARAM_NAME>
 
19
        <PARAM_DESCRIPTION>
 
20
          <SP>: real vector or polynomial in <VERB>z^-1</VERB>, it contains the coefficients of the Fourier's series of the rational system to approximate (the impulse response)</SP>
 
21
        </PARAM_DESCRIPTION>
 
22
      </PARAM_ITEM>
 
23
      <PARAM_ITEM>
 
24
        <PARAM_NAME>den0</PARAM_NAME>
 
25
        <PARAM_DESCRIPTION>
 
26
          <SP>: a polynomial which gives an initial guess of the solution, it may be <VERB>poly(1,'z','c')</VERB></SP>
 
27
        </PARAM_DESCRIPTION>
 
28
      </PARAM_ITEM>
 
29
      <PARAM_ITEM>
 
30
        <PARAM_NAME>n</PARAM_NAME>
 
31
        <PARAM_DESCRIPTION>
 
32
          <SP>: integer, the degree of approximating transfer function (degree of den)</SP>
 
33
        </PARAM_DESCRIPTION>
 
34
      </PARAM_ITEM>
 
35
      <PARAM_ITEM>
 
36
        <PARAM_NAME>imp</PARAM_NAME>
 
37
        <PARAM_DESCRIPTION>
 
38
          <SP>: integer in <VERB>(0,1,2)</VERB> (verbose mode)</SP>
 
39
        </PARAM_DESCRIPTION>
 
40
      </PARAM_ITEM>
 
41
      <PARAM_ITEM>
 
42
        <PARAM_NAME>h</PARAM_NAME>
 
43
        <PARAM_DESCRIPTION>
 
44
          <SP>: transfer function <VERB>num/den</VERB> or transfer matrix (column vector) when flag <VERB>'all'</VERB> is given.</SP>
 
45
        </PARAM_DESCRIPTION>
 
46
      </PARAM_ITEM>
 
47
      <PARAM_ITEM>
 
48
        <PARAM_NAME>den</PARAM_NAME>
 
49
        <PARAM_DESCRIPTION>
 
50
          <SP>: polynomial or vector of polynomials, contains the denominator(s) of the solution(s)</SP>
 
51
        </PARAM_DESCRIPTION>
 
52
      </PARAM_ITEM>
 
53
      <PARAM_ITEM>
 
54
        <PARAM_NAME>num</PARAM_NAME>
 
55
        <PARAM_DESCRIPTION>
 
56
          <SP>: polynomial or vector of polynomials, contains the numerator(s) of the solution(s)</SP>
 
57
        </PARAM_DESCRIPTION>
 
58
      </PARAM_ITEM>
 
59
      <PARAM_ITEM>
 
60
        <PARAM_NAME>err</PARAM_NAME>
 
61
        <PARAM_DESCRIPTION>
 
62
          <SP>: real constant or vector , the l2-error achieved for each solutions</SP>
 
63
        </PARAM_DESCRIPTION>
 
64
      </PARAM_ITEM>
 
65
    </PARAM_INDENT>
 
66
  </PARAM>
 
67
  <DESCRIPTION>
 
68
    <P><VERB>[den,num,err]=arl2(y,den0,n [,imp]) </VERB> finds a pair of polynomials
 
69
    <VERB>num</VERB> and <VERB>den</VERB> such that the transfer function <VERB>num/den</VERB>
 
70
    is stable and its impulse response approximates (with a minimal l2
 
71
    norm) the vector <VERB>y</VERB> assumed to be completed by an infinite number
 
72
    of zeros.</P>
 
73
    <P>
 
74
    If y(z)  =  y(1)(1/z)+y(2)(1/z^2)+ ...+ y(ny)(1/z^ny)</P>
 
75
    <P>
 
76
    then l2-norm of <VERB>num/den - y(z)</VERB> is <VERB>err</VERB>.</P>
 
77
    <P><VERB>n</VERB> is the degree of the polynomial <VERB>den</VERB>.</P>
 
78
    <P>
 
79
    The <VERB>num/den</VERB>  transfer function is a L2 approximant of the
 
80
    Fourier's series of the rational system.</P>
 
81
    <P>
 
82
    Various intermediate results are printed according to <VERB>imp</VERB>.</P>
 
83
    <P><VERB>[den,num,err]=arl2(y,den0,n [,imp],'all') </VERB>  returns in the
 
84
    vectors of polynomials <VERB>num</VERB> and <VERB>den</VERB>  a set of local
 
85
    optimums for the problem. The solutions are sorted with increasing
 
86
    errors <VERB>err</VERB>. In this case <VERB>den0</VERB> is already assumed to be 
 
87
    <VERB>poly(1,'z','c')</VERB></P>
 
88
  </DESCRIPTION>
 
89
  <EXAMPLE>
 
90
<![CDATA[
 
91
v=ones(1,20);
 
92
xbasc();
 
93
plot2d1('enn',0,[v';zeros(80,1)],2,'051',' ',[1,-0.5,100,1.5])
 
94
 
 
95
[d,n,e]=arl2(v,poly(1,'z','c'),1)
 
96
plot2d1('enn',0,ldiv(n,d,100),2,'000')
 
97
[d,n,e]=arl2(v,d,3)
 
98
plot2d1('enn',0,ldiv(n,d,100),3,'000')
 
99
[d,n,e]=arl2(v,d,8)
 
100
plot2d1('enn',0,ldiv(n,d,100),5,'000')
 
101
 
 
102
[d,n,e]=arl2(v,poly(1,'z','c'),4,'all')
 
103
plot2d1('enn',0,ldiv(n(1),d(1),100),10,'000')
 
104
 ]]>
 
105
  </EXAMPLE>
 
106
  <SEE_ALSO>
 
107
    <SEE_ALSO_ITEM>
 
108
      <LINK>ldiv</LINK>
 
109
    </SEE_ALSO_ITEM>
 
110
    <SEE_ALSO_ITEM>
 
111
      <LINK>imrep2ss</LINK>
 
112
    </SEE_ALSO_ITEM>
 
113
    <SEE_ALSO_ITEM>
 
114
      <LINK>time_id</LINK>
 
115
    </SEE_ALSO_ITEM>
 
116
    <SEE_ALSO_ITEM>
 
117
      <LINK>armax</LINK>
 
118
    </SEE_ALSO_ITEM>
 
119
    <SEE_ALSO_ITEM>
 
120
      <LINK>frep2tf</LINK>
 
121
    </SEE_ALSO_ITEM>
 
122
  </SEE_ALSO>
 
123
</MAN>