home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / octa21eb.zip / octave / SCRIPTS.ZIP / scripts / control / sysscale.m < prev    next >
Text File  |  1999-03-05  |  4KB  |  133 lines
  1. # Copyright (C) 1996,1998 A. Scottedward Hodel 
  2. #
  3. # This file is part of Octave. 
  4. #
  5. # Octave is free software; you can redistribute it and/or modify it 
  6. # under the terms of the GNU General Public License as published by the 
  7. # Free Software Foundation; either version 2, or (at your option) any 
  8. # later version. 
  9. # 
  10. # Octave is distributed in the hope that it will be useful, but WITHOUT 
  11. # ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or 
  12. # FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License 
  13. # for more details.
  14. # 
  15. # You should have received a copy of the GNU General Public License 
  16. # along with Octave; see the file COPYING.  If not, write to the Free 
  17. # Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA. 
  18.  
  19. function sys = sysscale(sys,outscale,inscale,outname,inname)
  20. #
  21. # function sys = sysscale(sys,outscale,inscale[,outname,inname])
  22. # scale inputs/outputs of a system.
  23. #
  24. # inputs:
  25. #   sys: system data structure
  26. #   outscale, inscale: constant matrices of appropriate dimension
  27. # output: sys: resulting open loop system:
  28. #
  29. #           -----------    -------    -----------
  30. #     u --->| inscale |--->| sys |--->| outscale |---> y
  31. #           -----------    -------    -----------
  32. # 
  33. # If the input names and output names are not given and the scaling matrices
  34. # are not square, then default names will be given to the inputs and/or
  35. # outputs.
  36. #
  37. # A warning message is printed if outscale attempts to add continuous
  38. # system outputs to discrete system outputs; otherwise yd is set appropriately
  39.  
  40. # A. S. Hodel August 1995
  41. # modified by John Ingram 7-15-96
  42.  
  43.   if( (nargin < 3) || (nargin > 5)  )
  44.     usage("retsys = sysscale(Asys,output_list,input_list{,inname,outname})");
  45.   elseif (!is_struct(sys))
  46.     error("sys must be a structured system");
  47.   endif
  48.  
  49.   [nn,nz,mm,pp] = sysdimensions(sys);
  50.  
  51.   # check for omitted scales
  52.   if(isempty(outscale))    outscale = eye(pp);     endif 
  53.   if(isempty(inscale))     inscale = eye(mm);      endif 
  54.  
  55.   # check dimensions of scaling matrices
  56.   if(mm!=rows(inscale))
  57.     error("inscale(%dx%d) should have %d rows(# system inputs)", ...
  58.       rows(inscale),columns(inscale),mm);
  59.   elseif( pp != columns(outscale) )
  60.     error("outscale(%dx%d) should have %d columns(# system outputs)", ...
  61.       rows(outscale), columns(outscale),pp);
  62.   endif
  63.  
  64.   sysyd = sysgetsignals(sys,"yd");
  65.   outc = find(sysyd==0);
  66.   outd = find(sysyd==1);
  67.  
  68.   if(length(outc) & length(outd))
  69.     for ii = 1:rows(outscale)
  70.       nci = norm(outscale(ii,outc));
  71.       ndi = norm(outscale(ii,outd));
  72.  
  73.       if( nci & ndi)
  74.         warning("sysscale: outscale(%d,:) sums continuous and discrete outputs; setting output to cont",ii)
  75.         sysyd(ii) = 0;
  76.       else
  77.         sysyd(ii) = (ndi != 0);
  78.       endif
  79.     endfor
  80.   else
  81.     sysyd = ones(1,rows(outscale))*( length(outd) > 0);
  82.   endif
  83.  
  84.   # check for SISO system type
  85.   if strcmp(sysgettype(sys),"tf")
  86.     [num,den,tsam,innam,outnam] = sys2tf(sys);
  87.     num = num*inscale*outscale;
  88.     sys = tf2sys(num,den,tsam,innam,outnam,find(sysyd));
  89.     return
  90.   elseif strcmp(sysgettype(sys),"zp")
  91.     [zer,pol,kk,tsam,innam,outnam] = sys2zp(sys);
  92.     kk = kk*inscale*outscale;
  93.     sys = zp2sys(zer,pol,k,tsam,innam,outnam,find(sysyd));
  94.     return
  95.   endif
  96.  
  97.   # it's a state space system...
  98.  
  99.   [sysa,sysb,sysc,sysd,systsam, ...
  100.     sysn,sysnz,sysstname,sysinname,sysoutname,oldyd] = sys2ss(sys);
  101.  
  102.   sysb = sysb*inscale;
  103.   sysc = outscale*sysc;
  104.   sysd = outscale*sysd*inscale;
  105.  
  106.   if( !is_square(outscale) )
  107.     # strip extra output names (if any)
  108.     sysoutname = sysoutname(1:min(rows(outscale),columns(outscale)));
  109.     if( nargin < 4)
  110.       warning("sysscale: outscale not square, outname not specified");
  111.       warning("sysscale:  using default output names");
  112.       outname = sysdefioname(rows(sysc),"y");
  113.     endif
  114.   else
  115.     outname = sysoutname;
  116.   endif
  117.   if( !is_square(inscale) )
  118.     # strip extra output names (if any)
  119.     sysinname = sysinname(1:min(rows(inscale),columns(inscale)));
  120.     if(nargin < 5)
  121.       warning("sysscale: inscale not square, inname not specified");
  122.       warning("sysscale:  using default input names");
  123.       inname = sysdefioname(columns(sysb),"u");
  124.     endif
  125.   else
  126.     inname = sysgetsignals(sys,"in");
  127.   endif
  128.  
  129.   sys = ss2sys(sysa,sysb,sysc,sysd,systsam,nn,nz,sysstname, ...
  130.     inname,outname,find(sysyd==1));
  131.  
  132. endfunction
  133.