Skip to Main Content Skip to Search
Product Documentation

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.

Input Arguments

sys

Linear system for creating a chirp signal based on 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 NameOption 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 fi(t):

    β ensures that the signal maintains the desired frequency breakpoint f1 at final time tf.

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

  • 'quadratic'—Specifies the instantaneous frequency sweep fi(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)

See Also

frest.Random | frest.Sinestream | frestimate | generateTimeseries | getSimulationTime

How To

  

 

Free Control Systems Interactive Kit

Learn more about resources for designing, testing, and implementing control systems.

Get free kit

Trials Available

Try the latest control systems products.

Get trial software
 © 1984-2012- The MathWorks, Inc.    -   Site Help   -   Patents   -   Trademarks   -   Privacy Policy   -   Preventing Piracy   -   RSS