annotate doc/interpreter/signal.txi @ 9072:bd8e388043c4

Cleanup documentation for signal.texi, image.texi, audio.texi
author Rik <rdrider0-list@yahoo.com>
date Wed, 01 Apr 2009 17:06:45 -0700
parents eb63fbe60fab
children 757efa1d7e2a
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
8920
eb63fbe60fab update copyright notices
John W. Eaton <jwe@octave.org>
parents: 8828
diff changeset
1 @c Copyright (C) 1996, 1997, 1999, 2000, 2002, 2004, 2006, 2007, 2008, 2009
eb63fbe60fab update copyright notices
John W. Eaton <jwe@octave.org>
parents: 8828
diff changeset
2 @c John W. Eaton
7018
fd42779a8428 [project @ 2007-10-13 00:52:12 by jwe]
jwe
parents: 6778
diff changeset
3 @c
fd42779a8428 [project @ 2007-10-13 00:52:12 by jwe]
jwe
parents: 6778
diff changeset
4 @c This file is part of Octave.
fd42779a8428 [project @ 2007-10-13 00:52:12 by jwe]
jwe
parents: 6778
diff changeset
5 @c
fd42779a8428 [project @ 2007-10-13 00:52:12 by jwe]
jwe
parents: 6778
diff changeset
6 @c Octave is free software; you can redistribute it and/or modify it
fd42779a8428 [project @ 2007-10-13 00:52:12 by jwe]
jwe
parents: 6778
diff changeset
7 @c under the terms of the GNU General Public License as published by the
fd42779a8428 [project @ 2007-10-13 00:52:12 by jwe]
jwe
parents: 6778
diff changeset
8 @c Free Software Foundation; either version 3 of the License, or (at
fd42779a8428 [project @ 2007-10-13 00:52:12 by jwe]
jwe
parents: 6778
diff changeset
9 @c your option) any later version.
fd42779a8428 [project @ 2007-10-13 00:52:12 by jwe]
jwe
parents: 6778
diff changeset
10 @c
fd42779a8428 [project @ 2007-10-13 00:52:12 by jwe]
jwe
parents: 6778
diff changeset
11 @c Octave is distributed in the hope that it will be useful, but WITHOUT
fd42779a8428 [project @ 2007-10-13 00:52:12 by jwe]
jwe
parents: 6778
diff changeset
12 @c ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
fd42779a8428 [project @ 2007-10-13 00:52:12 by jwe]
jwe
parents: 6778
diff changeset
13 @c FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
fd42779a8428 [project @ 2007-10-13 00:52:12 by jwe]
jwe
parents: 6778
diff changeset
14 @c for more details.
fd42779a8428 [project @ 2007-10-13 00:52:12 by jwe]
jwe
parents: 6778
diff changeset
15 @c
fd42779a8428 [project @ 2007-10-13 00:52:12 by jwe]
jwe
parents: 6778
diff changeset
16 @c You should have received a copy of the GNU General Public License
fd42779a8428 [project @ 2007-10-13 00:52:12 by jwe]
jwe
parents: 6778
diff changeset
17 @c along with Octave; see the file COPYING. If not, see
fd42779a8428 [project @ 2007-10-13 00:52:12 by jwe]
jwe
parents: 6778
diff changeset
18 @c <http://www.gnu.org/licenses/>.
3294
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe]
jwe
parents:
diff changeset
19
4167
aae05d51353c [project @ 2002-11-12 02:52:50 by jwe]
jwe
parents: 3920
diff changeset
20 @node Signal Processing
3294
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe]
jwe
parents:
diff changeset
21 @chapter Signal Processing
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe]
jwe
parents:
diff changeset
22
8828
8463d1a2e544 Doc fixes.
Brian Gough <bjg@network-theory.co.uk>
parents: 8426
diff changeset
23
9072
bd8e388043c4 Cleanup documentation for signal.texi, image.texi, audio.texi
Rik <rdrider0-list@yahoo.com>
parents: 8920
diff changeset
24 This chapter describes the signal processing and fast Fourier
bd8e388043c4 Cleanup documentation for signal.texi, image.texi, audio.texi
Rik <rdrider0-list@yahoo.com>
parents: 8920
diff changeset
25 transform functions available in Octave. Fast Fourier transforms are
bd8e388043c4 Cleanup documentation for signal.texi, image.texi, audio.texi
Rik <rdrider0-list@yahoo.com>
parents: 8920
diff changeset
26 computed with the @sc{fftw} or @sc{fftpack} libraries depending on how
8828
8463d1a2e544 Doc fixes.
Brian Gough <bjg@network-theory.co.uk>
parents: 8426
diff changeset
27 Octave is built.
8463d1a2e544 Doc fixes.
Brian Gough <bjg@network-theory.co.uk>
parents: 8426
diff changeset
28
8463d1a2e544 Doc fixes.
Brian Gough <bjg@network-theory.co.uk>
parents: 8426
diff changeset
29
8463d1a2e544 Doc fixes.
Brian Gough <bjg@network-theory.co.uk>
parents: 8426
diff changeset
30
3367
0748b03c3510 [project @ 1999-11-20 14:52:38 by jwe]
jwe
parents: 3294
diff changeset
31 @DOCSTRING(detrend)
3294
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe]
jwe
parents:
diff changeset
32
3367
0748b03c3510 [project @ 1999-11-20 14:52:38 by jwe]
jwe
parents: 3294
diff changeset
33 @DOCSTRING(fft)
3294
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe]
jwe
parents:
diff changeset
34
9072
bd8e388043c4 Cleanup documentation for signal.texi, image.texi, audio.texi
Rik <rdrider0-list@yahoo.com>
parents: 8920
diff changeset
35 Octave uses the @sc{fftw} libraries to perform FFT computations. When Octave
bd8e388043c4 Cleanup documentation for signal.texi, image.texi, audio.texi
Rik <rdrider0-list@yahoo.com>
parents: 8920
diff changeset
36 starts up and initializes the @sc{fftw} libraries, they read a system wide
8426
7523742aa026 Add explanation on what wisdom is.
Francesco Potortì <pot@gnu.org>
parents: 7018
diff changeset
37 file (on a Unix system, it is typically @file{/etc/fftw/wisdom}) that
7523742aa026 Add explanation on what wisdom is.
Francesco Potortì <pot@gnu.org>
parents: 7018
diff changeset
38 contains information useful to speed up FFT computations. This
7523742aa026 Add explanation on what wisdom is.
Francesco Potortì <pot@gnu.org>
parents: 7018
diff changeset
39 information is called the @emph{wisdom}. The system-wide file allows
9072
bd8e388043c4 Cleanup documentation for signal.texi, image.texi, audio.texi
Rik <rdrider0-list@yahoo.com>
parents: 8920
diff changeset
40 wisdom to be shared between all applications using the @sc{fftw} libraries.
8426
7523742aa026 Add explanation on what wisdom is.
Francesco Potortì <pot@gnu.org>
parents: 7018
diff changeset
41
7523742aa026 Add explanation on what wisdom is.
Francesco Potortì <pot@gnu.org>
parents: 7018
diff changeset
42 Use the @code{fftw} function to generate and save wisdom. Using the
9072
bd8e388043c4 Cleanup documentation for signal.texi, image.texi, audio.texi
Rik <rdrider0-list@yahoo.com>
parents: 8920
diff changeset
43 utilities provided together with the @sc{fftw} libraries
8426
7523742aa026 Add explanation on what wisdom is.
Francesco Potortì <pot@gnu.org>
parents: 7018
diff changeset
44 (@command{fftw-wisdom} on Unix systems), you can even add wisdom
7523742aa026 Add explanation on what wisdom is.
Francesco Potortì <pot@gnu.org>
parents: 7018
diff changeset
45 generated by Octave to the system-wide wisdom file.
7523742aa026 Add explanation on what wisdom is.
Francesco Potortì <pot@gnu.org>
parents: 7018
diff changeset
46
6549
5a5a09d7deb8 [project @ 2007-04-20 06:55:29 by jwe]
jwe
parents: 6535
diff changeset
47 @DOCSTRING(fftw)
5a5a09d7deb8 [project @ 2007-04-20 06:55:29 by jwe]
jwe
parents: 6535
diff changeset
48
3367
0748b03c3510 [project @ 1999-11-20 14:52:38 by jwe]
jwe
parents: 3294
diff changeset
49 @DOCSTRING(ifft)
3294
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe]
jwe
parents:
diff changeset
50
3367
0748b03c3510 [project @ 1999-11-20 14:52:38 by jwe]
jwe
parents: 3294
diff changeset
51 @DOCSTRING(fft2)
3294
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe]
jwe
parents:
diff changeset
52
3367
0748b03c3510 [project @ 1999-11-20 14:52:38 by jwe]
jwe
parents: 3294
diff changeset
53 @DOCSTRING(ifft2)
3294
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe]
jwe
parents:
diff changeset
54
4773
ccfbd6047a54 [project @ 2004-02-16 19:02:32 by jwe]
jwe
parents: 4167
diff changeset
55 @DOCSTRING(fftn)
ccfbd6047a54 [project @ 2004-02-16 19:02:32 by jwe]
jwe
parents: 4167
diff changeset
56
ccfbd6047a54 [project @ 2004-02-16 19:02:32 by jwe]
jwe
parents: 4167
diff changeset
57 @DOCSTRING(ifftn)
ccfbd6047a54 [project @ 2004-02-16 19:02:32 by jwe]
jwe
parents: 4167
diff changeset
58
3367
0748b03c3510 [project @ 1999-11-20 14:52:38 by jwe]
jwe
parents: 3294
diff changeset
59 @DOCSTRING(fftconv)
3294
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe]
jwe
parents:
diff changeset
60
3367
0748b03c3510 [project @ 1999-11-20 14:52:38 by jwe]
jwe
parents: 3294
diff changeset
61 @DOCSTRING(fftfilt)
3294
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe]
jwe
parents:
diff changeset
62
3367
0748b03c3510 [project @ 1999-11-20 14:52:38 by jwe]
jwe
parents: 3294
diff changeset
63 @DOCSTRING(filter)
3294
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe]
jwe
parents:
diff changeset
64
6549
5a5a09d7deb8 [project @ 2007-04-20 06:55:29 by jwe]
jwe
parents: 6535
diff changeset
65 @DOCSTRING(filter2)
5a5a09d7deb8 [project @ 2007-04-20 06:55:29 by jwe]
jwe
parents: 6535
diff changeset
66
3367
0748b03c3510 [project @ 1999-11-20 14:52:38 by jwe]
jwe
parents: 3294
diff changeset
67 @DOCSTRING(freqz)
3294
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe]
jwe
parents:
diff changeset
68
3920
87db95b22f8f [project @ 2002-05-01 04:07:31 by jwe]
jwe
parents: 3449
diff changeset
69 @DOCSTRING(freqz_plot)
87db95b22f8f [project @ 2002-05-01 04:07:31 by jwe]
jwe
parents: 3449
diff changeset
70
3367
0748b03c3510 [project @ 1999-11-20 14:52:38 by jwe]
jwe
parents: 3294
diff changeset
71 @DOCSTRING(sinc)
3449
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3367
diff changeset
72
3920
87db95b22f8f [project @ 2002-05-01 04:07:31 by jwe]
jwe
parents: 3449
diff changeset
73 @DOCSTRING(unwrap)
87db95b22f8f [project @ 2002-05-01 04:07:31 by jwe]
jwe
parents: 3449
diff changeset
74
5775
ace8d8d26933 [project @ 2006-04-24 19:13:06 by jwe]
jwe
parents: 5041
diff changeset
75 @c FIXME -- someone needs to organize these...
3449
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3367
diff changeset
76
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3367
diff changeset
77 @DOCSTRING(arch_fit)
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3367
diff changeset
78
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3367
diff changeset
79 @DOCSTRING(arch_rnd)
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3367
diff changeset
80
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3367
diff changeset
81 @DOCSTRING(arch_test)
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3367
diff changeset
82
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3367
diff changeset
83 @DOCSTRING(arma_rnd)
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3367
diff changeset
84
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3367
diff changeset
85 @DOCSTRING(autocor)
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3367
diff changeset
86
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3367
diff changeset
87 @DOCSTRING(autocov)
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3367
diff changeset
88
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3367
diff changeset
89 @DOCSTRING(autoreg_matrix)
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3367
diff changeset
90
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3367
diff changeset
91 @DOCSTRING(bartlett)
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3367
diff changeset
92
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3367
diff changeset
93 @DOCSTRING(blackman)
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3367
diff changeset
94
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3367
diff changeset
95 @DOCSTRING(diffpara)
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3367
diff changeset
96
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3367
diff changeset
97 @DOCSTRING(durbinlevinson)
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3367
diff changeset
98
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3367
diff changeset
99 @DOCSTRING(fftshift)
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3367
diff changeset
100
6549
5a5a09d7deb8 [project @ 2007-04-20 06:55:29 by jwe]
jwe
parents: 6535
diff changeset
101 @DOCSTRING(ifftshift)
5a5a09d7deb8 [project @ 2007-04-20 06:55:29 by jwe]
jwe
parents: 6535
diff changeset
102
3449
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3367
diff changeset
103 @DOCSTRING(fractdiff)
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3367
diff changeset
104
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3367
diff changeset
105 @DOCSTRING(hamming)
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3367
diff changeset
106
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3367
diff changeset
107 @DOCSTRING(hanning)
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3367
diff changeset
108
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3367
diff changeset
109 @DOCSTRING(hurst)
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3367
diff changeset
110
6549
5a5a09d7deb8 [project @ 2007-04-20 06:55:29 by jwe]
jwe
parents: 6535
diff changeset
111 @DOCSTRING(pchip)
5a5a09d7deb8 [project @ 2007-04-20 06:55:29 by jwe]
jwe
parents: 6535
diff changeset
112
3449
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3367
diff changeset
113 @DOCSTRING(periodogram)
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3367
diff changeset
114
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3367
diff changeset
115 @DOCSTRING(rectangle_lw)
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3367
diff changeset
116
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3367
diff changeset
117 @DOCSTRING(rectangle_sw)
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3367
diff changeset
118
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3367
diff changeset
119 @DOCSTRING(sinetone)
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3367
diff changeset
120
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3367
diff changeset
121 @DOCSTRING(sinewave)
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3367
diff changeset
122
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3367
diff changeset
123 @DOCSTRING(spectral_adf)
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3367
diff changeset
124
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3367
diff changeset
125 @DOCSTRING(spectral_xdf)
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3367
diff changeset
126
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3367
diff changeset
127 @DOCSTRING(spencer)
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3367
diff changeset
128
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3367
diff changeset
129 @DOCSTRING(stft)
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3367
diff changeset
130
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3367
diff changeset
131 @DOCSTRING(synthesis)
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3367
diff changeset
132
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3367
diff changeset
133 @DOCSTRING(triangle_lw)
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3367
diff changeset
134
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3367
diff changeset
135 @DOCSTRING(triangle_sw)
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3367
diff changeset
136
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3367
diff changeset
137 @DOCSTRING(yulewalker)