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

« back to all changes in this revision

Viewing changes to man/graphics/nyquist.cat

  • 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
 
nyquist           Scilab Group           Scilab Function            nyquist
2
 
NAME
3
 
   nyquist - nyquist plot
4
 
  
5
 
CALLING SEQUENCE
6
 
 nyquist( sl,[fmin,fmax] [,step] [,comments] )
7
 
 nyquist( sl, frq [,comments] )
8
 
 nyquist(frq,db,phi [,comments])
9
 
 nyquist(frq, repf  [,comments])
10
 
PARAMETERS
11
 
 sl         : syslin list (SIMO linear system in continuous or discrete
12
 
            time )
13
 
            
14
 
 fmin,fmax  : real scalars (frequency bounds (in Hz))
15
 
            
16
 
 step       : real (logarithmic discretization step)
17
 
            
18
 
 comments   : string vector (captions).
19
 
            
20
 
 frq        : vector or matrix of frequencies (in Hz) (one row for each
21
 
            output of sl).
22
 
            
23
 
 db,phi     : real matrices of modulus (in Db) and phases (in degree) (one
24
 
            row for each output of sl).
25
 
            
26
 
 repf       : matrix of complex numbers. Frequency response (one row for
27
 
            aech output of sl)
28
 
            
29
 
DESCRIPTION
30
 
   Nyquist plot i.e Imaginary part versus Real part of the frequency
31
 
  response of sl. 
32
 
  
33
 
   For continous time systems sl(2*%i*%pi*w) is plotted. For discrete time
34
 
  system or discretized systems sl(exp(2*%i*%pi*w*fd)  is used ( fd=1 for
35
 
  discrete time systems and fd=sl('dt') for discretized systems )   sl can
36
 
  be a continuous-time or discrete-time SIMO system (see syslin). In case
37
 
  of multi-output the outputs are plotted with different symbols.
38
 
  
39
 
   The frequencies are given by the bounds fmin,fmax (in Hz) or by a
40
 
  row-vector (or a matrix for multi-output) frq.
41
 
  
42
 
   step is the ( logarithmic ) discretization step. (see calfrq for the
43
 
  choice of default value).
44
 
  
45
 
   comments is a vector of character strings (captions).
46
 
  
47
 
   db,phi are the matrices of modulus (in Db) and phases (in degrees).  (One
48
 
  row for each response).
49
 
  
50
 
   repf is a matrix of complex numbers. One row for each response.
51
 
  
52
 
   Default values for fmin and fmax are 1.d-3, 1.d+3 if sl is
53
 
  continuous-time or 1.d-3, 0.5 if sl is discrete-time.
54
 
  
55
 
   Automatic discretization of frequencies is made by calfrq.
56
 
  
57
 
EXAMPLE
58
 
 xbasc();
59
 
 s=poly(0,'s');
60
 
 h=syslin('c',(s^2+2*0.9*10*s+100)/(s^2+2*0.3*10.1*s+102.01));
61
 
 comm='(s^2+2*0.9*10*s+100)/(s^2+2*0.3*10.1*s+102.01)';
62
 
 nyquist(h,0.01,100,comm);
63
 
 h1=h*syslin('c',(s^2+2*0.1*15.1*s+228.01)/(s^2+2*0.9*15*s+225))
64
 
 xbasc();
65
 
 nyquist([h1;h],0.01,100,['h1';'h'])
66
 
 xbasc();nyquist([h1;h])
67
 
SEE ALSO
68
 
   bode, black, calfrq, freq, repfreq, phasemag 
69