メインコンテンツ

rlocusplot

R2026b

動的システムの根軌跡プロット

    説明

    rlocusplot 関数は、動的システム モデルの根軌跡をプロットします。プロットをカスタマイズするには、RLocusPlot オブジェクトを返し、ドット表記を使用して変更します。詳細については、コマンド ラインでの線形解析プロットのカスタマイズを参照してください。

    フィードバック ゲインと複素根の位置を取得するには、rlocus 関数を使用します。

    rlocusplot(sys) は、SISO 動的システム モデル sys の根軌跡をプロットします。

    プロットが滑らかになるように、rlocusplot 関数は自動的に正のフィードバック ゲインの集合を選択します。

    例

    rlocusplot(sys1,sys2,...,sysN) は、複数のモデルの根軌跡を単一のプロットに描画します。

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

    rlocusplot(___,k) は、k で指定されたフィードバック ゲインの応答をプロットします。周波数範囲または周波数のベクトルを指定できます。k は、前述の構文の任意の入力引数の組み合わせで使用できます。

    rlocusplot(___,plotoptions) は、plotoptions で指定されたプロット オプションを使用して根軌跡をプロットします。plotoptions に指定する設定は、現在の MATLAB® セッションのプロット基本設定をオーバーライドします。

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

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

    • 次の名前と値の引数は、他の入力引数で指定された値をオーバーライドします。

      • FeedbackGainSpec — w を使用して指定された周波数値をオーバーライドします。

      • Color — LineSpec を使用して指定された色をオーバーライドします。

      • MarkerStyle — LineSpec を使用して指定されたマーカー スタイルをオーバーライドします。

      • LineStyle — LineSpec を使用して指定されたライン スタイルをオーバーライドします。

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

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

    例

    すべて折りたたむ

    SISO 動的システム モデルの根軌跡をプロットします。

    sys = tf([2 5 1],[1 2 3]);
    rlp = rlocusplot(sys);

    MATLAB figure

    入力引数

    すべて折りたたむ

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

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

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

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

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

    • idtf (System Identification Toolbox)、idss (System Identification Toolbox)、idproc (System Identification Toolbox) モデルなどの同定された LTI モデル。同定されたモデルを使用するには System Identification Toolbox™ ソフトウェアが必要です。

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

    ライン スタイル、マーカー、色。記号を含む string または文字ベクトルとして指定します。記号は任意の順序で表記できます。3 つの特性をすべて指定する必要はありません。たとえば、マーカーを指定してライン スタイルを省略した場合、プロットはラインなしでマーカーのみを表示します。

    例: '--or' は、円マーカーをもつ赤い破線です。

    ライン スタイル説明
    "-"実線
    "--"破線
    ":"点線
    "-."一点鎖線
    マーカー説明
    "o"円
    "+"プラス記号
    "*"アスタリスク
    "."点
    "x"x 印
    "_"水平線
    "|"垂直線
    "s"正方形
    "d"菱形
    "^"上向き三角形
    "v"下向き三角形
    ">"右向き三角形
    "<"左向き三角形
    "p"星形五角形
    "h"星形六角形
    色説明
    "r"赤
    "g"緑
    "b"青
    "c"シアン
    "m"マゼンタ
    "y"黄色
    "k"黒
    "w"白

    極の位置に関連するフィードバック ゲイン値。ベクトルとして指定します。フィードバック ゲインは極の軌跡を定義し、それにより根軌跡プロットの形状に影響します。

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

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

    • Figure

    • TiledChartLayout

    • UIFigure

    • UIGridLayout

    • UIPanel

    • UITab

    名前と値の引数

    すべて折りたたむ

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

    例: rlocusplot(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 値として保存されます。

    マーカー スタイル。次のいずれかの値として指定します。名前と値の引数を使用してマーカー スタイルを指定すると、LineSpec を使用して指定したマーカー スタイルがオーバーライドされます。

    マーカー説明
    "none"マーカーなし
    "o"円
    "+"プラス記号
    "*"アスタリスク
    "."点
    "x"x 印
    "_"水平線
    "|"垂直線
    "s"正方形
    "d"菱形
    "^"上向き三角形
    "v"下向き三角形
    ">"右向き三角形
    "<"左向き三角形
    "p"星形五角形
    "h"星形六角形

    プロットの色。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

    ライン スタイル。次のいずれかの値として指定します。名前と値の引数を使用してライン スタイルを指定すると、LineSpec を使用して指定したライン スタイルがオーバーライドされます。

    ライン スタイル説明
    "-"実線
    "--"破線
    ":"点線
    "-."一点鎖線
    "none"ラインなし

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

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

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

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

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

    出力引数

    すべて折りたたむ

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

    詳細

    すべて折りたたむ

    バージョン履歴

    R2006a より前に導入

    すべて展開する