octave_packages/linear-algebra-2.2.0/@kronprod/rank.m

   1 ## Copyright (C) 2010  Soren Hauberg
   2 ##
   3 ## This program is free software; you can redistribute it and/or modify
   4 ## it under the terms of the GNU General Public License as published by
   5 ## the Free Software Foundation; either version 3, or (at your option)
   6 ## any later version.
   7 ##
   8 ## This program is distributed in the hope that it will be useful, but
   9 ## WITHOUT ANY WARRANTY; without even the implied warranty of
  10 ## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  11 ## General Public License for more details.
  12 ##
  13 ## You should have received a copy of the GNU General Public License
  14 ## along with this file.  If not, see <http://www.gnu.org/licenses/>.
  15
  16 ## -*- texinfo -*-
  17 ## @deftypefn {Function File} rank (@var{KP})
  18 ## Return the rank of the Kronecker product @var{KP}. This is computed as the
  19 ## product of the ranks of the matrices forming the product.
  20 ## @seealso{rank, @@kronprod/det, @@kronprod/trace}
  21 ## @end deftypefn
  22
  23 function retval = rank (KP)
  24   if (nargin != 1)
  25     print_usage ();
  26   endif
  27
  28   if (!isa (KP, "kronprod"))
  29     error ("rank: input must be of class 'kronprod'");
  30   endif
  31
  32   retval = rank (KP.A) * rank (KP.B);
  33 endfunction