home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / octa21eb.zip / octave / SCRIPTS.ZIP / scripts / control / step.m < prev    next >
Text File  |  1999-03-05  |  2KB  |  77 lines
  1. # Copyright (C) 1996 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 [y, t] = step(sys, inp, tstop, n)
  20. # step: Step response for a linear system.
  21. #       The system can be discrete or multivariable (or both).
  22. #
  23. # [y, t] = step(sys[, inp, tstop, n])
  24. # Produces a plot or the step response data for system sys.
  25. #
  26. # The argument tstop (scalar value) denotes the time when the
  27. # simulation should end. The Parameter n is the number of data values.
  28. # Both parameters tstop and n can be ommitted and will be
  29. # computed from the eigenvalues of the A-Matrix.
  30. #
  31. # When the step function is invoked with the output parameter y
  32. # a plot is not displayed.
  33. #
  34. # See also: impulse, stepimp
  35.  
  36. # Written by Kai P. Mueller September 30, 1997
  37. # based on lsim.m of Scottedward Hodel
  38. # modified by
  39.  
  40.   if((nargin < 1) || (nargin > 4))
  41.     usage("[y, u] = step(sys[, inp, tstop, n])");
  42.   endif
  43.  
  44.   if(nargout > 2)
  45.     usage("[y, u] = step(sys[, inp, tstop, n])");
  46.   endif
  47.  
  48.   if(!is_struct(sys))
  49.     error("step: sys must be a system data structure.");
  50.   endif
  51.  
  52.   if (nargout == 0)
  53.     switch (nargin)
  54.       case (1)
  55.         stepimp(1, sys);
  56.       case (2)
  57.         stepimp(1, sys, inp);
  58.       case (3)
  59.         stepimp(1, sys, inp, tstop);
  60.       case (4)
  61.         stepimp(1, sys, inp, tstop, n);
  62.     endswitch
  63.   else
  64.     switch (nargin)
  65.       case (1)
  66.         [y, t] = stepimp(1, sys);
  67.       case (2)
  68.         [y, t] = stepimp(1, sys, inp);
  69.       case (3)
  70.         [y, t] = stepimp(1, sys, inp, tstop);
  71.       case (4)
  72.         [y, t] = stepimp(1, sys, inp, tstop, n);
  73.     endswitch
  74.   endif
  75.  
  76. endfunction
  77.