home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / octa21eb.zip / octave / SCRIPTS.ZIP / scripts.fat / control / dcgain.m < prev    next >
Text File  |  1999-04-29  |  2KB  |  52 lines
  1. # Copyright (C) 1993, 1994, 1995 John W. Eaton
  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 gm = dcgain(sys, tol)
  20. # Usage: gm = dcgain(sys[, tol])
  21. #      Returns dc-gain matrix. If dc-gain is infinity
  22. #      an empty matrix is returned.
  23. #      The argument tol is an optional tolerance for the condition
  24. #      number of A-Matrix in sys (default tol = 1.0e-10)
  25. #      Prints a warning message of the system is unstable.
  26. #
  27.  
  28. # Written by Kai P Mueller (mueller@ifr.ing.tu-bs.de) October 1, 1997
  29.  
  30.   if((nargin < 1) || (nargin > 2) || (nargout > 1))
  31.     usage("[gm, ok] = dcgain(sys[, tol])");
  32.   endif
  33.   if(!is_struct(sys))
  34.     error("dcgain: first argument is not a system data structure.")
  35.   endif
  36.   sys = sysupdat(sys, "ss");
  37.   [aa,bb,cc,dd] = sys2ss(sys);
  38.   if (is_digit(sys))  aa = aa - eye(size(aa));  endif
  39.   if (nargin == 1)  tol = 1.0e-10;  endif
  40.   r = rank(aa, tol);
  41.   if (r < rows(aa))
  42.     gm = [];
  43.   else
  44.     gm = -cc / aa * bb + dd;
  45.   endif
  46.   if(!is_stabl(sys))
  47.     [nn,nz,mm,pp] = sysdimen(sys);
  48.     warning("dcgain: unstable system; dimensions [nc=%d,nz=%d,mm=%d,pp=%d]", ...
  49.       nn,nz,mm,pp);
  50.   endif
  51. endfunction
  52.