Mercurial > octave
annotate scripts/signal/hanning.m @ 27923:bd51beb6205e
update formatting of copyright notices
* Use <https://octave.org/copyright/> instead of
<https://octave.org/COPYRIGHT.html/>.
* For consistency with other comments in the Octave sources, use
C++-style comments for copyright blocks in C and C++ files.
* Use delimiters above and below copyright blocks that are appropriate
for the language used in the file.
* Eliminate extra spacing inside copyright blocks.
* lex.ll (looks_like_copyright): Also allow newlines and carriage
returns before the word "Copyright".
* scripts/mk-doc.pl (gethelp): Also skip empty comment lines.
* bp-table.cc, type.m: Adjust tests.
author | John W. Eaton <jwe@octave.org> |
---|---|
date | Wed, 08 Jan 2020 11:59:41 -0500 |
parents | 1891570abac8 |
children | b09432b20a84 |
rev | line source |
---|---|
27923
bd51beb6205e
update formatting of copyright notices
John W. Eaton <jwe@octave.org>
parents:
27919
diff
changeset
|
1 ######################################################################## |
bd51beb6205e
update formatting of copyright notices
John W. Eaton <jwe@octave.org>
parents:
27919
diff
changeset
|
2 ## |
27919
1891570abac8
update Octave Project Developers copyright for the new year
John W. Eaton <jwe@octave.org>
parents:
27918
diff
changeset
|
3 ## Copyright (C) 1995-2020 The Octave Project Developers |
27918
b442ec6dda5c
use centralized file for copyright info for individual contributors
John W. Eaton <jwe@octave.org>
parents:
26376
diff
changeset
|
4 ## |
27923
bd51beb6205e
update formatting of copyright notices
John W. Eaton <jwe@octave.org>
parents:
27919
diff
changeset
|
5 ## See the file COPYRIGHT.md in the top-level directory of this |
bd51beb6205e
update formatting of copyright notices
John W. Eaton <jwe@octave.org>
parents:
27919
diff
changeset
|
6 ## distribution or <https://octave.org/copyright/>. |
3426 | 7 ## |
3922 | 8 ## This file is part of Octave. |
9 ## | |
24534
194eb4bd202b
maint: Update punctuation for GPL v3 license text.
Rik <rik@octave.org>
parents:
23220
diff
changeset
|
10 ## Octave is free software: you can redistribute it and/or modify it |
3922 | 11 ## under the terms of the GNU General Public License as published by |
24534
194eb4bd202b
maint: Update punctuation for GPL v3 license text.
Rik <rik@octave.org>
parents:
23220
diff
changeset
|
12 ## the Free Software Foundation, either version 3 of the License, or |
22755
3a2b891d0b33
maint: Standardize Copyright formatting.
Rik <rik@octave.org>
parents:
22323
diff
changeset
|
13 ## (at your option) any later version. |
3426 | 14 ## |
3922 | 15 ## Octave is distributed in the hope that it will be useful, but |
3191 | 16 ## WITHOUT ANY WARRANTY; without even the implied warranty of |
22755
3a2b891d0b33
maint: Standardize Copyright formatting.
Rik <rik@octave.org>
parents:
22323
diff
changeset
|
17 ## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
3a2b891d0b33
maint: Standardize Copyright formatting.
Rik <rik@octave.org>
parents:
22323
diff
changeset
|
18 ## GNU General Public License for more details. |
3426 | 19 ## |
3191 | 20 ## You should have received a copy of the GNU General Public License |
7016 | 21 ## along with Octave; see the file COPYING. If not, see |
24534
194eb4bd202b
maint: Update punctuation for GPL v3 license text.
Rik <rik@octave.org>
parents:
23220
diff
changeset
|
22 ## <https://www.gnu.org/licenses/>. |
27923
bd51beb6205e
update formatting of copyright notices
John W. Eaton <jwe@octave.org>
parents:
27919
diff
changeset
|
23 ## |
bd51beb6205e
update formatting of copyright notices
John W. Eaton <jwe@octave.org>
parents:
27919
diff
changeset
|
24 ######################################################################## |
3191 | 25 |
3449 | 26 ## -*- texinfo -*- |
20852
516bb87ea72e
2015 Code Sprint: remove class of function from docstring for all m-files.
Rik <rik@octave.org>
parents:
20231
diff
changeset
|
27 ## @deftypefn {} {} hanning (@var{m}) |
516bb87ea72e
2015 Code Sprint: remove class of function from docstring for all m-files.
Rik <rik@octave.org>
parents:
20231
diff
changeset
|
28 ## @deftypefnx {} {} hanning (@var{m}, "periodic") |
516bb87ea72e
2015 Code Sprint: remove class of function from docstring for all m-files.
Rik <rik@octave.org>
parents:
20231
diff
changeset
|
29 ## @deftypefnx {} {} hanning (@var{m}, "symmetric") |
3449 | 30 ## Return the filter coefficients of a Hanning window of length @var{m}. |
3191 | 31 ## |
19826
26fb4bfa4193
blackman, hamming, hanning: Add periodic window option (bug #43305)
Mike Miller <mtmiller@ieee.org>
parents:
19697
diff
changeset
|
32 ## If the optional argument @qcode{"periodic"} is given, the periodic form |
26fb4bfa4193
blackman, hamming, hanning: Add periodic window option (bug #43305)
Mike Miller <mtmiller@ieee.org>
parents:
19697
diff
changeset
|
33 ## of the window is returned. This is equivalent to the window of length |
26fb4bfa4193
blackman, hamming, hanning: Add periodic window option (bug #43305)
Mike Miller <mtmiller@ieee.org>
parents:
19697
diff
changeset
|
34 ## @var{m}+1 with the last coefficient removed. The optional argument |
26fb4bfa4193
blackman, hamming, hanning: Add periodic window option (bug #43305)
Mike Miller <mtmiller@ieee.org>
parents:
19697
diff
changeset
|
35 ## @qcode{"symmetric"} is equivalent to not specifying a second argument. |
26fb4bfa4193
blackman, hamming, hanning: Add periodic window option (bug #43305)
Mike Miller <mtmiller@ieee.org>
parents:
19697
diff
changeset
|
36 ## |
20165
f1d0f506ee78
doc: Update more docstrings to have one sentence summary as first line.
Rik <rik@octave.org>
parents:
20026
diff
changeset
|
37 ## For a definition of the Hanning window see, e.g., |
19040
0850b5212619
doc: Add @nospell macro around proper names in documentation.
Rik <rik@octave.org>
parents:
17744
diff
changeset
|
38 ## @nospell{A.V. Oppenheim & R. W. Schafer}, |
0850b5212619
doc: Add @nospell macro around proper names in documentation.
Rik <rik@octave.org>
parents:
17744
diff
changeset
|
39 ## @cite{Discrete-Time Signal Processing}. |
3449 | 40 ## @end deftypefn |
3426 | 41 |
3457 | 42 ## Author: AW <Andreas.Weingessel@ci.tuwien.ac.at> |
43 ## Description: Coefficients of the Hanning window | |
3191 | 44 |
19826
26fb4bfa4193
blackman, hamming, hanning: Add periodic window option (bug #43305)
Mike Miller <mtmiller@ieee.org>
parents:
19697
diff
changeset
|
45 function c = hanning (m, opt) |
3426 | 46 |
19826
26fb4bfa4193
blackman, hamming, hanning: Add periodic window option (bug #43305)
Mike Miller <mtmiller@ieee.org>
parents:
19697
diff
changeset
|
47 if (nargin < 1 || nargin > 2) |
6046 | 48 print_usage (); |
3191 | 49 endif |
3426 | 50 |
13279
984359717d71
Use common code idiom for checking whether a double value is an integer.
Rik <octave@nomad.inbox5.com>
parents:
13055
diff
changeset
|
51 if (! (isscalar (m) && (m == fix (m)) && (m > 0))) |
19826
26fb4bfa4193
blackman, hamming, hanning: Add periodic window option (bug #43305)
Mike Miller <mtmiller@ieee.org>
parents:
19697
diff
changeset
|
52 error ("hanning: M must be a positive integer"); |
26fb4bfa4193
blackman, hamming, hanning: Add periodic window option (bug #43305)
Mike Miller <mtmiller@ieee.org>
parents:
19697
diff
changeset
|
53 endif |
26fb4bfa4193
blackman, hamming, hanning: Add periodic window option (bug #43305)
Mike Miller <mtmiller@ieee.org>
parents:
19697
diff
changeset
|
54 |
20026
230c1e2a678d
blackman, hamming, hanning: Simplify handling of periodic window option
Mike Miller <mtmiller@octave.org>
parents:
20025
diff
changeset
|
55 N = m - 1; |
19826
26fb4bfa4193
blackman, hamming, hanning: Add periodic window option (bug #43305)
Mike Miller <mtmiller@ieee.org>
parents:
19697
diff
changeset
|
56 if (nargin == 2) |
26fb4bfa4193
blackman, hamming, hanning: Add periodic window option (bug #43305)
Mike Miller <mtmiller@ieee.org>
parents:
19697
diff
changeset
|
57 switch (opt) |
26fb4bfa4193
blackman, hamming, hanning: Add periodic window option (bug #43305)
Mike Miller <mtmiller@ieee.org>
parents:
19697
diff
changeset
|
58 case "periodic" |
20026
230c1e2a678d
blackman, hamming, hanning: Simplify handling of periodic window option
Mike Miller <mtmiller@octave.org>
parents:
20025
diff
changeset
|
59 N = m; |
19826
26fb4bfa4193
blackman, hamming, hanning: Add periodic window option (bug #43305)
Mike Miller <mtmiller@ieee.org>
parents:
19697
diff
changeset
|
60 case "symmetric" |
26fb4bfa4193
blackman, hamming, hanning: Add periodic window option (bug #43305)
Mike Miller <mtmiller@ieee.org>
parents:
19697
diff
changeset
|
61 ## Default option, same as no option specified. |
26fb4bfa4193
blackman, hamming, hanning: Add periodic window option (bug #43305)
Mike Miller <mtmiller@ieee.org>
parents:
19697
diff
changeset
|
62 otherwise |
26fb4bfa4193
blackman, hamming, hanning: Add periodic window option (bug #43305)
Mike Miller <mtmiller@ieee.org>
parents:
19697
diff
changeset
|
63 error ('hanning: window type must be either "periodic" or "symmetric"'); |
26fb4bfa4193
blackman, hamming, hanning: Add periodic window option (bug #43305)
Mike Miller <mtmiller@ieee.org>
parents:
19697
diff
changeset
|
64 endswitch |
3191 | 65 endif |
3426 | 66 |
3191 | 67 if (m == 1) |
68 c = 1; | |
69 else | |
20231
83792dd9bcc1
Use in-place operators in m-files where possible.
Rik <rik@octave.org>
parents:
20165
diff
changeset
|
70 m -= 1; |
20026
230c1e2a678d
blackman, hamming, hanning: Simplify handling of periodic window option
Mike Miller <mtmiller@octave.org>
parents:
20025
diff
changeset
|
71 c = 0.5 - 0.5 * cos (2 * pi * (0 : m)' / N); |
19826
26fb4bfa4193
blackman, hamming, hanning: Add periodic window option (bug #43305)
Mike Miller <mtmiller@ieee.org>
parents:
19697
diff
changeset
|
72 endif |
26fb4bfa4193
blackman, hamming, hanning: Add periodic window option (bug #43305)
Mike Miller <mtmiller@ieee.org>
parents:
19697
diff
changeset
|
73 |
3191 | 74 endfunction |
13055
4e95529cbc51
codesprint: 9 tests for hanning.m
Andriy Shinkarchuck <adriano32.gnu@gmail.com>
parents:
11523
diff
changeset
|
75 |
14363
f3d52523cde1
Use Octave coding conventions in all m-file %!test blocks
Rik <octave@nomad.inbox5.com>
parents:
14138
diff
changeset
|
76 |
21317
a4faec57f4c8
maint: remove semicolon after %!assert tests to follow Octave conventions.
Rik <rik@octave.org>
parents:
20852
diff
changeset
|
77 %!assert (hanning (1), 1) |
a4faec57f4c8
maint: remove semicolon after %!assert tests to follow Octave conventions.
Rik <rik@octave.org>
parents:
20852
diff
changeset
|
78 %!assert (hanning (2), zeros (2,1)) |
a4faec57f4c8
maint: remove semicolon after %!assert tests to follow Octave conventions.
Rik <rik@octave.org>
parents:
20852
diff
changeset
|
79 %!assert (hanning (15), flip (hanning (15)), 5*eps) |
a4faec57f4c8
maint: remove semicolon after %!assert tests to follow Octave conventions.
Rik <rik@octave.org>
parents:
20852
diff
changeset
|
80 %!assert (hanning (16), flip (hanning (16)), 5*eps) |
13055
4e95529cbc51
codesprint: 9 tests for hanning.m
Andriy Shinkarchuck <adriano32.gnu@gmail.com>
parents:
11523
diff
changeset
|
81 %!test |
4e95529cbc51
codesprint: 9 tests for hanning.m
Andriy Shinkarchuck <adriano32.gnu@gmail.com>
parents:
11523
diff
changeset
|
82 %! N = 15; |
4e95529cbc51
codesprint: 9 tests for hanning.m
Andriy Shinkarchuck <adriano32.gnu@gmail.com>
parents:
11523
diff
changeset
|
83 %! A = hanning (N); |
14363
f3d52523cde1
Use Octave coding conventions in all m-file %!test blocks
Rik <octave@nomad.inbox5.com>
parents:
14138
diff
changeset
|
84 %! assert (A(ceil (N/2)), 1); |
13055
4e95529cbc51
codesprint: 9 tests for hanning.m
Andriy Shinkarchuck <adriano32.gnu@gmail.com>
parents:
11523
diff
changeset
|
85 |
21317
a4faec57f4c8
maint: remove semicolon after %!assert tests to follow Octave conventions.
Rik <rik@octave.org>
parents:
20852
diff
changeset
|
86 %!assert (hanning (15), hanning (15, "symmetric")) |
a4faec57f4c8
maint: remove semicolon after %!assert tests to follow Octave conventions.
Rik <rik@octave.org>
parents:
20852
diff
changeset
|
87 %!assert (hanning (16)(1:15), hanning (15, "periodic")) |
19826
26fb4bfa4193
blackman, hamming, hanning: Add periodic window option (bug #43305)
Mike Miller <mtmiller@ieee.org>
parents:
19697
diff
changeset
|
88 %!test |
26fb4bfa4193
blackman, hamming, hanning: Add periodic window option (bug #43305)
Mike Miller <mtmiller@ieee.org>
parents:
19697
diff
changeset
|
89 %! N = 16; |
26fb4bfa4193
blackman, hamming, hanning: Add periodic window option (bug #43305)
Mike Miller <mtmiller@ieee.org>
parents:
19697
diff
changeset
|
90 %! A = hanning (N, "periodic"); |
20025
d209fbae38ae
Fix tests for bartlett, blackman, hamming, and hanning
Mike Miller <mtmiller@octave.org>
parents:
19826
diff
changeset
|
91 %! assert (A(N/2 + 1), 1); |
19826
26fb4bfa4193
blackman, hamming, hanning: Add periodic window option (bug #43305)
Mike Miller <mtmiller@ieee.org>
parents:
19697
diff
changeset
|
92 |
14363
f3d52523cde1
Use Octave coding conventions in all m-file %!test blocks
Rik <octave@nomad.inbox5.com>
parents:
14138
diff
changeset
|
93 %!error hanning () |
f3d52523cde1
Use Octave coding conventions in all m-file %!test blocks
Rik <octave@nomad.inbox5.com>
parents:
14138
diff
changeset
|
94 %!error hanning (0.5) |
f3d52523cde1
Use Octave coding conventions in all m-file %!test blocks
Rik <octave@nomad.inbox5.com>
parents:
14138
diff
changeset
|
95 %!error hanning (-1) |
14868
5d3a684236b0
maint: Use Octave coding conventions for cuddling parentheses in scripts directory
Rik <octave@nomad.inbox5.com>
parents:
14363
diff
changeset
|
96 %!error hanning (ones (1,4)) |
21581
6fab85c1538f
maint: Follow Octave conventions for use of semicolon in BIST tests.
Rik <rik@octave.org>
parents:
21317
diff
changeset
|
97 %!error hanning (1, "invalid") |