メインコンテンツまでスキップ

SParameters.plot

概要​

Sパラメータ（散乱パラメータ）の振幅を周波数に対してグラフ表示します。

指定した入力ポートと出力ポートにおける反射特性や伝送特性の周波数依存性を表示します。複数のポートを指定することで、異なるSパラメータの周波数特性を同じグラフ上で比較できます。

Sパラメータの振幅はデシベル（dB）、周波数はギガヘルツ（GHz）で表示されます。また、AAA（Adaptive Antoulas–Anderson）アルゴリズムによる有理関数近似を使用して、解析周波数点の間の応答を補間することもできます。

構文​

obj.plot()obj.plot(port_out, port_in)obj.plot(port_out, port_in, interpolate=True)

obj

obj 複素Sパラメータと対応する周波数データを保持する SParameters オブジェクト。

obj.plot()

obj.plot() すべてのSパラメータの周波数特性をグラフ表示します。

obj.plot(port_out, port_in)

obj.plot(port_out, port_in) 指定した出力ポートと入力ポートに対応するSパラメータをグラフ表示します。

obj.plot(port_out, port_in, interpolate=True)

obj.plot(port_out, port_in, interpolate=True) 指定したSパラメータにAAAアルゴリズムによる有理関数近似を適用し、補間した周波数特性をグラフ表示します。

入力引数​

NameTypeRequiredDefaultDescription

port_out

int | list[int] | str

Optional

all

グラフ表示する出力ポートの番号。 "all" を指定すると、すべての出力ポートが選択されます。 ポート番号は1から始まります。

port_in

int | list[int] | str

Optional

all

グラフ表示する入力ポートの番号。 "all" を指定すると、すべての入力ポートが選択されます。 ポート番号は1から始まります。

interpolate

bool

Optional

No

グラフ表示する前に、複素SパラメータにAAAアルゴリズムによる 有理関数近似を適用して補間します。 有効にすると、等間隔の1001点の周波数で補間結果が計算されます。

使用例​

# すべてのSパラメータをグラフ表示
sparams.plot()

# ポート1の反射係数をグラフ表示
sparams.plot(port_out=1, port_in=1)

# AAA補間を使用してS11とS21を比較
sparams.plot(port_out=[1, 2], port_in=1, interpolate=True)

注意事項​

周波数はGHz、Sパラメータの振幅は 20*log10(abs(S)) によって計算したdB値で表示されます。

ポート番号は1から始まります。複数の出力ポートと入力ポートを指定した場合、選択したポートのすべての組み合わせに対応するSパラメータがグラフ表示されます。

interpolate=True を指定すると、複素SパラメータにAAAアルゴリズムによる有理関数近似が適用されます。補間結果は、データに含まれる最小周波数から最大周波数までの範囲を等間隔に分割した1001点で計算されます。

補間を行うには、周波数範囲がゼロでないことが必要です。

エラー・例外​

エラー・例外一覧
hado:solutionmessage:InvalidPortSParametersPlot
Condition

port_out または port_in に無効な値が指定された場合。

Resolution

整数、整数のリスト、または文字列 "all" を指定してください。

hado:solutionmessage:InvalidPortSParametersType
Condition

ポート番号に真偽値（Boolean）が指定された場合。

Resolution

ポート番号には真偽値ではなく整数を指定してください。

hado:solutionmessage:InvalidPortIndexSParameters
Condition

指定したポート番号が、使用可能なポート番号の範囲外である場合。

Resolution

1からSParametersオブジェクトのポート数までの番号を指定してください。

hado:solutionmessage:InvalidSParametersInterpolationDataPoint
Condition

周波数範囲がゼロの状態で補間を実行しようとした場合。

Resolution

補間を有効にする前に、周波数範囲がゼロでないデータを指定してください。

関連API​