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.

polar

Plot specified circuit object parameters on polar coordinates

Syntax

lineseries = polar(h,'parameter1',...,'parametern')
lineseries=polar(h,'parameter1',...,'parametern', xparameter,xformat,'condition1',value1,..., 'conditionm',valuem, 'freq',freq,'pin',pin)

Description

lineseries = polar(h,'parameter1',...,'parametern') plots the parameters parameter1, ..., parametern from the object h on polar coordinates. h is the handle of a circuit (rfckt) object.

polar returns a column vector of handles to lineseries objects, one handle per line. This is the same as the output returned by the MATLAB® polar function.

Type listparam(h) to get a list of valid parameters for a circuit object h.

Note

For all circuit objects except those that contain data from a data file, you must use the analyze method to perform a frequency domain analysis before calling polar.

Use the Property Editor (propertyeditor) or the MATLAB set function to change the Line Properties. The reference pages for MATLAB functions such as figure, axes, and text list available properties and provide links to more complete descriptions.

Note

Use the MATLAB polar function to plot parameters that are not part of a circuit (rfckt) object, but are specified as vector data.

lineseries=polar(h,'parameter1',...,'parametern', xparameter,xformat,'condition1',value1,..., 'conditionm',valuem, 'freq',freq,'pin',pin) plots the specified parameters at the specified operating conditions for the object h.

xparameter is the independent variable to use in plotting the specified parameters. Several xparameter values are available for all objects. When you import rfckt.amplifier, rfckt.mixer, or rfdata.data object specifications from a .p2d or .s2d file, you can also specify any operating conditions from the file that have numeric values, such as bias.

The following table shows the most commonly available parameters and the corresponding xparameter values. The default settings listed in the table are used if xparameter is not specified.

Parameter Namexparameter values
Pout, Phase, LS11, LS12, LS21, LS22Pin (default), Freq
S11, S12, S21, S22, NF, OIP3, VSWRIn, VSWROut, GammaIn, GammaOut, FMIN, GammaOPT, RNFreq
AM/AM, AM/PMAM

xformat is the format to use for the specified xparameter. No xformat specification is needed when xparameter is an operating condition.

The following table shows the xformat values that are available for the xparameter values listed in the preceding table, along with the default settings that are used if xformat is not specified.

xparameter valuesxformat values
PindBm (default), mW, W, dBW
Freq

THz, GHz, MHz, KHz, Hz

By default, xformat is chosen to provide the best scaling for the given xparameter values.

AMMagnitude (decibels) (default), Magnitude (linear)

condition1,value1, ..., conditionm,valuem are the optional condition/value pairs at which to plot the specified parameters. These pairs are usually operating conditions from a .p2d or .s2d file. For some parameters, you can specify a set of frequency or input power values at which to plot the specified parameter.

For example:

  • When plotting large-signal S-parameters as a function of input power, you can specify frequency points of interest using condition/value pairs.

  • When plotting large-signal S-parameters as a function of frequency, you can specify input power levels of interest using condition/value pairs.

  • When plotting parameters as a function of an operating condition, you can specify both frequency and input power values using condition/value pairs.

freq is the optional frequency value, in hertz, at which to plot the specified parameters.

pin is the optional input power value, in dBm, at which to plot the specified parameters.

If h has multiple operating conditions, such as from a .p2d or .s2d file, the polar method operates as follows:

  • If you do not specify any operating conditions as arguments to the polar method, then the method plots the parameter values based on the currently selected operating condition.

  • If you specify one or more operating conditions, the polar method plots the parameter values based on those operating conditions.

  • When you use an operating condition for the xparameter input argument, the method plots the parameters for all operating condition values.

Examples

collapse all

Create an amplifier object from |default.s2p|.
amp = read(rfckt.amplifier,'default.s2p');

Plot S11 on polar plot.

lineseries = polar(amp,'S11')
lineseries = 

  Line (S_{11}) with properties:

              Color: [0 0.4470 0.7410]
          LineStyle: '-'
          LineWidth: 0.5000
             Marker: 'none'
         MarkerSize: 6
    MarkerFaceColor: 'none'
              XData: [1x191 double]
              YData: [1x191 double]
              ZData: [1x0 double]

  Use GET to show all properties

Introduced before R2006a

Was this topic helpful?