annotate main/comm/inst/@galois/convmtx.m @ 9666:67d4cfc5eeb3 octave-forge

comm: update license to GPLv3+
author carandraug
date Tue, 13 Mar 2012 04:31:21 +0000
parents 90a46621a91d
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
8092
90a46621a91d More updates for the communications package for 3.4
adb014
parents:
diff changeset
1 ## Copyright (C) 2003 David Bateman
90a46621a91d More updates for the communications package for 3.4
adb014
parents:
diff changeset
2 ##
9666
67d4cfc5eeb3 comm: update license to GPLv3+
carandraug
parents: 8092
diff changeset
3 ## This program is free software; you can redistribute it and/or modify it under
67d4cfc5eeb3 comm: update license to GPLv3+
carandraug
parents: 8092
diff changeset
4 ## the terms of the GNU General Public License as published by the Free Software
67d4cfc5eeb3 comm: update license to GPLv3+
carandraug
parents: 8092
diff changeset
5 ## Foundation; either version 3 of the License, or (at your option) any later
67d4cfc5eeb3 comm: update license to GPLv3+
carandraug
parents: 8092
diff changeset
6 ## version.
8092
90a46621a91d More updates for the communications package for 3.4
adb014
parents:
diff changeset
7 ##
9666
67d4cfc5eeb3 comm: update license to GPLv3+
carandraug
parents: 8092
diff changeset
8 ## This program is distributed in the hope that it will be useful, but WITHOUT
67d4cfc5eeb3 comm: update license to GPLv3+
carandraug
parents: 8092
diff changeset
9 ## ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
67d4cfc5eeb3 comm: update license to GPLv3+
carandraug
parents: 8092
diff changeset
10 ## FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
67d4cfc5eeb3 comm: update license to GPLv3+
carandraug
parents: 8092
diff changeset
11 ## details.
8092
90a46621a91d More updates for the communications package for 3.4
adb014
parents:
diff changeset
12 ##
9666
67d4cfc5eeb3 comm: update license to GPLv3+
carandraug
parents: 8092
diff changeset
13 ## You should have received a copy of the GNU General Public License along with
67d4cfc5eeb3 comm: update license to GPLv3+
carandraug
parents: 8092
diff changeset
14 ## this program; if not, see <http://www.gnu.org/licenses/>.
8092
90a46621a91d More updates for the communications package for 3.4
adb014
parents:
diff changeset
15
90a46621a91d More updates for the communications package for 3.4
adb014
parents:
diff changeset
16 ## -*- texinfo -*-
90a46621a91d More updates for the communications package for 3.4
adb014
parents:
diff changeset
17 ## @deftypefn {Function File} {} convmtx (@var{a}, @var{n})
90a46621a91d More updates for the communications package for 3.4
adb014
parents:
diff changeset
18 ##
90a46621a91d More updates for the communications package for 3.4
adb014
parents:
diff changeset
19 ## Create matrix to perform repeated convolutions with the same vector
90a46621a91d More updates for the communications package for 3.4
adb014
parents:
diff changeset
20 ## in a Galois Field. If @var{a} is a column vector and @var{x} is a
90a46621a91d More updates for the communications package for 3.4
adb014
parents:
diff changeset
21 ## column vector of length @var{n}, in a Galois Field then
90a46621a91d More updates for the communications package for 3.4
adb014
parents:
diff changeset
22 ##
90a46621a91d More updates for the communications package for 3.4
adb014
parents:
diff changeset
23 ## @code{convmtx(@var{a}, @var{n}) * @var{x}}
90a46621a91d More updates for the communications package for 3.4
adb014
parents:
diff changeset
24 ##
90a46621a91d More updates for the communications package for 3.4
adb014
parents:
diff changeset
25 ## gives the convolution of of @var{a} and @var{x} and is the
90a46621a91d More updates for the communications package for 3.4
adb014
parents:
diff changeset
26 ## same as @code{conv(@var{a}, @var{x})}. The difference is if
90a46621a91d More updates for the communications package for 3.4
adb014
parents:
diff changeset
27 ## many vectors are to be convolved with the same vector, then
90a46621a91d More updates for the communications package for 3.4
adb014
parents:
diff changeset
28 ## this technique is possibly faster.
90a46621a91d More updates for the communications package for 3.4
adb014
parents:
diff changeset
29 ##
90a46621a91d More updates for the communications package for 3.4
adb014
parents:
diff changeset
30 ## Similarly, if @var{a} is a row vector and @var{x} is a row
90a46621a91d More updates for the communications package for 3.4
adb014
parents:
diff changeset
31 ## vector of length @var{n}, then
90a46621a91d More updates for the communications package for 3.4
adb014
parents:
diff changeset
32 ##
90a46621a91d More updates for the communications package for 3.4
adb014
parents:
diff changeset
33 ## @code{@var{x} * convmtx(@var{a}, @var{n})}
90a46621a91d More updates for the communications package for 3.4
adb014
parents:
diff changeset
34 ##
90a46621a91d More updates for the communications package for 3.4
adb014
parents:
diff changeset
35 ## is the same as @code{conv(@var{x}, @var{a})}.
90a46621a91d More updates for the communications package for 3.4
adb014
parents:
diff changeset
36 ## @end deftypefn
90a46621a91d More updates for the communications package for 3.4
adb014
parents:
diff changeset
37 ## @seealso{conv}
90a46621a91d More updates for the communications package for 3.4
adb014
parents:
diff changeset
38
90a46621a91d More updates for the communications package for 3.4
adb014
parents:
diff changeset
39 function b = convmtx (a, n)
90a46621a91d More updates for the communications package for 3.4
adb014
parents:
diff changeset
40
90a46621a91d More updates for the communications package for 3.4
adb014
parents:
diff changeset
41 if (!isgalois (a))
90a46621a91d More updates for the communications package for 3.4
adb014
parents:
diff changeset
42 error("convmtx: argument must be a galois variable");
90a46621a91d More updates for the communications package for 3.4
adb014
parents:
diff changeset
43 endif
90a46621a91d More updates for the communications package for 3.4
adb014
parents:
diff changeset
44
90a46621a91d More updates for the communications package for 3.4
adb014
parents:
diff changeset
45 b = gf(convmtx(a.x,n), a.m, a.prim_poly);
90a46621a91d More updates for the communications package for 3.4
adb014
parents:
diff changeset
46
90a46621a91d More updates for the communications package for 3.4
adb014
parents:
diff changeset
47 endfunction