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

« back to all changes in this revision

Viewing changes to man/eng/control/freq.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>FREQ</TITLE>
 
6
  <TYPE>Scilab Function</TYPE>
 
7
  <DATE>April 1993</DATE>
 
8
  <SHORT_DESCRIPTION name="freq"> frequency response</SHORT_DESCRIPTION>
 
9
  <CALLING_SEQUENCE>
 
10
    <CALLING_SEQUENCE_ITEM>[x]=freq(A,B,C [,D],f)  </CALLING_SEQUENCE_ITEM>
 
11
    <CALLING_SEQUENCE_ITEM>[x]=freq(NUM,DEN,f)  </CALLING_SEQUENCE_ITEM>
 
12
  </CALLING_SEQUENCE>
 
13
  <PARAM>
 
14
    <PARAM_INDENT>
 
15
      <PARAM_ITEM>
 
16
        <PARAM_NAME>A, B, C, D</PARAM_NAME>
 
17
        <PARAM_DESCRIPTION>
 
18
          <SP>:  real matrices of respective dimensions <VERB>nxn, nxp, mxn, mxp</VERB>.</SP>
 
19
        </PARAM_DESCRIPTION>
 
20
      </PARAM_ITEM>
 
21
      <PARAM_ITEM>
 
22
        <PARAM_NAME>NUM,DEN</PARAM_NAME>
 
23
        <PARAM_DESCRIPTION>
 
24
          <SP>: polynomial matrices of dimension <VERB>mxp</VERB></SP>
 
25
        </PARAM_DESCRIPTION>
 
26
      </PARAM_ITEM>
 
27
      <PARAM_ITEM>
 
28
        <PARAM_NAME>x</PARAM_NAME>
 
29
        <PARAM_DESCRIPTION>
 
30
          <SP>: real or complex matrix</SP>
 
31
        </PARAM_DESCRIPTION>
 
32
      </PARAM_ITEM>
 
33
    </PARAM_INDENT>
 
34
  </PARAM>
 
35
  <DESCRIPTION>
 
36
    <P><VERB>x=freq(A,B,C [,D],f)</VERB> returns a real or complex <VERB>mxp*t</VERB> matrix
 
37
    such that:</P>
 
38
    <P><VERB>x(:,k*p:(k+1)*p)= C*inv(f(k)*eye()-A)*B + D</VERB>.</P>
 
39
    <P>
 
40
    Thus, for <VERB>f</VERB> taking values along the imaginary axis or
 
41
    on the unit circle <VERB>x</VERB> is the continuous or discrete time 
 
42
    frequency response of <VERB>(A,B,C,D)</VERB>.</P>
 
43
    <P><VERB>x=freq(NUM,DEN,f)</VERB> returns a real or complex matrix <VERB>x</VERB> such
 
44
    that columns <VERB>k*(p-1)+1</VERB> to <VERB>k*p</VERB> of <VERB>x</VERB> contain the matrix  
 
45
    <VERB>NUM(f(k))./DEN(f(k))</VERB></P>
 
46
  </DESCRIPTION>
 
47
  <EXAMPLE>
 
48
<![CDATA[
 
49
s=poly(0,'s');
 
50
sys=(s+1)/(s^3-5*s+4)
 
51
rep=freq(sys("num"),sys("den"),[0,0.9,1.1,2,3,10,20])
 
52
[horner(sys,0),horner(sys,20)]
 
53
//
 
54
Sys=tf2ss(sys);
 
55
[A,B,C,D]=abcd(Sys);
 
56
freq(A,B,C,[0,0.9,1.1,2,3,10,20])
 
57
 ]]>
 
58
  </EXAMPLE>
 
59
  <SEE_ALSO>
 
60
    <SEE_ALSO_ITEM>
 
61
      <LINK>repfreq</LINK>
 
62
    </SEE_ALSO_ITEM>
 
63
    <SEE_ALSO_ITEM>
 
64
      <LINK>horner</LINK>
 
65
    </SEE_ALSO_ITEM>
 
66
  </SEE_ALSO>
 
67
</MAN>