← Back to branch summary

~ubuntu-branches/ubuntu/karmic/scilab/karmic

« back to all changes in this revision

Viewing changes to man/graphics/bode.man

  • Committer: Bazaar Package Importer
  • Author(s): Torsten Werner
  • Date: 2002-03-21 16:57:43 UTC
  • Revision ID: james.westby@ubuntu.com-20020321165743-e9mv12c1tb1plztg
Tags: upstream-2.6
Import upstream version 2.6

Show diffs side-by-side

added added

removed removed

Lines of Context:
man/graphics/bode.man
 
1
.TH bode 1 "April 1993" "Scilab Group" "Scilab Function"
 
2
.so ../sci.an
 
3
.SH NAME
 
4
bode - Bode plot
 
5
.SH CALLING SEQUENCE
 
6
.nf
 
7
bode(sl,[fmin,fmax] [,step] [,comments] )
 
8
bode(sl,frq [,comments] )
 
9
bode(frq,db,phi [,comments])
 
10
bode(frq, repf  [,comments])
 
11
.fi
 
12
.SH PARAMETERS
 
13
.TP 15
 
14
sl
 
15
: \fVsyslin\fR list (SISO or SIMO linear system) in continuous or 
 
16
discrete time.
 
17
.TP
 
18
fmin,fmax
 
19
: real (frequency bounds (in Hz)) 
 
20
.TP
 
21
step      
 
22
: real (logarithmic step.)
 
23
.TP
 
24
comments 
 
25
: vector of character strings (captions).
 
26
.TP
 
27
frq      
 
28
: row vector or matrix (frequencies (in Hz) )
 
29
(one row for each SISO subsystem).
 
30
.TP
 
31
db       
 
32
: row vector or matrix ( magnitudes (in Db)).
 
33
(one row for each SISO subsystem).
 
34
.TP
 
35
phi      
 
36
: row vector or matrix ( phases (in degree))
 
37
(one row for each SISO subsystem).
 
38
.TP
 
39
repf     
 
40
: row vector or matrix of complex numbers (complex frequency response).
 
41
.SH DESCRIPTION
 
42
Bode plot, i.e magnitude and phase of the frequency response of \fVsl\fR.
 
43
 
 
44
\fVsl\fR can be a continuous-time or discrete-time SIMO system (see \fVsyslin\fR).
 
45
In case of multi-output the outputs are plotted with different
 
46
symbols.
 
47
 
 
48
.LP
 
49
The frequencies are given by the bounds \fVfmin,fmax\fR (in Hz) or by a row-vector
 
50
(or a matrix for multi-output) \fVfrq\fR.
 
51
 
 
52
.LP
 
53
\fVstep\fR is the ( logarithmic ) discretization step. (see \fVcalfrq\fR for the
 
54
choice of default value).
 
55
 
 
56
.LP
 
57
\fVcomments \fR is a vector of character strings (captions).
 
58
 
 
59
.LP
 
60
\fVdb,phi\fR are the matrices of modulus (in Db) and phases (in degrees). 
 
61
(One row for each response).
 
62
 
 
63
.LP
 
64
\fVrepf \fR matrix of complex numbers. One row for each response.
 
65
 
 
66
.LP
 
67
Default values for \fVfmin\fR and \fVfmax\fR are
 
68
\fV1.d-3\fR, \fV1.d+3\fR if \fVsl\fR is continuous-time
 
69
or \fV1.d-3\fR, \fV0.5\fR if \fVsl\fR is discrete-time.
 
70
Automatic discretization of frequencies is made by \fVcalfrq\fR.
 
71
.SH EXAMPLE
 
72
.nf
 
73
s=poly(0,'s')
 
74
h=syslin('c',(s^2+2*0.9*10*s+100)/(s^2+2*0.3*10.1*s+102.01))
 
75
title='(s^2+2*0.9*10*s+100)/(s^2+2*0.3*10.1*s+102.01)';
 
76
bode(h,0.01,100,title);
 
77
h1=h*syslin('c',(s^2+2*0.1*15.1*s+228.01)/(s^2+2*0.9*15*s+225))
 
78
xbasc()
 
79
bode([h1;h],0.01,100,['h1';'h'])
 
80
.fi
 
81
.SH SEE ALSO
 
82
black, nyquist, gainplot, repfreq, g_margin, p_margin, calfrq, phasemag