visualize

Visualize static characteristic of dynamic range controller

Syntax

visualize(dynamicRangeController)

visualize(dynamicRangeController,inputRange)

hvsz = visualize(___)

Description

visualize(dynamicRangeController) plots the static characteristic of the dynamic range control object. The plot is updated automatically when properties of the object change.

visualize(dynamicRangeController,inputRange) enables you to specify the input range.

hvsz = visualize(___) returns a handle to the visualizer when called with any of the previous syntaxes.

Examples

Plot Static Characteristic

Create a compressor System object™, and then plot the static characteristic.

dynamicRangeCompressor = compressor;
visualize(dynamicRangeCompressor)

The static characteristic plot updates automatically if you modify a property of the object.

dynamicRangeCompressor.Threshold = -30;

Specify Range of Static Characteristic Plot

Create an expander System object™. Plot the static characteristic over the range –15 to –5, in 0.001 dB increments.

dynamicRangeExpander = expander;
visualize(dynamicRangeExpander,-15:0.001:-5)

Get Output Level From Static Characteristic

Create a limiter System object™. Get the output level of the static characteristic over a specified range.

dynamicRangeLimiter = limiter;
inputLevel = -15:1:-5

inputLevel = 1×11

   -15   -14   -13   -12   -11   -10    -9    -8    -7    -6    -5

outputLevel = staticCharacteristic(dynamicRangeLimiter,inputLevel)

outputLevel = 1×11

   -15   -14   -13   -12   -11   -10   -10   -10   -10   -10   -10

Plot the static characteristic. Modify the title to state that the object is a limiter.

hvsz = visualize(dynamicRangeLimiter,inputLevel);
hvsz.Title = "Limiter Static Characteristic";

Input Arguments

dynamicRangeController — Dynamic range control object

object

Dynamic range control object, specified as a compressor, expander, limiter, or noiseGate System object™.

inputRange — Range to calculate static characteristic output

[-50:0.01:0] (default) | vector of monotonically increasing values

Range over which to calculate the output of the static characteristic, specified as a vector of monotonically increasing values expressed in dB. The default input range is [-50:0.01:0] dB.

Output Arguments

hvsz — Visualizer handle

dsp.ArrayPlot object

Visualizer handle, returned as a dsp.ArrayPlot object.

Version History

Introduced in R2016a

R2022a: visualize object function outputs figure handles

In previous releases, calling the visualize function of the dynamic range control System objects with an output argument returned static characteristic data. Starting in R2022a, that syntax returns a figure handle instead. Use the new staticCharacteristic function to compute static dynamic range characteristics.

R2022a: visualize plots static characteristics of noiseGate System objects in dB

In previous releases, the visualize function plotted the static characteristic of a noiseGate System object in linear units. Starting in R2022a, the function plots all static characteristics in dB.