← Back to branch summary

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

« back to all changes in this revision

Viewing changes to man/graphics/nyquist.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/nyquist.man
 
1
.TH nyquist 1 "April 1993" "Scilab Group" "Scilab Function"
 
2
.so ../sci.an
 
3
.SH NAME
 
4
nyquist - nyquist plot
 
5
.SH CALLING SEQUENCE
 
6
.nf
 
7
nyquist( sl,[fmin,fmax] [,step] [,comments] )
 
8
nyquist( sl, frq [,comments] )
 
9
nyquist(frq,db,phi [,comments])
 
10
nyquist(frq, repf  [,comments])
 
11
.fi
 
12
.SH PARAMETERS
 
13
.TP 10
 
14
sl       
 
15
: \fVsyslin\fR list (SIMO linear system in continuous or discrete time )
 
16
.TP
 
17
fmin,fmax
 
18
: real scalars (frequency bounds (in Hz))
 
19
.TP
 
20
step      
 
21
: real (logarithmic discretization step)
 
22
.TP
 
23
comments 
 
24
: string vector (captions).
 
25
.TP
 
26
frq      
 
27
: vector or matrix of frequencies (in Hz) (one row for
 
28
each output of \fVsl\fR).
 
29
.TP
 
30
db,phi       
 
31
: real matrices of modulus (in Db) and phases (in degree) (one row for each output of \fVsl\fR).
 
32
.TP
 
33
repf     
 
34
: matrix of complex numbers. Frequency response (one row
 
35
for aech output of \fVsl\fR)
 
36
.SH DESCRIPTION
 
37
Nyquist plot i.e Imaginary part versus Real part of the frequency
 
38
response of \fVsl\fR. 
 
39
.LP
 
40
For continous time systems \fVsl(2*%i*%pi*w)\fR is plotted.
 
41
For discrete time system or discretized systems \fVsl(exp(2*%i*%pi*w*fd)\fR 
 
42
is used ( \fVfd=1\fR for discrete time systems and \fVfd=sl('dt')\fR for discretized systems ) 
 
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
.LP
 
48
The frequencies are given by the bounds \fVfmin,fmax\fR (in Hz) or by a row-vector
 
49
(or a matrix for multi-output) \fVfrq\fR.
 
50
.LP
 
51
\fVstep\fR is the ( logarithmic ) discretization step. (see \fVcalfrq\fR for the
 
52
choice of default value).
 
53
.LP
 
54
\fVcomments\fR is a vector of character strings (captions).
 
55
.LP
 
56
\fVdb,phi\fR are the matrices of modulus (in Db) and phases (in degrees). 
 
57
(One row for each response).
 
58
.LP
 
59
\fVrepf\fR is a matrix of complex numbers. One row for each response.
 
60
.LP
 
61
Default values for \fVfmin\fR and \fVfmax\fR are
 
62
\fV1.d-3\fR, \fV1.d+3\fR if \fVsl\fR is continuous-time
 
63
or \fV1.d-3\fR, \fV0.5\fR if \fVsl\fR is discrete-time.
 
64
.LP
 
65
Automatic discretization of frequencies is made by \fVcalfrq\fR.
 
66
.SH EXAMPLE
 
67
.nf
 
68
xbasc();
 
69
s=poly(0,'s');
 
70
h=syslin('c',(s^2+2*0.9*10*s+100)/(s^2+2*0.3*10.1*s+102.01));
 
71
comm='(s^2+2*0.9*10*s+100)/(s^2+2*0.3*10.1*s+102.01)';
 
72
nyquist(h,0.01,100,comm);
 
73
h1=h*syslin('c',(s^2+2*0.1*15.1*s+228.01)/(s^2+2*0.9*15*s+225))
 
74
xbasc();
 
75
nyquist([h1;h],0.01,100,['h1';'h'])
 
76
xbasc();nyquist([h1;h])
 
77
.fi
 
78
.SH SEE ALSO
 
79
bode, black, calfrq, freq, repfreq, phasemag
 
80