Main Content

このページの内容は最新ではありません。最新版の英語を参照するには、ここをクリックします。

pzplot

追加のプロットのカスタマイズ オプションを使用した動的システム モデルの極-零点プロット

説明

pzplot では、pzmap よりも広範囲のプロット カスタマイズ オプションを使用して、極-零点配置図をプロットできます。pzplot を使用してプロット ハンドルを取得し、それを使用して軸座標のラベル、軸座標の範囲、軸座標の単位の変更など、プロットをカスタマイズできます。pzplot を使用して、座標軸ハンドルで表される既存の座標軸のセット上に極-零点プロットを描画することもできます。プロット ハンドルを使用して既存のプロットをカスタマイズするには、次のようにします。

  1. プロット ハンドルを取得

  2. getoptions を使用してオプション セットを取得

  3. setoptions を使用してプロットを更新し、必要なオプションを変更

詳細については、コマンド ラインからの応答プロットのカスタマイズ (Control System Toolbox)を参照してください。既定のオプションを使用して極-零点配置図を作成するか、極-零点データを抽出するには、pzmap を使用します。

h = pzplot(sys) は、動的システム モデル sys の極と伝達零点をプロットし、プロットのプロット ハンドル h を返します。xo は極と零点をそれぞれ示します。

h = pzplot(sys1,sys2,...,sysN) は、1 つのプロットに複数のモデルの極と伝達零点を表示します。モデルごとに別々の色を指定できます。

h = pzplot(sys1,LineSpec1,...,sysN,LineSpecN) は各システムのプロットに対するライン スタイル、マーカー タイプ、および色を設定します。この構文を使用するには、すべてのシステムで入力数と出力数が同じでなければなりません。

h = pzplot(ax,...) は、現在の軸 gca ではなく、ax で指定される座標軸にプロットします。

h = pzplot(...,plotoptions) は、plotoptions で指定されたオプションをもつ極と伝達零点をプロットします。プロットのプロパティを変更する方法の詳細については、プロットをカスタマイズする方法 (Control System Toolbox)を参照してください。

すべて折りたたむ

次の伝達関数で表される連続時間システムの極と零点をプロットします。

sys(s)=2s2+5s+1s2+3s+5.

sys = tf([2 5 1],[1 3 5]);
h = pzplot(sys);
grid on

グリッドをオンにすると、一定の減衰比 (zeta) と一定の固有振動数 (wn) が線で表示されます。このシステムには、o でマークされる 2 つの実数零点がプロット上にあります。このシステムには x でマークされる複素数の極の組もあります。

プロットのタイトルの色を変更します。これを行うには、プロット ハンドル h を使用します。

p = getoptions(h); 
p.Title.Color = [1,0,0]; 
setoptions(h,p);

この例では、伝達関数モデルの 3 行 1 列の配列を読み込みます。

load('tfArrayMargin.mat','sys');
size(sys)
3x1 array of transfer functions.
Each model has 1 outputs and 1 inputs.

モデル配列の極と零点をプロットします。各モデルの色を定義します。この例では、配列の最初のモデルに赤、2 番目のモデルに緑、3 番目のモデルに青を使用します。

pzplot(sys(:,:,1),'r',sys(:,:,2),'g',sys(:,:,3),'b');

次の伝達関数で表される連続時間システムの極と零点を、カスタム オプション セットを使ってプロットします。

sys(s)=2s2+5s+1s2+3s+5.

pzoptions を使用してカスタム オプション セットを作成します。

plotoptions = pzoptions;

この例では、グリッドを可視にするよう指定します。

plotoptions.Grid = 'on';

指定したオプションを使用して伝達関数の極-零点配置図を作成します。

h = pzplot(tf([2 5 1],[1 3 5]),plotoptions);

グリッドをオンにすると、一定の減衰比 (zeta) と一定の固有振動数 (wn) が線で表示されます。このシステムには、プロット上に o でマークされる 2 つの実数零点があります。このシステムには x でマークされる複素数の極の組もあります。

入力引数

すべて折りたたむ

動的システム。SISO または MIMO 動的システム モデル、あるいは SISO または MIMO 動的システム モデルの配列として指定します。使用できる動的システムには、tf (Control System Toolbox)zpk (Control System Toolbox)ss (Control System Toolbox) モデルなどの連続時間または離散時間の数値 LTI モデルが含まれます。

sys が一般化状態空間モデル genss または不確かさをもつ状態空間モデル uss である場合、pzplot は、sys の現在の値またはノミナル値の極と伝達零点を返します。sys がモデルの配列である場合、pzplot は、配列の各モデルの極と零点を、同一の図上にプロットします。

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

例: '--or' は円形マーカー付きの赤い破線

ライン スタイル説明
-実線
--破線
:点線
-.一点鎖線
マーカー説明
'o'
'+'プラス記号
'*'アスタリスク
'.'
'x'x 印
'_'水平線
'|'垂直線
's'正方形
'd'菱形
'^'上向き三角形
'v'下向き三角形
'>'右向き三角形
'<'左向き三角形
'p'星形五角形
'h'星形六角形
説明

y

黄色

m

マゼンタ

c

シアン

r

g

b

w

k

座標軸ハンドル。axes オブジェクトとして指定します。axes オブジェクトを指定しない場合、pzplot は現在の座標軸 gca を使用してシステムの極と零点をプロットします。

極-零点プロット オプション。オプション オブジェクトとして指定します。使用できるプロット オプションの一覧は、pzoptions を参照してください。

出力引数

すべて折りたたむ

極-零点プロット オプション ハンドル。スカラーとして返されます。h を使用して極-零点プロットのプロパティをクエリし変更します。getoptionssetoptions コマンドを使ってプロットをカスタマイズするためにこのハンドルを使用することができます。

ヒント

  • sgrid または zgrid を用いて、減衰比および固有振動数が一定のラインを s- 平面または z 平面にプロットすることができます。

バージョン履歴

R2006a より前に導入