Documentation

This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English verison of the page.

Note: This page has been translated by MathWorks. Please click here
To view all translated materals including this page, select Japan from the country navigator on the bottom of this page.

commsrc.combinedjitter

Construct combined jitter generator object

Syntax

JTR = commsrc.combinedjitter

Description

JTR = commsrc.combinedjitter constructs a default combined jitter generator object, JTR. This syntax is equivalent to:

JTR = commsrc.combinedjitter('RandomJitter','off', ...
        'PeriodicJitter','off', ...
        'DiracJitter','off')

When the RandomJitter, PeriodicJitter, and DiracJitter properties are enabled, the generator has the following default values:

JTR = commsrc.combinedjitter('RandomJitter','on', ...
        'RandomStd',1e-4, ...
        'PeriodicJitter','on', ...
        'PeriodicNumber',1, ...
        'PeriodicAmplitude',5e-4, ...
        'PeriodicFrequency',2, ...
        'PeriodicPhase',0, ...
        'DiracJitter','on', ...
        'DiracNumber',2, ...
        'DiracDelta',[-5e-4 5e-4], ...
        'DiracProbability',[0.5 0.5])

The object is used to generate jitter samples which may include any combination of random, periodic, and Dirac components.

Properties

A combined jitter generator object has the properties shown on the following table. You can edit all properties, except those explicitly noted.

PropertyDescription
TypeType of object, Combined Jitter Generator . This property is not writable.
RandomJitterVariable to enable the random jitter generator. Specify as either 'on' or 'off'.
RandomStdStandard deviation of the random jitter generator in seconds.
PeriodicJitterVariable to enable the periodic jitter generator. Specify as either 'on' or 'off'.
PeriodicNumberNumber of sinusoidal components. The PeriodicNumber must be a finite positive scalar integer.
PeriodicAmplitudeAmplitude of each sinusoidal component of the periodic jitter.
PeriodicFrequencyFrequency of each sinusoidal component of the periodic jitter measured in cycles per 100 samples.
PeriodicPhasePhase of each sinusoidal component of the periodic jitter.
DiracJitterVariable to enable the Dirac jitter generator. Specify as either 'on' or 'off'.
DiracNumberNumber of Dirac components. The DiracNumber must be a finite positive scalar integer.
DiracDeltaTime delay of each Dirac component in seconds.
DiracProbabilityProbability of each Dirac component represented as a vector of length DiracNumber. The sum of the probabilities must equal one.

Methods

A combined jitter generator object has three methods, as described in this section.

generate

This method generates jitter samples based on the jitter generator object. It has one input argument, which is the number of samples in a frame. Its output is a single-column vector of length N. You can call this method using the following syntax

x = generate(JTR,N)
where JTR is the generator object, N is the number of output samples, and x is a real single-column vector.

reset

This method resets the internal states of the combined jitter generator. This method has no input arguments.

reset(h)

disp

Display the properties of the combined generator object h. This method has no input arguments.

disp(h)

Examples

collapse all

Generate 500 jitter samples composed of random and periodic components.

Create a commsrc.combinedjitter object in which the jitter is a combination of random and periodic components by setting the RandomJitter and PeriodicJitter properties to 'on'. Using name-value pairs, set the standard deviation of the random jitter to 2e-4 and the periodic jitter amplitude and frequency to 5e-4 and 2, respectively.

JTR = commsrc.combinedjitter(...
    'RandomJitter','on', ...
    'RandomStd',2e-4, ...
    'PeriodicJitter','on', ...
    'PeriodicAmplitude',5e-4, ...
    'PeriodicFrequency',2);

Use the generate method to create the combined jitter samples.

x = generate(JTR,500);

Plot the jitter samples. You can see the Gaussian and periodic nature of the combined jitter.

plot(x)
xlabel('Samples')
ylabel('Jitter (seconds)')

Introduced in R2015a

Was this topic helpful?