Go to the first, previous, next, last section, table of contents.

The `fft`

package comprises functions for the numerical (not symbolic) computation
of the fast Fourier transform.
`load ("fft")`

loads this package.
See `fft`

.

The `fourie`

package comprises functions for the symbolic computation
of Fourier series.
`load ("fourie")`

loads this package.
There are functions in the `fourie`

package to calculate Fourier integral
coefficients and some functions for manipulation of expressions.
See `Definitions for Fourier Series`

.

__Function:__**polartorect***(*`magnitude_array`,`phase_array`)-
Translates complex values of the form

`r %e^(%i t)`

to the form`a + b %i`

.`load ("fft")`

loads this function into Maxima. See also`fft`

.The magnitude and phase,

`r`

and`t`

, are taken from`magnitude_array`and`phase_array`, respectively. The original values of the input arrays are replaced by the real and imaginary parts,`a`

and`b`

, on return. The outputs are calculated asa: r cos (t) b: r sin (t)

The input arrays must be the same size and 1-dimensional. The array size need not be a power of 2.

`polartorect`

is the inverse function of`recttopolar`

.

__Function:__**recttopolar***(*`real_array`,`imaginary_array`)-
Translates complex values of the form

`a + b %i`

to the form`r %e^(%i t)`

.`load ("fft")`

loads this function into Maxima. See also`fft`

.The real and imaginary parts,

`a`

and`b`

, are taken from`real_array`and`imaginary_array`, respectively. The original values of the input arrays are replaced by the magnitude and angle,`r`

and`t`

, on return. The outputs are calculated asr: sqrt (a^2 + b^2) t: atan2 (b, a)

The computed angle is in the range

`-%pi`

to`%pi`

.The input arrays must be the same size and 1-dimensional. The array size need not be a power of 2.

`recttopolar`

is the inverse function of`polartorect`

.

__Function:__**ift***(*`real_array`,`imaginary_array`)-
Fast inverse discrete Fourier transform.

`load ("fft")`

loads this function into Maxima.`ift`

carries out the inverse complex fast Fourier transform on 1-dimensional floating point arrays. The inverse transform is defined asx[j]: sum (y[j] exp (+2 %i %pi j k / n), k, 0, n-1)

See

`fft`

for more details.

__Function:__**fft***(*`real_array`,`imaginary_array`)__Function:__**ift***(*`real_array`,`imaginary_array`)__Function:__**recttopolar***(*`real_array`,`imaginary_array`)__Function:__**polartorect***(*`magnitude_array`,`phase_array`)-
Fast Fourier transform and related functions.

`load ("fft")`

loads these functions into Maxima.`fft`

and`ift`

carry out the complex fast Fourier transform and inverse transform, respectively, on 1-dimensional floating point arrays. The size of`imaginary_array`must equal the size of`real_array`.`fft`

and`ift`

operate in-place. That is, on return from`fft`

or`ift`

, the original content of the input arrays is replaced by the output. The`fillarray`

function can make a copy of an array, should it be necessary.The discrete Fourier transform and inverse transform are defined as follows. Let

`x`

be the original data, withx[i]: real_array[i] + %i imaginary_array[i]

Let

`y`

be the transformed data. The forward and inverse transforms arey[k]: (1/n) sum (x[j] exp (-2 %i %pi j k / n), j, 0, n-1) x[j]: sum (y[j] exp (+2 %i %pi j k / n), k, 0, n-1)

Suitable arrays can be allocated by the

`array`

function. For example:array (my_array, float, n-1)$

declares a 1-dimensional array with n elements, indexed from 0 through n-1 inclusive. The number of elements n must be equal to 2^m for some m.

`fft`

can be applied to real data (imaginary array all zeros) to obtain sine and cosine coefficients. After calling`fft`

, the sine and cosine coefficients, say`a`

and`b`

, can be calculated asa[0]: real_array[0] b[0]: 0

and

a[j]: real_array[j] + real_array[n-j] b[j]: imaginary_array[j] - imaginary_array[n-j]

for j equal to 1 through n/2-1, and

a[n/2]: real_array[n/2] b[n/2]: 0

`recttopolar`

translates complex values of the form`a + b %i`

to the form`r %e^(%i t)`

. See`recttopolar`

.`polartorect`

translates complex values of the form`r %e^(%i t)`

to the form`a + b %i`

. See`polartorect`

.`demo ("fft")`

displays a demonstration of the`fft`

package.

__Option variable:__**fortindent**-
Default value: 0
`fortindent`

controls the left margin indentation of expressions printed out by the`fortran`

command. 0 gives normal printout (i.e., 6 spaces), and positive values will causes the expressions to be printed farther to the right.

__Function:__**fortran***(*`expr`)-
Prints
`expr`as a Fortran statement. The output line is indented with spaces. If the line is too long,`fortran`

prints continuation lines.`fortran`

prints the exponentiation operator`^`

as`**`

, and prints a complex number`a + b %i`

in the form`(a,b)`

.`expr`may be an equation. If so,`fortran`

prints an assignment statement, assigning the right-hand side of the equation to the left-hand side. In particular, if the right-hand side of`expr`is the name of a matrix, then`fortran`

prints an assignment statement for each element of the matrix.If

`expr`is not something recognized by`fortran`

, the expression is printed in`grind`

format without complaint.`fortran`

does not know about lists, arrays, or functions.`fortindent`

controls the left margin of the printed lines. 0 is the normal margin (i.e., indented 6 spaces). Increasing`fortindent`

causes expressions to be printed further to the right.When

`fortspaces`

is`true`

,`fortran`

fills out each printed line with spaces to 80 columns.`fortran`

evaluates its arguments; quoting an argument defeats evaluation.`fortran`

always returns`done`

.Examples:

(%i1) expr: (a + b)^12$ (%i2) fortran (expr); (b+a)**12 (%o2) done (%i3) fortran ('x=expr); x = (b+a)**12 (%o3) done (%i4) fortran ('x=expand (expr)); x = b**12+12*a*b**11+66*a**2*b**10+220*a**3*b**9+495*a**4*b**8+792 1 *a**5*b**7+924*a**6*b**6+792*a**7*b**5+495*a**8*b**4+220*a**9*b 2 **3+66*a**10*b**2+12*a**11*b+a**12 (%o4) done (%i5) fortran ('x=7+5*%i); x = (7,5) (%o5) done (%i6) fortran ('x=[1,2,3,4]); x = [1,2,3,4] (%o6) done (%i7) f(x) := x^2$ (%i8) fortran (f); f (%o8) done

__Option variable:__**fortspaces**-
Default value:
`false`

When

`fortspaces`

is`true`

,`fortran`

fills out each printed line with spaces to 80 columns.

__Function:__**horner***(*`expr`,`x`)__Function:__**horner***(*`expr`)-
Returns a rearranged representation of
`expr`as in Horner's rule, using`x`as the main variable if it is specified.`x`

may be omitted in which case the main variable of the canonical rational expression form of`expr`is used.`horner`

sometimes improves stability if`expr`

is to be numerically evaluated. It is also useful if Maxima is used to generate programs to be run in Fortran. See also`stringout`

.(%i1) expr: 1e-155*x^2 - 5.5*x + 5.2e155; 2 (%o1) 1.0E-155 x - 5.5 x + 5.2E+155 (%i2) expr2: horner (%, x), keepfloat: true; (%o2) (1.0E-155 x - 5.5) x + 5.2E+155 (%i3) ev (expr, x=1e155); Maxima encountered a Lisp error: floating point overflow Automatically continuing. To reenable the Lisp debugger set *debugger-hook* to nil. (%i4) ev (expr2, x=1e155); (%o4) 7.0E+154

__Function:__**interpolate***(*`f`(`x`),`x`,`a`,`b`)__Function:__**interpolate***(*`f`,`a`,`b`)-
Finds the zero of function
`f`as variable`x`varies over the range`[`

. The function must have a different sign at each endpoint. If this condition is not met, the action of the function is governed by`a`,`b`]`intpolerror`

. If`intpolerror`

is`true`

then an error occurs, otherwise the value of`intpolerror`

is returned (thus for plotting`intpolerror`

might be set to 0.0). Otherwise (given that Maxima can evaluate the first argument in the specified range, and that it is continuous)`interpolate`

is guaranteed to come up with the zero (or one of them if there is more than one zero). The accuracy of`interpolate`

is governed by`intpolabs`

and`intpolrel`

which must be non-negative floating point numbers.`interpolate`

will stop when the first arg evaluates to something less than or equal to`intpolabs`

or if successive approximants to the root differ by no more than`intpolrel * <one of the approximants>`

. The default values of`intpolabs`

and`intpolrel`

are 0.0 so`interpolate`

gets as good an answer as is possible with the single precision arithmetic we have. The first arg may be an equation. The order of the last two args is irrelevant. Thusinterpolate (sin(x) = x/2, x, %pi, 0.1);

is equivalent to

interpolate (sin(x) = x/2, x, 0.1, %pi);

The method used is a binary search in the range specified by the last two args. When it thinks the function is close enough to being linear, it starts using linear interpolation.

(%i1) f(x) := sin(x) - x/2; x (%o1) f(x) := sin(x) - - 2 (%i2) interpolate (sin(x) - x/2, x, 0.1, %pi); (%o2) 1.895494267033981 (%i3) interpolate (sin(x) = x/2, x, 0.1, %pi); (%o3) 1.895494267033981 (%i4) interpolate (f(x), x, 0.1, %pi); (%o4) 1.895494267033981 (%i5) interpolate (f, 0.1, %pi); (%o5) 1.895494267033981

There is also a Newton method interpolation routine. See

`newton`

.

__Option variable:__**intpolabs**-
Default value: 0.0
`intpolabs`

is the accuracy of the`interpolate`

command is governed by`intpolabs`

and`intpolrel`

which must be non-negative floating point numbers.`interpolate`

will stop when the first arg evaluates to something less than or equal to`intpolabs`

or if successive approximants to the root differ by no more than`intpolrel * <one of the approximants>`

. The default values of`intpolabs`

and`intpolrel`

are 0.0 so`interpolate`

gets as good an answer as is possible with the single precision arithmetic we have.

__Option variable:__**intpolerror**-
Default value:
`true`

`intpolerror`

governs the behavior of`interpolate`

. When`interpolate`

is called, it determines whether or not the function to be interpolated satisfies the condition that the values of the function at the endpoints of the interpolation interval are opposite in sign. If they are of opposite sign, the interpolation proceeds. If they are of like sign, and`intpolerror`

is`true`

, then an error is signaled. If they are of like sign and`intpolerror`

is not`true`

, the value of`intpolerror`

is returned. Thus for plotting,`intpolerror`

might be set to 0.0.

__Option variable:__**intpolrel**-
Default value: 0.0
`intpolrel`

is the accuracy of the`interpolate`

command is governed by`intpolabs`

and`intpolrel`

which must be non-negative floating point numbers.`interpolate`

will stop when the first arg evaluates to something less than or equal to`intpolabs`

or if successive approximants to the root differ by no more than`intpolrel * <one of the approximants>`

. The default values of`intpolabs`

and`intpolrel`

are 0.0 so`interpolate`

gets as good an answer as is possible with the single precision arithmetic we have.

__Function:__**newton***(*`expr`,`x`,`x_0`,`eps`)-
Interpolation by Newton's method.
`load ("newton1")`

loads this function.`newton`

can handle some expressions that`interpolate`

refuses to handle, since`interpolate`

requires that everything evaluate to a floating point number. Thus`newton (x^2 - a^2, x, a/2, a^2/100)`

complains that it can't tell if`6.098490481853958E-4 a^2 < a^2/100`

. After`assume (a>0)`

, the same function call succeeds, yielding a symbolic result,`1.00030487804878 a`

.On the other hand,

`interpolate (x^2 - a^2, x, a/2, 2*a)`

complains that`0.5 a`

is not a floating point number.An adaptive integrator which uses the Newton-Cotes 8 panel quadrature rule is available. See

`qq`

.

__Function:__**equalp***(*`x`,`y`)-
Returns
`true`

if`equal (`

otherwise`x`,`y`)`false`

(doesn't give an error message like`equal (x, y)`

would do in this case).

__Function:__**remfun***(*`f`,`expr`)__Function:__**remfun***(*`f`,`expr`,`x`)-
`remfun (`

replaces all occurrences of`f`,`expr`)

by`f`(`arg`)`arg`in`expr`.`remfun (`

replaces all occurrences of`f`,`expr`,`x`)

by`f`(`arg`)`arg`in`expr`only if`arg`contains the variable`x`.

__Function:__**funp***(*`f`,`expr`)__Function:__**funp***(*`f`,`expr`,`x`)-
`funp (`

returns`f`,`expr`)`true`

if`expr`contains the function`f`.`funp (`

returns`f`,`expr`,`x`)`true`

if`expr`contains the function`f`and the variable`x`is somewhere in the argument of one of the instances of`f`.

__Function:__**absint***(*`f`,`x`,`halfplane`)__Function:__**absint***(*`f`,`x`)__Function:__**absint***(*`f`,`x`,`a`,`b`)-
`absint (`

returns the indefinite integral of`f`,`x`,`halfplane`)`f`with respect to`x`in the given halfplane (`pos`

,`neg`

, or`both`

).`f`may contain expressions of the form`abs (x)`

,`abs (sin (x))`

,`abs (a) * exp (-abs (b) * abs (x))`

.`absint (`

is equivalent to`f`,`x`)`absint (`

.`f`,`x`, pos)`absint (`

returns the definite integral of`f`,`x`,`a`,`b`)`f`with respect to`x`from`a`to`b`.`f`may include absolute values.

__Function:__**fourier***(*`f`,`x`,`p`)-
Returns a list of the Fourier coefficients of

defined on the interval`f`(`x`)`[-%pi, %pi]`

.

__Function:__**foursimp***(*`l`)-
Simplifies
`sin (n %pi)`

to 0 if`sinnpiflag`

is`true`

and`cos (n %pi)`

to`(-1)^n`

if`cosnpiflag`

is`true`

.

__Option variable:__**sinnpiflag**-
Default value:
`true`

See

`foursimp`

.

__Option variable:__**cosnpiflag**-
Default value:
`true`

See

`foursimp`

.

__Function:__**fourexpand***(*`l`,`x`,`p`,`limit`)-
Constructs and returns the Fourier series from the list of
Fourier coefficients
`l`up through`limit`terms (`limit`may be`inf`

).`x`and`p`have same meaning as in`fourier`

.

__Function:__**fourcos***(*`f`,`x`,`p`)-
Returns the Fourier cosine coefficients for

defined on`f`(`x`)`[0, %pi]`

.

__Function:__**foursin***(*`f`,`x`,`p`)-
Returns the Fourier sine coefficients for

defined on`f`(`x`)`[0, %pi]`

.

__Function:__**totalfourier***(*`f`,`x`,`p`)-
Returns
`fourexpand (foursimp (fourier (`

.`f`,`x`,`p`)),`x`,`p`, 'inf)

__Function:__**fourint***(*`f`,`x`)-
Constructs and returns a list of the Fourier integral coefficients of

defined on`f`(`x`)`[minf, inf]`

.

__Function:__**fourintcos***(*`f`,`x`)-
Returns the Fourier cosine integral coefficients for

on`f`(`x`)`[0, inf]`

.

__Function:__**fourintsin***(*`f`,`x`)-
Returns the Fourier sine integral coefficients for

on`f`(`x`)`[0, inf]`

.

Go to the first, previous, next, last section, table of contents.