This is machine translation

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

Note: This page has been translated by MathWorks. Click here to see
To view all translated materials including this page, select Country from the country navigator on the bottom of this page.


Package: frest

Swept-frequency cosine signal


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


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


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.


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

Option NameOption Value

Signal amplitude.

Default: 1e-5


Signal frequencies, specified as either:

  • Two-element vector, for example [w1 w2]

  • Two-element cell array, for example {w1 w2}

Default: [1,1000]


Frequency units:

  • 'rad/s' — Radians per second

  • 'Hz' — Hertz

Changing frequency units does not impact frequency response estimation.

Default: 'rad/s'


Sample time of the chirp signal in seconds. The default setting avoids aliasing.

Default: 2π5*max(FreqRange)


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

Default: 4πTs*min(FreqRange)


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.


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.


Initial phase of the Chirp signal in degrees.

Default: 270


Create a chirp input signal:

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

Introduced in R2009b

Was this topic helpful?