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

« back to all changes in this revision

Viewing changes to man/control/freq.man

  • 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
 
.TH FREQ G "April 1993" "Scilab Group" "Scilab Function"
2
 
.so ../sci.an 
3
 
.SH NAME
4
 
freq - frequency response
5
 
.SH CALLING SEQUENCE
6
 
.nf
7
 
[x]=freq(A,B,C [,D],f)
8
 
[x]=freq(NUM,DEN,f)
9
 
.fi
10
 
.SH PARAMETERS
11
 
.TP 15
12
 
A, B, C, D 
13
 
:  real matrices of respective dimensions \fVnxn, nxp, mxn, mxp\fR.
14
 
.TP
15
 
NUM,DEN
16
 
: polynomial matrices of dimension \fVmxp\fR
17
 
.TP
18
 
x
19
 
: real or complex matrix
20
 
.SH DESCRIPTION
21
 
\fVx=freq(A,B,C [,D],f)\fR returns a real or complex \fVmxp*t\fR matrix
22
 
such that:
23
 
.LP
24
 
\fVx(:,k*p:(k+1)*p)= C*inv(f(k)*eye()-A)*B + D\fR.
25
 
.LP
26
 
Thus, for \fVf\fR taking values along the imaginary axis or
27
 
on the unit circle \fVx\fR is the continuous or discrete time 
28
 
frequency response of \fV(A,B,C,D)\fR. 
29
 
 
30
 
.LP
31
 
\fVx=freq(NUM,DEN,f)\fR returns a real or complex matrix \fVx\fR such
32
 
that columns \fVk*(p-1)+1\fR to \fVk*p\fR of \fVx\fR contain the matrix  
33
 
\fVNUM(f(k))./DEN(f(k))\fR
34
 
.SH EXAMPLE
35
 
.nf
36
 
s=poly(0,'s');
37
 
sys=(s+1)/(s^3-5*s+4)
38
 
rep=freq(sys("num"),sys("den"),[0,0.9,1.1,2,3,10,20])
39
 
[horner(sys,0),horner(sys,20)]
40
 
//
41
 
Sys=tf2ss(sys);
42
 
[A,B,C,D]=abcd(Sys);
43
 
freq(A,B,C,[0,0.9,1.1,2,3,10,20])
44
 
.fi
45
 
.SH SEE ALSO
46
 
repfreq, horner
47