Learn more about Simulink Control Design

frest.Chirp - Package: frest

Swept-frequency cosine signal

Syntax

input = frest.Chirp(sys) input = frest.Chirp('OptionName',OptionValue)

Description

input = frest.Chirp(sys) creates a swept-frequency cosine input signal based on the dynamics of a linear system sys.

input = frest.Chirp('OptionName',OptionValue) creates a swept-frequency cosine input signal using the options specified by comma-separated name/value pairs.

To view a plot of your input signal, type plot(input). To obtain a timeseries for your input signal, use the generateTimeseries command.

Inputs

sys

Linear system for creating a chirp signal that matches the dynamic characteristics of this system. You can specify the linear system based on known dynamics using tf, zpk, or ss. You can also obtain the linear system by linearizing a nonlinear system.

The resulting chirp signal automatically sets these options based on the linear system:

'FreqRange' are the frequencies at which the linear system has interesting dynamics.
'Ts' is set to avoid aliasing such that the Nyquist frequency of the signal is five times the upper end of the frequency range.
'NumSamples' is set such that the frequency response estimation includes the lower end of the frequency range.

Other chirp options have default values.

'OptionName',OptionValue

Signal characteristics, specified as comma-separated pairs of option name string and the option value.

Option Name Option Value

'Amplitude'
Signal amplitude.

Default:1e-5

'FreqRange' Signal frequencies, specified as either:
Two-element vector, for example [w1 w2]
Two-element cell array, for example {w1 w2}

Default:[1,1000]

'FreqUnits'
Frequency units:
'rad/s'—Radians per second
'Hz'—Hertz
Changing frequency units does not impact frequency response estimation.

Default:'rad/s'

'Ts'
Sample time of the chirp signal in seconds. The default setting avoids aliasing.
Default:

'NumSamples'
Number of samples in the chirp signal. Default setting ensures that the estimation includes the lower end of the frequency range.
Default:

'SweepMethod'
Method for evolution of instantaneous frequency:
'linear' (default)—Specifies the instantaneous frequency sweep f_i(t):

β ensures that the signal maintains the desired frequency breakpoint f₁ at final time t_f.

'logarithmic'—Specifies the instantaneous frequency sweep f_i(t) given by

'quadratic'—Specifies the instantaneous frequency sweep f_i(t):

Also specify the shape of the quadratic using the 'Shape' option.

'Shape'
Use when you set 'SweepMethod' to 'quadratic' to describe the shape of the parabola in the positive frequency axis:
'concave'—Concave quadratic sweeping shape.

'convex'—Convex quadratic sweeping shape.

'InitialPhase'
Initial phase of the Chirp signal in degrees.

Default:270

Examples

Create a chirp input signal:

input = frest.Chirp('Amplitude',1e-3,'FreqRange',[10 500],'NumSamples',20000)

How To

findop

frest.createFixedTsSinestream

Related Products & Applications

Get Simulink trial software

Learn more about Simulink through this collection of videos, articles, technical literature and the Getting Started with Simulink Guide.

Get this Simulink Kit