Bode plot of frequency response, or magnitude and phasedata

collapse all in page

## Syntax

`bode(sys)`

`bode(sys1,sys2,...,sysN)`

`bode(sys1,LineSpec1,...,sysN,LineSpecN)`

`bode(___,w)`

`[mag,phase,wout]= bode(sys)`

`[mag,phase,wout]= bode(sys,w)`

`[mag,phase,wout,sdmag,sdphase]= bode(sys,w)`

## Description

example

`bode(sys)`

createsa Bode plot of the frequency response of a dynamicsystem model `sys`

. The plot displaysthe magnitude (in dB) and phase (in degrees) of the system responseas a function of frequency. `bode`

automaticallydetermines frequencies to plot based on system dynamics.

If `sys`

is a multi-input, multi-output (MIMO)model, then `bode`

produces an array of Bode plots,each plot showing the frequency response of one I/O pair.

If `sys`

is a model with complex coefficients, then in:

Log frequency scale, the plot shows two branches, one for positive frequencies and one for negative frequencies. The plot also shows arrows to indicate the direction of increasing frequency values for each branch. See Bode Plot of Model with Complex Coefficients.

Linear frequency scale, the plot shows a single branch with a symmetric frequency range centered at a frequency value of zero.

example

`bode(sys1,sys2,...,sysN)`

plots the frequencyresponse of multiple dynamic systems on the same plot. All systemsmust have the same number of inputs and outputs.

example

`bode(sys1,LineSpec1,...,sysN,LineSpecN)`

specifies a color, line style, and marker for each system in the plot.

example

`bode(___,w)`

plotssystem responses for frequencies specified by `w`

.

If

`w`

is a cell array of the form`{wmin,wmax}`

,then`bode`

plots the response at frequencies rangingbetween`wmin`

and`wmax`

.If

`w`

is a vector of frequencies, then`bode`

plots the response at each specified frequency. The vector`w`

can contain both negative and positive frequencies.

You can use `w`

with any of the input-argumentcombinations in previous syntaxes.

example

`[mag,phase,wout]= bode(sys)`

returns the magnitudeand phase of the response at each frequency in the vector `wout`

.The function automatically determines frequencies in `wout`

basedon system dynamics. This syntax does not draw a plot.

example

`[mag,phase,wout]= bode(sys,w)`

returnsthe response data at the frequencies specified by `w`

.

If

`w`

is a cell array of the form`{wmin,wmax}`

,then`wout`

contains frequencies ranging between`wmin`

and`wmax`

.If

`w`

is a vector of frequencies,then`wout`

=`w`

.

example

`[mag,phase,wout,sdmag,sdphase]= bode(sys,w)`

alsoreturns the estimated standard deviation of the magnitude and phasevalues for the identified model `sys`

.If you omit `w`

, then the function automaticallydetermines frequencies in `wout`

based on systemdynamics.

## Examples

collapse all

### Bode Plot of Dynamic System

This example uses:

- Control System ToolboxControl System Toolbox

Open Live Script

Create a Bode plot of the following continuous-time SISO dynamic system.

$$H(s)=\frac{{s}^{2}+0.1s+7.5}{{s}^{4}+0.12{s}^{3}+9{s}^{2}}.$$

H = tf([1 0.1 7.5],[1 0.12 9 0 0]);bode(H)

`bode`

automatically selects the plot range based on the system dynamics.

### Bode Plot at Specified Frequencies

This example uses:

- Control System ToolboxControl System Toolbox

Open Live Script

Create a Bode plot over a specified frequency range. Use this approach when you want to focus on the dynamics in a particular range of frequencies.

`H = tf([-0.1,-2.4,-181,-1950],[1,3.3,990,2600]);bode(H,{1,100})grid on`

The cell array `{1,100}`

specifies the minimum and maximum frequency values in the Bode plot. When you provide frequency bounds in this way, the function selects intermediate points for frequency response data.

Alternatively, specify a vector of frequency points to use for evaluating and plotting the frequency response.

w = [1 5 10 15 20 23 31 40 44 50 85 100];bode(H,w,'.-')grid on

`bode`

plots the frequency response at the specified frequencies only.

### Compare Bode Plots of Several Dynamic Systems

This example uses:

- Control System ToolboxControl System Toolbox

Open Live Script

Compare the frequency response of a continuous-time system to an equivalent discretized system on the same Bode plot.

Create continuous-time and discrete-time dynamic systems.

`H = tf([1 0.1 7.5],[1 0.12 9 0 0]);Hd = c2d(H,0.5,'zoh');`

Create a Bode plot that displays both systems.

bode(H,Hd)

The Bode plot of a discrete-time system includes a vertical line marking the Nyquist frequency of the system.

### Bode Plot with Specified Line Attributes

This example uses:

- Control System ToolboxControl System Toolbox

Open Live Script

Specify the line style, color, or marker for each system in a Bode plot using the `LineSpec`

input argument.

H = tf([1 0.1 7.5],[1 0.12 9 0 0]);Hd = c2d(H,0.5,'zoh');bode(H,'r',Hd,'b--')

The first `LineSpec`

, `'r'`

, specifies a solid red line for the response of `H`

. The second `LineSpec`

, `'b--'`

, specifies a dashed blue line for the response of `Hd`

.

### Obtain Magnitude and Phase Data

This example uses:

- Control System ToolboxControl System Toolbox

Open Live Script

Compute the magnitude and phase of the frequency response of a SISO system.

If you do not specify frequencies, `bode`

chooses frequencies based on the system dynamics and returns them in the third output argument.

H = tf([1 0.1 7.5],[1 0.12 9 0 0]);[mag,phase,wout] = bode(H);

Because `H`

is a SISO model, the first two dimensions of `mag`

and `phase`

are both 1. The third dimension is the number of frequencies in `wout`

.

size(mag)

`ans = `*1×3* 1 1 41

length(wout)

ans = 41

Thus, each entry along the third dimension of `mag`

gives the magnitude of the response at the corresponding frequency in `wout`

.

### Magnitude and Phase of MIMO System

This example uses:

- Control System ToolboxControl System Toolbox

Open Live Script

For this example, create a 2-output, 3-input system.

rng(0,'twister'); % For reproducibilityH = rss(4,2,3);

For this system, `bode`

plots the frequency responses of each I/O channel in a separate plot in a single figure.

bode(H)

Compute the magnitude and phase of these responses at 20 frequencies between 1 and 10 radians.

w = logspace(0,1,20);[mag,phase] = bode(H,w);

`mag`

and `phase`

are three-dimensional arrays, in which the first two dimensions correspond to the output and input dimensions of `H`

, and the third dimension is the number of frequencies. For instance, examine the dimensions of `mag`

.

size(mag)

`ans = `*1×3* 2 3 20

Thus, for example, `mag(1,3,10)`

is the magnitude of the response from the third input to the first output, computed at the 10th frequency in `w`

. Similarly, `phase(1,3,10)`

contains the phase of the same response.

### Bode Plot of Identified Model

Open Live Script

Compare the frequency response of a parametric model, identified from input/output data, to a nonparametric model identified using the same data.

Identify parametric and nonparametric models based on data.

load iddata2 z2;w = linspace(0,10*pi,128);sys_np = spa(z2,[],w);sys_p = tfest(z2,2);

Using the `spa`

and `tfest`

commands requires System Identification Toolbox™ software.

`sys_np`

is a nonparametric identified model. `sys_p`

is a parametric identified model.

Create a Bode plot that includes both systems.

bode(sys_np,sys_p,w);legend('sys-np','sys-p')

You can display the confidence region on the Bode plot by right-clicking the plot and selecting **Characteristics > Confidence Region**.

### Obtain Magnitude and Phase Standard Deviation Data of Identified Model

Open Live Script

Compute the standard deviation of the magnitude and phase of an identified model. Use this data to create a 3σ plot of the response uncertainty.

Identify a transfer function model based on data. Obtain the standard deviation data for the magnitude and phase of the frequency response.

load iddata2 z2;sys_p = tfest(z2,2);w = linspace(0,10*pi,128);[mag,ph,w,sdmag,sdphase] = bode(sys_p,w);

Using the `tfest`

command requires System Identification Toolbox™ software.

`sys_p`

is an identified transfer function model. `sdmag`

and `sdphase`

contain the standard deviation data for the magnitude and phase of the frequency response, respectively.

Use the standard deviation data to create a 3σ plot corresponding to the confidence region.

mag = squeeze(mag);sdmag = squeeze(sdmag);semilogx(w,mag,'b',w,mag+3*sdmag,'k:',w,mag-3*sdmag,'k:');

### Bode Plot of Model with Complex Coefficients

This example uses:

- Control System ToolboxControl System Toolbox

Open Live Script

Create a Bode plot of a model with complex coefficients and a model with real coefficients on the same plot.

rng(0)A = [-3.50,-1.25-0.25i;2,0];B = [1;0];C = [-0.75-0.5i,0.625-0.125i];D = 0.5;Gc = ss(A,B,C,D);Gr = rss(5);bode(Gc,Gr)legend('Complex-coefficient model','Real-coefficient model','Location','southwest')

In log frequency scale, the plot shows two branches for complex-coefficient models, one for positive frequencies, with a right-pointing arrow, and one for negative frequencies, with a left-pointing arrow. In both branches, the arrows indicate the direction of increasing frequencies. The plots for real-coefficient models always contain a single branch with no arrows.

You can change the frequency scale of the Bode plot by right-clicking the plot and selecting **Properties**. In the Property Editor dialog, on the **Units** tab, set the frequency scale to `linear scale`

. Alternatively, you can use the `bodeplot`

function with a `bodeoptions`

object to create a customized plot.

`opt = bodeoptions;opt.FreqScale = 'Linear';`

Create the plot with customized options.

bodeplot(Gc,Gr,opt)legend('Complex-coefficient model','Real-coefficient model','Location','southwest')

In linear frequency scale, the plot shows a single branch with a symmetric frequency range centered at a frequency value of zero. The plot also shows the negative-frequency response of a real-coefficient model when you plot the response along with a complex-coefficient model.

## Input Arguments

collapse all

`sys`

— Dynamic system

dynamic system model | model array

Dynamic system, specified as a SISO or MIMO dynamic system model or array of dynamic system models. Dynamic systems that you can use include:

Continuous-time or discrete-time numeric LTI models, such as tf (Control System Toolbox), zpk (Control System Toolbox), or ss (Control System Toolbox) models.

Generalized or uncertain LTI models such as genss (Control System Toolbox) or uss (Robust Control Toolbox) models. (Using uncertain models requires Robust Control Toolbox™ software.)

For tunable control design blocks, the function evaluates the model at its current value for both plotting and returning frequency response data.

For uncertain control design blocks, the function plots the nominal value and random samples of the model. When you use output arguments, the function returns frequency response data for the nominal model only.

Frequency-response data models such as

`frd`

models. For such models, the function plots the response at frequencies defined in the model.Identified LTI models, such as idtf, idss, or idproc models. For such models, the function can also plot confidence intervals and return standard deviations of the frequency response. See Bode Plot of Identified Model.

If `sys`

is an array of models, the function plots the frequency responses of all models in the array on the same axes.

`w`

— Frequencies

`{wmin,wmax}`

| vector

Frequencies at which to compute and plot frequency response, specified as the cell array `{wmin,wmax}`

or as a vector of frequency values.

If

`w`

is a cell array of the form`{wmin,wmax}`

, then the function computes the response at frequencies ranging between`wmin`

and`wmax`

.If

`w`

is a vector of frequencies, then the function computes the response at each specified frequency. For example, use logspace to generate a row vector with logarithmically spaced frequency values. The vector`w`

can contain both positive and negative frequencies.

For models with complex coefficients, if you specify a frequency range of [*w*_{min},*w*_{max}] for your plot, then in:

Log frequency scale, the plot frequency limits are set to [

*w*_{min},*w*_{max}] and the plot shows two branches, one for positive frequencies [*w*_{min},*w*_{max}] and one for negative frequencies [–*w*_{max},–*w*_{min}].Linear frequency scale, the plot frequency limits are set to [–

*w*_{max},*w*_{max}] and the plot shows a single branch with a symmetric frequency range centered at a frequency value of zero.

Specify frequencies in units of rad/`TimeUnit`

, where `TimeUnit`

is the `TimeUnit`

property of the model.

## Output Arguments

collapse all

`mag`

— Magnitude of system response

3-D array

Magnitude of the system response in absolute units, returnedas a 3-D array. The dimensions of this array are (number of systemoutputs) × (number of system inputs) × (number of frequencypoints).

For SISO systems,

`mag(1,1,k)`

givesthe magnitude of the response at the`k`

th frequencyin w or wout. For an example,see Obtain Magnitude and Phase Data.For MIMO systems,

`mag(i,j,k)`

givesthe magnitude of the response at the`k`

th frequencyfrom the`j`

th input to the`i`

thoutput. For an example, see Magnitude and Phase of MIMO System.

To convert the magnitude from absolute units to decibels, use:

magdb = 20*log10(mag)

`phase`

— Phase of system response

3-D array

Phase of the system response in degrees, returned as a 3-D array.The dimensions of this array are (number of outputs) × (numberof inputs) × (number of frequency points).

For SISO systems,

`phase(1,1,k)`

gives the phase of the response at the`k`

th frequency in w or wout. For an example, see Obtain Magnitude and Phase Data.For MIMO systems,

`phase(i,j,k)`

gives the phase of the response at the`k`

th frequency from the`j`

th input to the`i`

th output. For an example, see Magnitude and Phase of MIMO System.

`wout`

— Frequencies

vector

Frequencies at which the function returns the system response, returned as a column vector. The function chooses the frequency values based on the model dynamics, unless you specify frequencies using the input argument w.

`wout`

also contains negative frequency values for models with complex coefficients.

Frequency values are in radians/`TimeUnit`

, where `TimeUnit`

is the value of the `TimeUnit`

property of sys.

`sdmag`

— Standard deviation of magnitude

3-D array | `[]`

Estimated standard deviation of the magnitude of the responseat each frequency point, returned as a 3-D array. `sdmag`

hasthe same dimensions as mag.

If sys is not an identified LTI model, `sdmag`

is `[]`

.

`sdphase`

— Standard deviation of phase

3-D array | `[]`

Estimated standard deviation of the phase of the response ateach frequency point, returned as a 3-D array. `sdphase`

hasthe same dimensions as phase.

If sys is not an identified LTI model, `sdphase`

is `[]`

.

## Tips

When you need additional plot customization options,use bodeplot (Control System Toolbox) instead.

## Algorithms

`bode`

computes the frequency response asfollows:

Compute the zero-pole-gain (zpk (Control System Toolbox))representation of the dynamic system.

Evaluate the gain and phase of the frequency responsebased on the zero, pole, and gain data for each input/output channelof the system.

For continuous-time systems,

`bode`

evaluatesthe frequency response on the imaginary axis*s*=*jω*andconsiders only positive frequencies.For discrete-time systems,

`bode`

evaluatesthe frequency response on the unit circle. To facilitate interpretation,the command parameterizes the upper half of the unit circle as:$$z={e}^{j\omega {T}_{s}},\text{\hspace{1em}}0\le \omega \le {\omega}_{N}=\frac{\pi}{{T}_{s}},$$

where

*T*is the sampletime and_{s}*ω*is theNyquist frequency. The equivalent continuous-time frequency_{N}*ω*isthen used as the*x*-axis variable. Because $$H\left({e}^{j\omega {T}_{s}}\right)$$ isperiodic with period 2*ω*,_{N}`bode`

plotsthe response only up to the Nyquist frequency*ω*.If sys is a discrete-time model with unspecifiedsample time,_{N}`bode`

uses*T*=1._{s}

## Version History

**Introduced before R2006a**

## See Also

bodeplot | freqresp | nyquist | spectrum | step

### Topics

- Plot Bode and Nyquist Plots at the Command Line
- Dynamic System Models

### External Websites

- Transfer Function Analysis of Dynamic Systems (MathWorks Teaching Resources)

## MATLAB Command

You clicked a link that corresponds to this MATLAB command:

Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.

Select a Web Site

Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .

You can also select a web site from the following list:

### Americas

- América Latina (Español)
- Canada (English)
- United States (English)

### Europe

- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)

- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- Deutsch
- English
- Français

- United Kingdom (English)

Contact your local office