(8.D.2.1) PDF
Overview
pdf of data
Discussion
The PDF module builds a histogram of incoming data and allows you to freeze the histogram with an input pin. It also provides optional smoothing as well as an optional reset pin. A histogram is a graphical representation showing a visual impression of the distribution of data values. A histogram is essentially a table in which each entry represents the number of times that the input sample values fell in a particular range.
Unlike the Histogram module, the PDF module calculates the bin spacing based on the higherBinEdge and lowerBinEdge variables ((higherBinEdge - lowerBinEdge) / numBins). Set these variables to change the bin spacing of your PDF module’s histogram.
Connect an audio signal that you wish to analyze by wiring into input pin 1.
Conenct a BooleanSource module to the freeze pin and toggle to freeze the histogram in its current state.
(OPTIONAL) Enable the reset pin in the Arguments tab. Connect a BooleanSource module to the optional reset pin to clear the histogram data.
Type Definition
typedef struct _ModulePDF
{
ModuleInstanceDescriptor instance; // Common Audio Weaver module instance structure
INT32 numBins; // Number of bins
INT32 controllableResetPin; // Controlling Reset Pin
FLOAT32 lowerBinEdge; // Specifies the lowest bin in the histogram
FLOAT32 higherBinEdge; // Specifies the highest bin in the histogram
FLOAT32 smoothingTime; // The smoothing time of the PDF in ms
FLOAT32 alpha; // Forgetting factor
FLOAT32 binSpacing; // BinSpacing
INT32 reset; // Boolean parameter to reset the pdf.
FLOAT32* binCenter; // indices
FLOAT32* previousOut; // previous output.
INT32* hist; // init hist.
} ModulePDFClass;
Variables
Properties
Name | Type | Usage | isHidden | Default value | Range | Units |
numBins | int | const | 0 | 32 | Unrestricted | Â |
controllableResetPin | int | const | 0 | 1 | Unrestricted | Â |
lowerBinEdge | float | parameter | 0 | -1 | Unrestricted | Â |
higherBinEdge | float | parameter | 0 | 1 | Unrestricted | Â |
smoothingTime | float | parameter | 0 | 1000 | 0:10000 | Â |
alpha | float | derived | 0 | 0.0006664 | Unrestricted | Â |
binSpacing | float | derived | 0 | 0.0625 | Unrestricted | Â |
reset | int | parameter | 0 | 0 | 0:1 | Â |
binCenter | float* | derived | 0 | [32 x 1] | Unrestricted | Â |
previousOut | float* | state | 0 | [32 x 1] | Unrestricted | Â |
hist | int* | state | 0 | [32 x 1] | Unrestricted | Â |
Pins
Input Pins
Name: in
Description: Audio input
Data type: float
Channel range: Unrestricted
Block size range: Unrestricted
Sample rate range: Unrestricted
Complex support: Real
Â
Name: freeze
Description: input freeze
Data type: int
Channel range: 1
Block size range: 1
Sample rate range: Unrestricted
Complex support: Real
Â
Name: reset
Description: input reset
Data type: int
Channel range: 1
Block size range: 1
Sample rate range: Unrestricted
Complex support: Real
Output Pins
Name: out
Description: Audio output
Data type: float
MATLAB Usage
File Name: pdf_module.m
Â