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

pzoptions

極/零点プロット オプションの一覧を作成

説明

pzoptions コマンドを使用して、PZOptions オブジェクトを作成し、極-零点プロットの外観をカスタマイズします。また、このコマンドを使用して、極-零点プロットを作成する MATLAB^® セッションの [プロット基本設定] の設定をオーバーライドすることもできます。

作成

構文

plotoptions = pzoptions

plotoptions = pzoptions('cstprefs')

説明

plotoptions = pzoptions は、pzplot および iopzplot コマンドで使用するプロット オプションの既定のセットを返します。これらのオプションを使用して、コマンド ラインから極-零点プロットの外観をカスタマイズすることができます。同じ外観のプロットを生成するスクリプトを記述する場合、スクリプトを実行する MATLAB セッションの基本設定にかかわらず、この構文が有用です。

plotoptions = pzoptions('cstprefs') は、[Control System Toolbox™ および System Identification Toolbox™ の基本設定] エディターで選択したオプションでプロット オプションを初期化します。エディターの詳細については、ツールボックス基本設定を参照してください。プロット オプションを少しだけ変更し、その他は既定の基本設定を使用する場合、この構文が有用です。この構文を使用するスクリプトは、異なる基本設定のセッションで実行すると、異なる結果が生じる場合があります。

プロパティ

FreqUnits — 周波数の単位

'rad/s' (既定値)

周波数単位。以下のいずれかの値として指定。

• 'Hz'

• 'rad/s'

• 'rpm'

• 'kHz'

• 'MHz'

• 'GHz'

• 'rad/nanosecond'

• 'rad/microsecond'

• 'rad/millisecond'

• 'rad/minute'

• 'rad/hour'

• 'rad/day'

• 'rad/week'

• 'rad/month'

• 'rad/year'

• 'cycles/nanosecond'

• 'cycles/microsecond'

• 'cycles/millisecond'

• 'cycles/hour'

• 'cycles/day'

• 'cycles/week'

• 'cycles/month'

• 'cycles/year'

TimeUnits — 時間単位

'seconds' (既定値)

時間単位。次のいずれかの値として指定。

• 'nanoseconds'

• 'microseconds'

• 'milliseconds'

• 'seconds'

• 'minutes'

• 'hours'

• 'days'

• 'weeks'

• 'months'

• 'years'

また、入力システムの TimeUnit プロパティで指定された時間単位を使用する 'auto' も指定できます。異なる時間単位のある複数のシステムでは、最初のシステムの単位が使用されます。

ConfidenceRegionNumberSD — 信頼領域をプロットするために使用する標準偏差の数

1 (既定値) | スカラー

信頼領域をプロットするために使用する標準偏差の数。スカラーとして指定します。これは、同定されたモデルにのみ適用できます。

IOGrouping — 入出力ペアのグループ化

'none' (既定値) | 'inputs' | 'outputs' | 'all'

入出力 (I/O) ペアのグループ化。次のいずれかとして指定します。

• 'none' — 入出力のグループ化は行われません。

• 'inputs' — 入力のみをグループ化します。

• 'outputs' — 出力のみをグループ化します。

• 'all' — すべての I/O ペアをグループ化します。

InputLabels — 入力ラベルのスタイル

構造体 (既定値)

入力ラベルのスタイル。次のフィールドをもつ構造体として指定します。

• FontSize — フォント サイズ。0 より大きいスカラー値としてポイント単位で指定します。既定のフォント サイズは、特定のオペレーティング システムとロケールによって異なります。1 ポイントは 1/72 インチです。

• FontWeight — 文字の太さ。'Normal' または 'bold' として指定します。MATLAB は、FontWeight プロパティを使用して、システムで利用できるフォントから 1 つのフォントを選択します。すべてのフォントに太字があるとは限りません。そのため、太字フォントを指定しても標準フォントの太さと変わらない場合があります。

• FontAngle — 文字の傾斜。'Normal' または 'italic' として指定します。すべてのフォントに両方のフォント スタイルがあるとは限りません。そのため、イタリック フォントでも標準フォントと見た目が変わらない場合があります。

• Color — テキストの色。RGB 3 成分として指定します。既定の色は、RGB 3 成分 [0.4,0.4,0.4] を含む濃いグレーです。

• Interpreter — テキスト インタープリター。次の値のいずれかとして指定します。

  • 'tex' — TeX マークアップのサブセットを使用して文字を解釈します。これは、Interpreter の既定値です。

  • 'latex' — LaTeX マークアップを使用して文字を解釈します。

  • 'none' — リテラル文字を表示します。

OutputLabels — 出力ラベルのスタイル

構造体 (既定値)

出力ラベルのスタイル。次のフィールドをもつ構造体として指定します。

• FontSize — フォント サイズ。0 より大きいスカラー値としてポイント単位で指定します。既定のフォント サイズは、特定のオペレーティング システムとロケールによって異なります。1 ポイントは 1/72 インチです。

• FontWeight — 文字の太さ。'Normal' または 'bold' として指定します。MATLAB は、FontWeight プロパティを使用して、システムで利用できるフォントから 1 つのフォントを選択します。すべてのフォントに太字があるとは限りません。そのため、太字フォントを指定しても標準フォントの太さと変わらない場合があります。

• FontAngle — 文字の傾斜。'Normal' または 'italic' として指定します。すべてのフォントに両方のフォント スタイルがあるとは限りません。そのため、イタリック フォントでも標準フォントと見た目が変わらない場合があります。

• Color — テキストの色。RGB 3 成分として指定します。既定の色は、RGB 3 成分 [0.4,0.4,0.4] を含む濃いグレーです。

• Interpreter — テキスト インタープリター。次の値のいずれかとして指定します。

  • 'tex' — TeX マークアップのサブセットを使用して文字を解釈します。これは、Interpreter の既定値です。

  • 'latex' — LaTeX マークアップを使用して文字を解釈します。

  • 'none' — リテラル文字を表示します。

InputVisible — 入力の表示の切り替え

{'on'} (既定値) | {'off'} | cell 配列

入力の表示の切り替え。{'on'}、{'off'} または複数の要素をもつ cell 配列として指定します。

OutputVisible — 出力の表示の切り替え

{'on'} (既定値) | {'off'} | cell 配列

出力の表示の切り替え。{'on'}、{'off'} または複数の要素をもつ cell 配列として指定します。

Title — タイトルのテキストとスタイル

構造体 (既定値)

タイトルのテキストとスタイル。次のフィールドをもつ構造体として指定します。

• String — ラベル テキスト。文字ベクトルとして指定します。既定では、プロットは '極-零点配置図' というタイトルになります。

• FontSize — フォント サイズ。0 より大きいスカラー値としてポイント単位で指定します。既定のフォント サイズは、特定のオペレーティング システムとロケールによって異なります。1 ポイントは 1/72 インチです。

• FontWeight — 文字の太さ。'Normal' または 'bold' として指定します。MATLAB は、FontWeight プロパティを使用して、システムで利用できるフォントから 1 つのフォントを選択します。すべてのフォントに太字があるとは限りません。そのため、太字フォントを指定しても標準フォントの太さと変わらない場合があります。

• FontAngle — 文字の傾斜。'Normal' または 'italic' として指定します。すべてのフォントに両方のフォント スタイルがあるとは限りません。そのため、イタリック フォントでも標準フォントと見た目が変わらない場合があります。

• Color — テキストの色。RGB 3 成分として指定します。既定の色は、RGB 3 成分 [0,0,0] で指定された黒です。

• Interpreter — テキスト インタープリター。次の値のいずれかとして指定します。

  • 'tex' — TeX マークアップのサブセットを使用して文字を解釈します。これは、Interpreter の既定値です。

  • 'latex' — LaTeX マークアップを使用して文字を解釈します。

  • 'none' — リテラル文字を表示します。

XLabel — X 軸のラベル テキストとスタイル

構造体 (既定値)

X 軸のラベル テキストとスタイル。次のフィールドをもつ構造体として指定します。

• String — ラベル テキスト。文字ベクトルとして指定します。既定では、軸は時間単位 TimeUnits に基づいたタイトルになります。

• FontSize — フォント サイズ。0 より大きいスカラー値としてポイント単位で指定します。既定のフォント サイズは、特定のオペレーティング システムとロケールによって異なります。1 ポイントは 1/72 インチです。

• FontWeight — 文字の太さ。'Normal' または 'bold' として指定します。MATLAB は、FontWeight プロパティを使用して、システムで利用できるフォントから 1 つのフォントを選択します。すべてのフォントに太字があるとは限りません。そのため、太字フォントを指定しても標準フォントの太さと変わらない場合があります。

• FontAngle — 文字の傾斜。'Normal' または 'italic' として指定します。すべてのフォントに両方のフォント スタイルがあるとは限りません。そのため、イタリック フォントでも標準フォントと見た目が変わらない場合があります。

• Color — テキストの色。RGB 3 成分として指定します。既定の色は、RGB 3 成分 [0,0,0] で指定された黒です。

• Interpreter — テキスト インタープリター。次の値のいずれかとして指定します。

  • 'tex' — TeX マークアップのサブセットを使用して文字を解釈します。これは、Interpreter の既定値です。

  • 'latex' — LaTeX マークアップを使用して文字を解釈します。

  • 'none' — リテラル文字を表示します。

YLabel — Y 軸のラベル テキストとスタイル

構造体 (既定値)

Y 軸のラベル テキストとスタイル。次のフィールドをもつ構造体として指定します。

• String — ラベル テキスト。文字ベクトルの cell 配列として指定します。既定では、軸は時間単位 TimeUnits に基づいたタイトルになります。

• FontSize — フォント サイズ。0 より大きいスカラー値としてポイント単位で指定します。既定のフォント サイズは、特定のオペレーティング システムとロケールによって異なります。1 ポイントは 1/72 インチです。

• FontWeight — 文字の太さ。'Normal' または 'bold' として指定します。MATLAB は、FontWeight プロパティを使用して、システムで利用できるフォントから 1 つのフォントを選択します。すべてのフォントに太字があるとは限りません。そのため、太字フォントを指定しても標準フォントの太さと変わらない場合があります。

• FontAngle — 文字の傾斜。'Normal' または 'italic' として指定します。すべてのフォントに両方のフォント スタイルがあるとは限りません。そのため、イタリック フォントでも標準フォントと見た目が変わらない場合があります。

• Color — テキストの色。RGB 3 成分として指定します。既定の色は、RGB 3 成分 [0,0,0] で指定された黒です。

• Interpreter — テキスト インタープリター。次の値のいずれかとして指定します。

  • 'tex' — TeX マークアップのサブセットを使用して文字を解釈します。これは、Interpreter の既定値です。

  • 'latex' — LaTeX マークアップを使用して文字を解釈します。

  • 'none' — リテラル文字を表示します。

TickLabel — 目盛りラベルのスタイル

構造体 (既定値)

目盛りラベルのスタイル。次のフィールドをもつ構造体として指定。

• FontSize — フォント サイズ。0 より大きいスカラー値としてポイント単位で指定します。既定のフォント サイズは、特定のオペレーティング システムとロケールによって異なります。1 ポイントは 1/72 インチです。

• FontWeight — 文字の太さ。'Normal' または 'bold' として指定します。MATLAB は、FontWeight プロパティを使用して、システムで利用できるフォントから 1 つのフォントを選択します。すべてのフォントに太字があるとは限りません。そのため、太字フォントを指定しても標準フォントの太さと変わらない場合があります。

• FontAngle — 文字の傾斜。'Normal' または 'italic' として指定します。すべてのフォントに両方のフォント スタイルがあるとは限りません。そのため、イタリック フォントでも標準フォントと見た目が変わらない場合があります。

• Color — テキストの色。RGB 3 成分として指定します。既定の色は、RGB 3 成分 [0,0,0] で指定された黒です。

Grid — グリッド表示の切り替え

'off' (既定値) | 'on'

プロットでのグリッド表示の切り替え。'off' または 'on' として指定します。

GridColor — グリッド ラインの色

[0.15,0.15,0.15] (既定値) | RGB 3 成分

グリッド ラインの色。RGB 3 成分として指定します。既定の色は、RGB 3 成分 [0.15,0.15,0.15] で指定された薄いグレーです。

XLimMode — X 軸の範囲の選択モード

'auto' (既定値) | 'manual' | cell 配列

X 軸の範囲の選択モード。次のいずれかの値として指定します。

• 'auto' — 自動範囲選択を有効にします。プロットされたデータの全範囲に基づきます。

• 'manual' — 軸の範囲を手動で指定します。軸の範囲を指定するには、XLim プロパティを設定します。

YLimMode — Y 軸の範囲の選択モード

'auto' (既定値) | 'manual' | cell 配列

Y 軸の範囲の選択モード。次のいずれかの値として指定します。

• 'auto' — 自動範囲選択を有効にします。プロットされたデータの全範囲に基づきます。

• 'manual' — 軸の範囲を手動で指定します。軸の範囲を指定するには、YLim プロパティを設定します。

XLim — X 軸の範囲

'{[1,10]}' (既定値) | [min,max] 形式の 2 要素ベクトルの cell 配列 | cell 配列

X 軸の範囲。[min,max] 形式の 2 要素ベクトルの cell 配列として指定します。

YLim — Y 軸の範囲

'{[1,10]}' (既定値) | [min,max] 形式の 2 要素ベクトルの cell 配列 | cell 配列

Y 軸の範囲。[min,max] 形式の 2 要素ベクトルの cell 配列として指定します。

オブジェクト関数

iopzplot	追加のプロット カスタマイズ オプションを使用して I/O 組に対する極-零点配置図をプロットする
pzplot	追加のプロットのカスタマイズ オプションを使用した動的システム モデルの極-零点プロット

例

カスタム オプションを使用した極-零点プロット

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

$$sys\left(s\right)=\frac{2s^2+5s+1}{s^2+3s+5}.$$

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

plotoptions = pzoptions;

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

plotoptions.Grid = 'on';

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

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

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

バージョン履歴

R2008a で導入

参考

getoptions | iopzplot | pzplot | setoptions

トピック

• ツールボックス基本設定