メインコンテンツ

bodeoptions

R2026b

bodeplot のプロット オプション

説明

BodeOptions オブジェクトを作成してボード線図の外観をカスタマイズするには、bodeoptions 関数を使用します。このオブジェクトを使用して、bodeplot で作成されたボード線図の外観をカスタマイズし、ボード線図を作成した MATLAB® セッションにおけるプロットの基本設定をオーバーライドします。

BodeOptions オブジェクトに対して指定したオプションは、BodePlot Properties チャート オブジェクトのプロパティに対応しています。

作成

説明

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

例

plotoptions = bodeoptions("cstprefs") は、プロット オプションを、Control System Toolbox™ と System Identification Toolbox™ 基本設定エディターで選択したオプションを使用して初期化します。エディターの詳細については、線形解析プロットのツールボックス設定の指定を参照してください。この構文は、いくつかのプロット オプションを変更し、それ以外は既定の基本設定を使用する場合に便利です。この構文を使用するスクリプトは、基本設定が異なるセッションで実行すると、外観が異なる結果を生成する場合があります。

プロパティ

すべて展開する

応答

振幅プロットを表示するオプション。'on' または 'off' として指定します。

このオプションは、チャート オブジェクトの MagnitudeVisible プロパティに対応しています。

位相プロットを表示するオプション。'on' または 'off' として指定します。

このオプションは、チャート オブジェクトの PhaseVisible プロパティに対応しています。

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

このオプションは、チャート オブジェクトの MinimumGainEnabled プロパティに対応しています。

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

このオプションは、チャート オブジェクトの MinimumGainValue プロパティに対応しています。

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

このオプションは、チャート オブジェクトの Characteristics.ConfidenceRegion.NumberOfStandardDeviations プロパティに対応しています。

依存関係

このオプションは、同定されたモデルでのみサポートされます。これには、System Identification Toolbox ソフトウェアが必要です。

単位とスケーリング

周波数単位。次の値のいずれかとして指定します。

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

また、'auto' を指定することもできます。その場合、周波数 'rad/TimeUnit' が使用され、TimeUnit は入力システムの TimeUnit プロパティです。

このオプションは、チャート オブジェクトの FrequencyUnit プロパティに対応しています。

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

このオプションは、チャート オブジェクトの FrequencyScale プロパティに対応しています。

振幅単位。以下のいずれかとして指定します。

  • 'dB' — デシベル

  • 'abs' — 絶対値

このオプションは、チャート オブジェクトの MagnitudeUnit プロパティに対応しています。

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

このオプションは、チャート オブジェクトの MagnitudeScale プロパティに対応しています。

位相単位。以下のいずれかとして指定します。

  • 'deg' — 度

  • 'rad' — ラジアン

このオプションは、チャート オブジェクトの PhaseUnit プロパティに対応しています。

位相のラップとマッチング

位相のラップを有効化するオプション。'off' または 'on' として指定します。位相のラップを有効にすると、応答に示される位相がラップされ、PhaseWrappingBranch に定義されている範囲内に留まります。

位相のラップと位相マッチングの両方が有効になっている場合、ソフトウェアはまず位相マッチングを実行し、次に位相のラップを実行します。

このオプションは、チャート オブジェクトの PhaseWrappingEnabled プロパティに対応しています。

位相のラップ範囲の下限。度単位のスカラー値として指定します。位相のラップ範囲は [B,B+360) です。ここで、B は PhaseWrappingBranch と等しくなります。

このオプションは、チャート オブジェクトの PhaseWrappingBranch プロパティに対応しています。

位相マッチングを有効化するオプション。'off' または 'on' として指定します。位相マッチングを有効にすると、位相応答は、PhaseMatchingFreq で指定されている周波数において、PhaseMatchingValue で指定された値とマッチングされます。残りの位相応答は、同じ位相プロファイルを維持するようにシフトされます。

このオプションは、チャート オブジェクトの PhaseMatchingEnabled プロパティに対応しています。

位相のラップと位相マッチングの両方が有効になっている場合、ソフトウェアはまず位相マッチングを実行し、次に位相のラップを実行します。

位相マッチング周波数。スカラーとして指定します。

このオプションは、チャート オブジェクトの PhaseMatchingFrequency プロパティに対応しています。

位相マッチング応答値。スカラーとして指定します。

このオプションは、チャート オブジェクトの PhaseMatchingValue プロパティに対応しています。

入出力

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

  • 'none' — 入出力をグループ化しません。

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

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

  • 'all' — すべての入出力ペアをグループ化します。

このオプションは、チャート オブジェクトの IOGrouping プロパティに対応しています。

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

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

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

  • FontAngle — 文字の傾斜。'Normal' または 'italic' として指定します。すべてのフォントに両方のフォント スタイルがあるとは限りません。そのため、イタリック フォントが標準フォントと同じように表示される場合があります。

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

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

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

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

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

このオプションは、チャート オブジェクトの InputLabels プロパティに対応しています。

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

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

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

  • FontAngle — 文字の傾斜。'Normal' または 'italic' として指定します。すべてのフォントに両方のフォント スタイルがあるとは限りません。そのため、イタリック フォントが標準フォントと同じように表示される場合があります。

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

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

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

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

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

このオプションは、チャート オブジェクトの OutputLabels プロパティに対応しています。

入力を表示するオプション。{'on'}、{'off'}、または複数の要素をもつ cell 配列として指定します。

このオプションは、チャート オブジェクトの InputVisible プロパティに対応しています。

出力を表示するオプション。{'on'}、{'off'}、または複数の要素をもつ cell 配列として指定します。

このオプションは、チャート オブジェクトの OutputVisible プロパティに対応しています。

タイトルと軸ラベル

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

  • String — ラベルのテキスト。文字ベクトルとして指定します。既定では、プロットのタイトルは 'ボード線図' になります。

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

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

  • FontAngle — 文字の傾斜。'Normal' または 'italic' として指定します。すべてのフォントに両方のフォント スタイルがあるとは限りません。そのため、イタリック フォントが標準フォントと同じように表示される場合があります。

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

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

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

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

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

このオプションは、チャート オブジェクトの Title プロパティに対応しています。

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

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

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

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

  • FontAngle — 文字の傾斜。'Normal' または 'italic' として指定します。すべてのフォントに両方のフォント スタイルがあるとは限りません。そのため、イタリック フォントが標準フォントと同じように表示される場合があります。

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

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

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

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

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

このオプションは、チャート オブジェクトの XLabel プロパティに対応しています。

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

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

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

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

  • FontAngle — 文字の傾斜。'Normal' または 'italic' として指定します。すべてのフォントに両方のフォント スタイルがあるとは限りません。そのため、イタリック フォントが標準フォントと同じように表示される場合があります。

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

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

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

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

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

このオプションは、チャート オブジェクトの YLabel プロパティに対応しています。

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

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

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

  • FontAngle — 文字の傾斜。'Normal' または 'italic' として指定します。すべてのフォントに両方のフォント スタイルがあるとは限りません。そのため、イタリック フォントが標準フォントと同じように表示される場合があります。

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

グリッド

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

このオプションは、チャート オブジェクトの GridVisible プロパティに対応しています。

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

軸の範囲

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

  • 'auto' — 自動範囲選択を有効にしますが、これはプロットされたデータの全範囲に基づいた選択となります。

  • 'manual' — 軸の範囲を手動で指定します。軸の範囲を指定するには、XLim オプションを設定します。

このオプションは、チャート オブジェクトの XLimitsMode プロパティに対応しています。

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

  • 'auto' — 自動範囲選択を有効にしますが、これはプロットされたデータの全範囲に基づいた選択となります。

  • 'manual' — 軸の範囲を手動で指定します。軸の範囲を指定するには、YLim オプションを設定します。

このオプションは、チャート オブジェクトの YLimitsMode プロパティに対応しています。

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

このオプションは、チャート オブジェクトの XLimits プロパティに対応しています。

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

このオプションは、チャート オブジェクトの YLimits プロパティに対応しています。

オブジェクト関数

bodeplot動的システムのボード周波数応答をプロット

例

すべて折りたたむ

この例では、タイトルに 15 ポイントの赤いテキストを使用し、カスタム タイトルを設定するボード線図を作成します。bodeoptions を使用してプロットのプロパティを指定すると、指定したプロパティにより MATLAB セッションの基本設定がオーバーライドされます。このため、プロットが生成される MATLAB セッションの基本設定にかかわらず、プロットの外観が同じになります。

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

opts = bodeoptions;

次に、オプション セット opts の必要なプロパティを変更します。opt.Title は構造体であるため、その構造体のフィールドと値を指定することにより、プロットのタイトルのプロパティを指定します。

opts.Title.FontSize = 15;
opts.Title.Color = [1 0 0];
opts.Title.String = 'System Frequency Response';
opts.FreqUnits = 'Hz';

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

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

MATLAB figure

opts は固定のオプション セットで始まるため、プロットの結果は MATLAB セッションのツールボックスの基本設定に依存しません。

バージョン履歴

R2008a で導入