Main Content

bodeoptions

ボード線図オプションの一覧を作成する

説明

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

作成

説明

plotoptions = bodeoptions は、bodeplot (Control System Toolbox) コマンドで使用するプロット オプションの既定のセットを返します。これらのオプションを使用して、コマンド ラインからボード線図の外観をカスタマイズすることができます。同じ外観のプロットを生成するスクリプトを記述する場合、スクリプトを実行する MATLAB セッションの設定にかかわらず、この構文が有用です。

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

プロパティ

すべて展開する

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

  • 'Hz'

  • 'rad/second'

  • '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'

周波数スケール。'log' または 'linear' として指定します。

振幅単位。'dB' または絶対値 'abs' として指定します。

振幅のスケール。'log' または 'linear' として指定します。

振幅プロットの表示と非表示の切り替え。'on' または 'off' として指定します。

振幅の下限モード。'auto' または 'manual' として指定します。

振幅の下限値。スカラーとして指定します。

位相単位。それぞれ度またはラジアンに変更する 'deg' または 'rad' として指定します。

位相プロットの表示と非表示の切り替え。'on' または 'off' として指定します。

位相ラッピングの有効化。'on' または 'off' として指定します。PhaseWrapping'on' に設定すると、PhaseWrappingBranch プロパティで指定された値で、プロットによって累積位相がラップされます。

PhaseWrapping'on' に設定された場合に、プロットによって累積位相がラップされる位相ラッピング値。既定では、位相は [-180°,180°] の範囲にラップします。

位相の一致を有効化。'on' または 'off' として指定します。PhaseMatching を 'on' にすると、位相は PhaseMatchingFreq で指定された周波数で PhaseMatchingValue で指定された値に一致します。

位相の一致の周波数。スカラーとして指定します。

位相の一致の応答値。スカラーとして指定します。

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

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

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

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

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

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

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

  • 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' — リテラル文字を表示します。

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

  • 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' — リテラル文字を表示します。

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

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

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

  • 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' — リテラル文字を表示します。

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

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

  • 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' — リテラル文字を表示します。

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

  • String — ラベル テキスト。文字ベクトルの cell 配列として指定します。既定では、軸のラベルは '振幅' および '位相' をもつ 1 行 2 列の cell 配列です。

  • 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' — リテラル文字を表示します。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

オブジェクト関数

bode周波数応答、または振幅と位相データのボード線図
bodeplot追加のプロット カスタマイズ オプションを使用してボード周波数応答をプロットする
getoptionsプロットのオプション ハンドル、またはプロットのオプション プロパティを返す
setoptionsプロット オプション ハンドルまたはプロットのオプション プロパティを設定する

すべて折りたたむ

この例では、タイトルに 15 ポイントの赤いテキストを使用するボード線図を作成します。このプロットは、それを生成する MATLAB セッションの設定にかかわらず、外観が同じになります。

最初に、bodeoptions を使用して既定のオプション セットを作成します。

opts = bodeoptions;

次に、オプション セット opts の必要なプロパティを変更します。

opts.Title.FontSize = 15;
opts.Title.Color = [1 0 0];
opts.FreqUnits = 'Hz';

次に、オプション セット opts を使用してボード線図を作成します。

bodeplot(tf(1,[1,1]),opts);

Figure contains 2 axes objects. Axes object 1 contains an object of type line. This object represents untitled1. Axes object 2 contains an object of type line. This object represents untitled1.

opts は固定のオプション セットで開始されるため、プロットの結果は MATLAB セッションのツールボックス基本設定とは独立したものになります。

位相プロットを抑制し、周波数の単位に既定のラジアン/秒ではなく Hz を使用するボード線図を作成します。それ以外は、プロットはツールボックス基本設定に保存されている設定を使用します。

最初に、ツールボックス基本設定に基づいてオプション セットを作成します。

opts = bodeoptions('cstprefs');

オプション セットのプロパティを変更します。

opts.PhaseVisible = 'off';
opts.FreqUnits = 'Hz';

このオプションを使用してプロットを作成します。

h = bodeplot(tf(1,[1,1]),opts);

Figure contains an axes object. The axes object contains an object of type line. This object represents untitled1.

独自のツールボックス基本設定によっては、得られるプロットはこのプロットの外観と異なる場合があります。明示的に設定したプロパティ (この例では、PhaseVisible および FreqUnits) のみが、ツールボックス基本設定をオーバーライドします。

バージョン履歴

R2012a で導入