16/1/2015

Plot specified circuit object parameters on Smith chart - MATLAB smith

smith
Plot specified circuit object parameters on Smith chart

Syntax
smith(hnet,i,j)
hsm = smith(hnet,i,j)
[lineseries,hsm] = smith(h,parameter1,...,parametern,type)
[lineseries,hsm] = smith(h,'parameter1',...,'parametern',
type,xparameter,xformat,'condition1',value1,..., 'conditionm',valuem,
'freq',freq,'pin',pin)

Description
smith(hnet,i,j)plotsthe(i,j)thparameterofhnetonaSmithChart.hnetisanRFToolboxnetwork
parameterobject.Theinputsiandjarepositiveintegerswhosevalueislessthanorequalto2forhybrid
andhybridgparameterobjects,orlessthanorequaltohnet.NumPortsforABCD,S,Y,orZparameter

objects.
hsm = smith(hnet,i,j)returnsthelineserieshandleusedtocreatetheplot,hsm.
[lineseries,hsm] = smith(h,parameter1,...,parametern,type)plotsthenetworkparameters
parameter1,...,parameternfromtheobjecthonaSmithchart.histhehandleofacircuit(rfckt)or
data(rfdata)objectthatcontainsnportnetworkparameterdata.typeisastringthatspecifiesthetypeof

Smithchart:
'z'(default)
'y'
'zy'

Typelistparam(h)togetalistofvalidparametersforacircuitobjecth.
Note:Forallcircuitobjectsexceptthosethatcontaindatafromadatafile,youmustusetheanalyze
methodtoperformafrequencydomainanalysisbeforecallingsmith.
[lineseries,hsm] = smith(h,'parameter1',...,'parametern',
type,xparameter,xformat,'condition1',value1,..., 'conditionm',valuem,
'freq',freq,'pin',pin)plotsthespecifiedparametersatthespecifiedoperatingconditionsfortheobject
h.
xparameteristheindependentvariabletouseinplottingthespecifiedparameters.Severalxparameter
valuesareavailableforallobjects.Whenyouimport2portrfckt.amplifier,rfckt.mixer,or
rfdata.dataobjectspecificationsfroma.p2dor.s2dfile,youcanalsospecifyanyoperatingconditions

fromthefilethathavenumericvalues,suchasbias.
Thefollowingtableshowsthemostcommonlyavailableparametersandthecorrespondingxparameter
values.Thedefaultsettingslistedinthetableareusedifxparameterisnotspecified.
ParameterName

xparametervalues

Pout,Phase,LS11,LS12,LS21,LS22

Pin(default),Freq

S11,S12,S21,S22,NF,IIP3,OIP3,VSWRIn,
VSWROut,GammaIn,GammaOut,FMIN,GammaOPT,RN

Freq

http://www.mathworks.com/help/rf/smith.html

1/4

16/1/2015

Plot specified circuit object parameters on Smith chart - MATLAB smith

AM/AM,AM/PM

AM

xformatistheformattouseforthespecifiedxparameter.Noxformatspecificationisneededwhen
xparameterisanoperatingcondition.

Thefollowingtableshowsthexformatvaluesthatareavailableforthexparametervalueslistedinthe
precedingtable,alongwiththedefaultsettingsthatareusedifxformatisnotspecified.
xparametervalues

xformatvalues

Pin

dBm(default),mW,W,dBW

Freq

THz,GHz,MHz,KHz,Hz

Bydefault,xformatischosentoprovidethebest
scalingforthegivenxparametervalues.
Magnitude (decibels)(default),Magnitude
(linear)

AM

condition1,value1,...,conditionm,valuemaretheoptionalcondition/valuepairsatwhichtoplotthe
specifiedparameters.Thesepairsareusuallyoperatingconditionsfroma.p2dor.s2dfile.Forsome

parameters,youcanspecifyasetoffrequencyorinputpowervaluesatwhichtoplotthespecified
parameter.
Forexample:
WhenplottinglargesignalSparametersasafunctionofinputpower,youcanspecifyfrequencypoints
ofinterestusingcondition/valuepairs.
WhenplottinglargesignalSparametersasafunctionoffrequency,youcanspecifyinputpowerlevels
ofinterestusingcondition/valuepairs.
Whenplottingparametersasafunctionofanoperatingcondition,youcanspecifybothfrequencyand
inputpowervaluesusingcondition/valuepairs.
freqistheoptionalfrequencyvalue,inhertz,atwhichtoplotthespecifiedparameters.
pinistheoptionalinputpowervalue,indBm,atwhichtoplotthespecifiedparameters.

Ifhhasmultipleoperatingconditions,suchasfroma.p2dor.s2dfile,thesmithmethodoperatesas
follows:
Ifyoudonotspecifyanyoperatingconditionsasargumentstothesmithmethod,thenthemethodplots
theparametervaluesbasedonthecurrentlyselectedoperatingcondition.
Ifyouspecifyoneormoreoperatingconditions,thesmithmethodplotstheparametervaluesbasedon
thoseoperatingconditions.
Whenyouuseanoperatingconditionforthexparameterinputargument,themethodplotsthe
parametersforalloperatingconditionvalues.
Note:Usethesmithchartfunctiontoplotnetworkparametersthatarenotpartofacircuit(rfckt)
ordata(rfdata)object,butarespecifiedasvectordata.

ChangingPropertiesofthePlottedLines
http://www.mathworks.com/help/rf/smith.html

2/4

16/1/2015

Plot specified circuit object parameters on Smith chart - MATLAB smith

Thesmithmethodreturnslineseries,acolumnvectorofhandlesto lineseriesobjects,onehandleper
plottedline.UsetheChartLinePropertiesfunctiontochangethepropertiesoftheselines.

ChangingPropertiesoftheSmithChart
ThesmithmethodreturnsthehandlehsmoftheSmithchart.Usethepropertieslistedbelowtochangethe
propertiesofthechartitself.

Properties
smithcreatestheplotusingthedefaultpropertyvaluesofaSmithchart.Use
set(hsm,'PropertyName1',PropertyValue1,...)tochangethepropertyvaluesofthechart.Use
get(hsm)togetthepropertyvalues.

ThistablelistsallpropertiesyoucanspecifyforaSmithchartobjectalongwithunits,validvalues,anda
descriptionsoftheiruse.
PropertyName

Description

Units,Values

Color

LinecolorforaZorYSmith
chart.ForaZYSmithchart,theZ
linecolor.

ColorSpec.Defaultis
[0.4 0.4 0.4](darkgray).

LabelColor

Colorofthelinelabels.

ColorSpec.Defaultis[0 0 0]

(black).
LabelSize

Sizeofthelinelabels.

FontSize.Defaultis10.Seethe

AnnotationTextBoxProperties
referencepageformore
informationonspecifyingfontsize.
LabelVisible

Visibilityofthelinelabels.

'on'(default)or'off'

LineType

LinespecforaZorYSmith
chart.ForaZYSmithchart,theZ
linespec.

LineSpec.Defaultis'-'(solid

LineWidth

LinewidthforaZorYSmith
chart.ForaZYSmithchart,theZ
linewidth.

Numberofpoints.Defaultis0.5.

SubColor

TheYlinecolorforaZYSmith
chart.

ColorSpec.Defaultis
[0.8 0.8 0.8](mediumgray).

SubLineType

TheYlinespecforaZYSmith
chart.

LineSpec.Defaultis':'(dotted

SubLineWidth

TheYlinewidthforaZYSmith
chart.

Numberofpoints.Defaultis0.5.

Type

TypeofSmithchart.

'z'(default),'y',or'zy'

Value

Tworowmatrix.Row1specifies
thevaluesoftheconstant
resistanceandreactancelines
thatappearonthechart.Forthe

2bynmatrix.Defaultis[0.2000

http://www.mathworks.com/help/rf/smith.html

line).

line).

0.5000 1.0000 2.0000 5.0000;

1.0000 2.0000 5.0000 5.0000
30.0000]
3/4

16/1/2015

Plot specified circuit object parameters on Smith chart - MATLAB smith

constantresistance/reactance
lines,eachelementinRow2
specifiesthevalueoftheconstant
reactance/resistancelineatwhich
thecorrespondinglinespecifiedin
Row1ends.

SeeAlso
analyze|calculate|circle|getz0|listformat|listparam|loglog|plot|plotyy|polar|read|
restore|semilogx|semilogy|write

http://www.mathworks.com/help/rf/smith.html

4/4