variety: Specifies the type of data passed. The options are signal and psd (for a power spectral density). The default is signal.

frequencyunit: Specifies the underlying unit of frequency used when computing statistics. Either of the forms algebraic and Unit(algebraic) are accepted. The default is Unit(Hz).

fftnormalization: One of none, symmetric, or full, indicates the normalization to be applied when using the Fast Fourier Transform (FFT). The default is symmetric.

temperendpoints: Either true or false, specifies whether the power spectrum is to be tempered at the endpoints. The default is false.

window: Either a list, name, or string, specifies the windowing command to be applied to the signal when variety=signal. The default is "none" (for no windowing to be applied).

windownormalization: Either true or false, indicates if the windowing function is to be normalized. The default is true.

method: The method of numerical integration to be used to find band power. The options are leftendpoint, rightendpoint, simpson, and trapezoid. The default is trapezoid, which is equivalent to finding the area under the linear interpolation through all the points.

output : The type of output. The supported options are:

bandpower: Returns a value of type float[8] for the band power.

entropy: Returns a value of type float[8] for the spectral entropy.

meanfrequency: Returns a value of type float[8] for the mean frequency.

frequencies: Returns a Vector, of float[8] datatype and length the same as signal, containing the frequencies.

indices: Returns a list of the form $\left[\mathrm{\alpha }\,\mathrm{\beta }\right]$, where $\mathrm{\alpha }$ and $\mathrm{\beta }$ are, respectively, the lower and upper indices of the frequencies Vector that correspond to the frequencies in frequencyrange.

psd: Returns a vector of float[8] datatype containing the power spectral density.

record: Returns a record with the previous options.

list of any of the above options: Returns an expression sequence with the corresponding outputs, in the same order.

The default output is bandpower.

The BandPower command takes a 1-D rtable or list of data and computes band power based on the remaining parameters and options. Other statistics, like mean frequency and spectral entropy, can be computed and returned, along with Vectors for the power spectral density and frequencies.

If data is an rtable of type AudioTools:-Audio, the sample rate in hertz ($\mathrm{Hz}$) is inferred from the attributes. Should samplerate also be passed, it will be overridden.

Values for/in samplerate, frequencyrange, and frequencies can include units for frequency, and those without an explicit unit are assumed to be in terms of frequencyunit. An error will be thrown if a unit which cannot be converted to hertz is passed. Caution: Passing long vectors with elements having units requires time-consuming conversions. It is recommended that the frequencies Vector consist only of the numeric values, with units indicated by frequencyunit.

If window is passed as a list, the first element provides the name of the windowing command, and any remaining terms are passed as options to the command.

The value of window, when not passed as a list, should be the name or string, with or without the Window suffix, that corresponds to the windowing command. For example, to use a Hamming window, you can pass window=Hamming or window="HammingWindow". In both cases, the command SignalProcessing[HammingWindow] will be used internally. Similarly, you can pass window=["Exponential",0.5] or window=[ExponentialWindow,0.5] to use SignalProcessing[ExponentialWindow] with parameter value 0.5.

To apply a window to a Vector $V$ of length $n$, the window is first applied to another Vector $W$ of size $n$ and filled with ones, and then $V$ is multiplied element-wise by $W$. When windownormalization=true, $W$ is first normalized with respect to its Root Mean Square (RMS).

Two or more points are always required in data to compute band power, mean frequency, and spectral entropy in the frequency domain.

When variety=psd, the elements of data must be non-negative, the elements of frequencies must be strictly increasing, and the left end of frequencyrange must be less than the right end.

A value for samplerate is required and used when variety=signal.

The frequencies rtable is required and used only when variety=psd. In this case, the rtable must be of the same size as data.

Input rtables (data and frequencies) are converted to Vectors of either float[8] or complex[8] datatype, and an error will be thrown if this is not possible. For this reason, it is most efficient for input rtables to already be Vectors having the appropriate datatype. Specifically:

frequencies should be float[8].

When variety=signal, data should be float[8] (for real-valued data) or complex[8] (for complex-valued data).

When variety=psd, data should be float[8].

The band power of signal $X$ with length $n$ is computed as the area beneath the graph of the power spectral density $P$ of $X$ versus the frequencies $F$. To this end, first calculate the FFT of $X$. If $X$ is real-valued, we take $Y$ to be the first half of the FFT (due to symmetry). The end result will be scaled appropriately, giving the same band power as if the truncation had not been performed. When $X$ has complex values, on the other hand, a full FFT is used to define $Y$. We take the half-size to be the following:

Second, compute the power spectral density $P$ from $Y$:

where $k$ is the size of $Y$ (either $m$ or $n$), $r$ is the sample rate, and $c=2$ when $X$ is real-valued and $c=1$ when $X$ is complex-valued. To create the Vector $F$ of frequencies, we consider the two cases. When $X$ is real-valued:

When $X$ is complex-valued:

Caution: Maple uses the convention of the frequencies ranging from $0$ to $T$, where $0<T$ and $\left[0\&comma;T\right]$ is the interval over which the signal is sampled. The other common convention is to use frequencies in the range $\left[-\frac{T}{2}\&comma;\frac{T}{2}\right]$. Usually, $T$ is the period of a periodic function.

The mean frequency of signal $X$ is computed as the average of the frequencies $F$ weighted by the power spectral density $P$:

where $k$ is the size of $F$ (either $m$ or $n$). When all elements of $P$ are zero, then the mean frequency is HFloat(undefined).

The spectral entropy of signal $X$ is computed using the formula from Shannon Information Theory applied to the power spectral density $P$ treated as a probability distribution:

where

and $k$ is the size of $P$ (either $m$ or $n$). When all elements of $P$ are zero, then the spectral entropy is HFloat(undefined). Note that another convention for spectral entropy is to divide the above by ${\log }_2\left(k\right)$, which quantifies the maximum spectral entropy of white noise.

When temperendpoints=true, the endpoints of the power spectrum, determined by the method described above, are halved. Note that the signal size must be three or more for tempering.

The frequencyrange option is used to restrict the computations for statistics to a specific frequency band. It can be in the form a..b (to restrict frequencies to those between a and b), a.. (to restrict frequencies to those that are no less than a), ..b (to restrict frequencies to those that are no more than b), or .. (to allow all frequencies). The endpoints of frequencyrange are used to determine indices $\mathrm{\alpha }$ and $\mathrm{\beta }$, with the band power estimated as the the numeric integral of $P_{\mathrm{\alpha }..\mathrm{\beta }}$ over $F_{\mathrm{\alpha }..\mathrm{\beta }}$, the mean frequency estimated as the mean of $F_{\mathrm{\alpha }..\mathrm{\beta }}$ with weights $P_{\mathrm{\alpha }..\mathrm{\beta }}$, and the spectral entropy computed as the entropy of $Q_{\mathrm{\alpha }..\mathrm{\beta }}$ where $Q$ is $P$ normalized as a probability distribution. In the simplest case, where $a$ and $b$ are both provided with $\min \left(F\right)\le a$, $a<b$, and $b\le \max \left(F\right)$, we take $\mathrm{\alpha }$ to be the largest index $i$ such that $F_i\le a$, and $\mathrm{\beta }$ to be the smallest index $j$ such that $b\le F_j$.

Band powers for a disjoint union of intervals typically add up to close to the total. For example, BandPower(X,0.01,..50)+BandPower(X,0.01,50..) should be close to (but not necessarily equal, due to discretization and numerical errors) BandPower(X).

The BandPower command is not thread safe.

$\mathrm{with}\left(\mathrm{SignalProcessing}\right)\&colon;$

The SignalProcessing[BandPower] command was introduced in Maple 2021.

For more information on Maple 2021 changes, see Updates in Maple 2021.