home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-dist / octave-1.1.1p1-src.tgz / tar.out / fsf / octave / scripts / general / triu.m < prev   
Text File  |  1996-09-28  |  1KB  |  49 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 retval = triu (x, k)
  20.  
  21. # usage: triu (x, k)
  22. #
  23. # Return the upper triangular part of x above the k-th diagonal.  If
  24. # the second argument is omitted, k = 0 is assumed.
  25. #
  26. # See also: tril, diag
  27.  
  28.   if (nargin > 0)
  29.     [nr, nc] = size (x);
  30.     retval = zeros (nr, nc);
  31.   endif
  32.  
  33.   if (nargin == 1)
  34.     k = 0;
  35.   elseif (nargin == 2)
  36.     if ((k > 0 && k > nc) || (k < 0 && k < -nr))
  37.       error ("triu: requested diagonal out of range")
  38.     endif
  39.   else
  40.     usage ("triu (x [, k])");
  41.   endif
  42.  
  43.   for j = max (1, k) : nc
  44.     nr_limit = min (nr, j-k);
  45.     retval (1:nr_limit, j) = x (1:nr_limit, j);
  46.   endfor
  47.  
  48. endfunction
  49.