iopzplot

動的システムの入出力ペアの極-零点配置図をプロットする

ページ内をすべて折りたたむ

    構文

    iopzplot(sys)
    iopzplot(sys1,sys2,...,sysN)
    iopzplot(sys1,ColorSpec1,...,sysN,ColorSpecN)
    iopzplot(___,plotoptions)
    iopzplot(___,Name=Value)
    iopzplot(parent,___)
    iopzp = iopzplot(___)

    説明

    iopzplot 関数は、動的システム モデルの入出力ペアの極-零点配置図をプロットします。プロットをカスタマイズするには、IOPZPlot オブジェクトを返し、ドット表記を使用して変更します。詳細については、コマンド ラインでの線形解析プロットのカスタマイズ (Control System Toolbox)を参照してください。

    極と零点の位置を取得するには、iopzmap 関数を使用します。

    iopzplot(sys) は、動的システム モデル sys の各入力/出力ペアの極と零点をプロットします。プロットでは、極と零点が x と o でそれぞれ表されます。

    例

    iopzplot(sys1,sys2,...,sysN) は、複数のモデルの極と零点を 1 つのプロットに表示します。

    例

    iopzplot(sys1,ColorSpec1,...,sysN,ColorSpecN) は、各システムのプロットのライン スタイル、マーカー タイプ、および色を設定します。

    例

    iopzplot(___,plotoptions) は、plotoptions で指定されたプロット オプションを使用して極と零点をプロットします。plotoptions に指定する設定は、現在の MATLAB® セッションのプロット基本設定をオーバーライドします。plotoptions は、前述の構文の任意の入力引数の組み合わせで使用できます。

    例

    iopzplot(___,Name=Value) は、1 つ以上の名前と値の引数を使用して応答プロパティを指定します。たとえば、iopzplot(sys,MarkerSize=10) は、極と零点のマーカー サイズを 10 に設定します。 (R2026a 以降)

    複数のシステムの応答をプロットする場合、指定した名前と値の引数はすべての応答に適用されます。

    名前と値の引数 Color は、ColorSpec 引数を使用して指定された色をオーバーライドします。

    iopzplot(parent,___) は、Figure や TiledChartLayout などの指定された親グラフィックス コンテナーに極と零点をプロットし、Parent プロパティを設定します。指定された開いている Figure にプロットを作成する場合、または App Designer でアプリを作成する場合に、この構文を使用します。

    iopzp = iopzplot(___) はプロットと零点をプロットし、対応するチャート オブジェクトを返します。応答プロットの外観と動作をカスタマイズするには、ドット表記を使用してチャート オブジェクトのプロパティを変更します。

    例

    すべて折りたたむ

    この例では次を使用します。

    ライブ スクリプトを開く

    2 つの入力、2 つの出力の動的システムの極/零点配置図を作成します。

    sys = rss(3,2,2);
ip = iopzplot(sys);

    MATLAB figure

    既定では、プロットは各 I/O ペアの極と零点をそれぞれの軸に表示します。チャート オブジェクトを変更して、すべての I/O を 1 つの軸に表示します。

    ip.IOGrouping = "all";

    MATLAB figure

    この例では次を使用します。

    ライブ スクリプトを開く

    入出力データから推定された 6 次状態空間モデルの極と零点を表示します。プロット ハンドルを使用して、同定されたモデルの極と零点の位置の信頼区間を表示します。

    load iddata1
sys = ssest(z1,6,ssestOptions('focus','simulation'));
h = iopzplot(sys);
showConfidence(h)

    MATLAB figure

    1-σ 信頼領域内に、複素零点と位置がオーバーラップしている複素共役極のペアが 1 組以上存在します。これはそれらの冗長性を示しています。したがって、より低次の (4 次) モデルの方が、与えられたデータに対してより堅牢である可能性があります。

    sys2 = ssest(z1,4,ssestOptions('focus','simulation'));
h = iopzplot(sys,sys2);
showConfidence(h)
legend('6th-order','4th-order')
axis([-20, 10 -30 30])

    MATLAB figure

    4 次モデル sys2 では、極-零点の位置の変動性が低減されています。

    入力引数

    すべて折りたたむ

    動的システム。SISO または MIMO 動的システム モデルか、動的システム モデルの配列として指定します。使用できる動的システムのタイプには次のようなものがあります。

    • tf (Control System Toolbox)、zpk (Control System Toolbox)、ss (Control System Toolbox) モデルなどの連続時間または離散時間の数値 LTI モデル。

    • sparss (Control System Toolbox) モデルまたは mechss (Control System Toolbox) モデルなどのスパース状態空間モデル。

    • genss (Control System Toolbox) や uss (Robust Control Toolbox) モデルなどの一般化された、あるいは不確かさをもつ LTI モデル。不確かさをもつモデルを使用するには Robust Control Toolbox™ ソフトウェアが必要です。

      • 調整可能な制御設計ブロックの場合、関数は応答をプロットするモデルをその現在の値で評価します。

      • 不確かさをもつ制御設計ブロックの場合、関数はモデルのノミナル値とランダム サンプルをプロットします。

    • idtf、idss、idproc モデルなどの同定された LTI モデル。

    sys がモデルの配列である場合、プロットは同じ座標軸上に配列のすべてのモデルの応答を表示します。

    色。次の値のいずれかとして指定します。

    色説明
    "r"赤
    "g"緑
    "b"青
    "c"シアン
    "m"マゼンタ
    "y"黄色
    "k"黒
    "w"白

    極-零点プロット オプション。pzoptions オブジェクトとして指定します。これらのオプションを使用して PZ プロットの外観をカスタマイズできます。plotoptions に指定する設定は、現在の MATLAB セッションの基本設定をオーバーライドします。

    親グラフィックス コンテナー。次のいずれかのオブジェクトとして指定します。

    • Figure

    • TiledChartLayout

    • UIFigure

    • UIGridLayout

    • UIPanel

    • UITab

    名前と値の引数

    すべて折りたたむ

    オプションの引数のペアを Name1=Value1,...,NameN=ValueN として指定します。ここで、Name は引数名で、Value は対応する値です。名前と値の引数は他の引数の後に指定しなければなりませんが、ペアの順序は重要ではありません。

    例: iopzplot(sys,LegendDisplay="off") は、プロット凡例から sys の応答を非表示にします。

    応答名。string または文字ベクトルとして指定します。string として保存されます。

    応答の可視性。次の logical オン/オフ値のいずれかとして指定します。

    • "on"、1、または true — 応答をプロットに表示します。

    • "off"、0、または false — 応答をプロットに表示しません。

    値は、matlab.lang.OnOffSwitchState 型の on/off の logical 値として保存されます。

    凡例に応答をリストするオプション。次の logical オン/オフ値のいずれかとして指定します。

    • "on"、1、または true — 凡例に応答をリストします。

    • "off"、0、または false — 凡例に応答をリストしません。

    値は、matlab.lang.OnOffSwitchState 型の on/off の logical 値として保存されます。

    プロットの色。RGB 3 成分または 16 進数のカラー コードとして指定します。RGB 3 成分として保存されます。名前と値の引数を使用して色を指定すると、LineSpec を使用して指定した色がオーバーライドされます。

    一般的な色を名前で指定することもできます。次の表に、そうした色とそれに対応する RGB 3 成分および 16 進数のカラー コードをリストします。

    色の名前RGB 3 成分16 進数のカラー コード

    "red" または "r"

    		[1 0 0]#FF0000

    "green" または "g"

    		[0 1 0]#00FF00

    "blue" または "b"

    		[0 0 1]#0000FF

    "cyan" または "c"

    		[0 1 1]#00FFFF

    "magenta" または "m"

    		[1 0 1]#FF00FF

    "yellow" または "y"

    		[1 1 0]#FFFF00

    "black" または "k"

    		[0 0 0]#000000

    "white" または "w"

    		[1 1 1]#FFFFFF

    マーカー サイズ。正のスカラーとして指定します。

    ラインの幅。正のスカラーとして指定します。

    系列インデックス。正の整数または "none" として指定します。

    既定では、SeriesIndex プロパティは、応答がチャートに追加された順序に対応する数値です (1 から始まります)。MATLAB はこの数値を使用して、応答に色、ライン スタイル、またはマーカーを自動的に割り当てるためのインデックスを計算します。チャート内の応答で SeriesIndex の数値が同じであるものは、色、ライン スタイル、およびマーカーも同じになります。

    SeriesIndex 値 "none" は、応答がインデックス方式を利用しないことを示します。

    出力引数

    すべて折りたたむ

    チャート オブジェクト。IOPZPlot オブジェクトとして返されます。プロットの外観と動作をカスタマイズするには、ドット表記を使用してこのオブジェクトのプロパティを変更します。詳細については、IOPZPlot Properties (Control System Toolbox) を参照してください。

    詳細

    すべて折りたたむ

    ヒント

    • iopzplot を使用して作成されたプロットは、string 配列または文字ベクトルの cell 配列として指定された複数行のタイトルやラベルをサポートしません。複数行のタイトルやラベルを指定するには、newline 文字を含む単一の string を使用します。

      iopzplot(sys)
title("first line" + newline + "second line");

    バージョン履歴

    R2012a で導入

    すべて展開する

    参考

    | | |

    トピック