This file is indexed.

/usr/share/octave/packages/signal-1.3.2/flattopwin.m is in octave-signal 1.3.2-1.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
## Author: Paul Kienzle <pkienzle@users.sf.net> (2004)
## This program is granted to the public domain.

## -*- texinfo -*-
## @deftypefn  {Function File} {} flattopwin (@var{m})
## @deftypefnx {Function File} {} flattopwin (@var{m}, "periodic")
## @deftypefnx {Function File} {} flattopwin (@var{m}, "symmetric")
##
## Return the filter coefficients of a Flat Top window of length @var{m}.
## The Flat Top window is defined by the function f(w):
##
## @example
## @group
##   f(w) = 1 - 1.93 cos(2 pi w) + 1.29 cos(4 pi w)
##            - 0.388 cos(6 pi w) + 0.0322cos(8 pi w)
## @end group
## @end example
##
## where w = i/(m-1) for i=0:m-1 for a symmetric window, or
## w = i/m for i=0:m-1 for a periodic window.  The default
## is symmetric.  The returned window is normalized to a peak
## of 1 at w = 0.5.
##
## This window has low pass-band ripple, but high bandwidth.
##
## According to [1]:
##
##    The main use for the Flat Top window is for calibration, due
##    to its negligible amplitude errors.
##
## [1] Gade, S; Herlufsen, H; (1987) "Use of weighting functions in DFT/FFT
## analysis (Part I)", Bruel & Kjaer Technical Review No.3.
## @end deftypefn

function w = flattopwin (m, opt)

  if (nargin < 1 || nargin > 2)
    print_usage ();
  elseif (! (isscalar (m) && (m == fix (m)) && (m > 0)))
    error ("flattopwin: M must be a positive integer");
  endif

  N = m - 1;
  if (nargin == 2)
    switch (opt)
      case "periodic"
        N = m;
      case "symmetric"
        N = m - 1;
      otherwise
        error ("flattopwin: window type must be either \"periodic\" or \"symmetric\"");
    endswitch
  endif

  if (m == 1)
    w = 1;
  else
    x = 2*pi*[0:m-1]'/N;
    w = (1-1.93*cos(x)+1.29*cos(2*x)-0.388*cos(3*x)+0.0322*cos(4*x))/4.6402;
  endif

endfunction

%!assert (flattopwin (1), 1);
%!assert (flattopwin (2), 0.0042 / 4.6402 * ones (2, 1), eps);
%!assert (flattopwin (15), flipud (flattopwin (15)), 10*eps);
%!assert (flattopwin (16), flipud (flattopwin (16)), 10*eps);

%!assert (flattopwin (15), flattopwin (15, "symmetric"));
%!assert (flattopwin (16)(1:15), flattopwin (15, "periodic"));

%% Test input validation
%!error flattopwin ()
%!error flattopwin (0.5)
%!error flattopwin (-1)
%!error flattopwin (ones (1, 4))
%!error flattopwin (1, 2)
%!error flattopwin (1, 2, 3)
%!error flattopwin (1, "invalid")